In this section · 14 articles

Manage currencies and locations

Add or switch off the currencies, countries, states and cities that Laramin offers in its forms and settings.

Applies to
Core 12.0 and later
Who can do this
Administrator, Platform owner
Where
Configurations › Master Settings
On this page

Before you start

  • Each list has its own permissions, with list, view, create, edit, delete, restore and remove:

    ListPermission name
    Currencyfeature.core.currency.*
    Countriesfeature.core.country.*
    Statesfeature.core.state.*
    Citiesfeature.core.city.*

    Countries, States and Cities also have bulk_import, for importing from a CSV file, for example feature.core.country.bulk_import. The standard Administrator role has it.

  • A new installation comes with a full set of currencies and countries, with their states and cities. Usually you only switch entries on or off, or correct them.

  • Currency and country pickers, such as Default Currency and Country, offer only entries whose Status is Active. Set one to Inactive to hide it without losing it. State pickers in the settings panels list a country's states whatever their status.

Add a currency

  1. Open Configurations › Master Settings › Currency.

  2. Select New Currency.

  3. Enter a Currency Code, for example AED. It must be unique, up to 10 characters, and you can't change it later.

  4. Enter a Name, and a Symbol of up to 10 characters.

  5. Enter a Conversion Rate, a number of 0 or more. New installations set it to 1 for every currency. Nothing in Laramin uses the conversion rate, so amounts aren't converted between currencies. You can leave it at 1.

    The Create Currency drawer filled in with Currency Code XCG, Name Caribbean Guilder, Symbol Cg and Conversion Rate 1, with Status still to be selected before saving.
  6. Set Status to Active.

  7. Select Save.

To make it the installation's currency, choose it in Default Currency on the System panel. See System and company settings.

Add a country

  1. Open Configurations › Master Settings › Locations › Countries.

  2. Select Create.

  3. Enter a Name. You can enter it in each of your languages.

  4. Optional: upload a Flag, and enter an ISO Code and a Phone Code of up to 10 characters each.

  5. Set Status to Active, and an Order if you want to control where it sorts.

    The Create Country drawer with a Flag upload area, a Name field with language tabs, ISO Code, Phone Code, Status set to Active, and Order.
  6. Select Save.

Add a state or a city

  1. Open Configurations › Master Settings › Locations › States or Cities.
  2. Select Create.
  3. Enter a Name.
  4. For a state, choose its Country. For a city, choose a Country first, then its State. Only active countries are offered.
  5. Set Status and, if you want, Order.
  6. Select Save.
The Create City drawer with India chosen in Country and the State list open, offering only Indian states such as Andaman and Nicobar Islands, Andhra Pradesh and Assam.

Add many at once from a spreadsheet

On Countries, States or Cities, select Import CSV to add many entries from a CSV file. A state's file can name its country by ISO code or name, and a city's file its state by name. Import countries first, then states, then cities. See Import records from a CSV file.

Switch an entry off

  1. Open the list and find the entry. To find inactive ones, filter on Status.
  2. Select Edit on its row.
  3. Set Status to Inactive, then select Save.

Tip: Switching off is safer than deleting. An inactive entry is only left out of pickers. Nothing is removed, and you can switch it on again at any time.

What happens next

Deleted currencies, countries, states and cities go to the trash first. You can restore them from the list's Trashed view, or delete them for good. See Delete, restore and act on records in bulk.

Names aren't checked for duplicates, so search the list before you add a country, state or city.