Child pages
  • Currencies

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Update the currency page

Currencies

PrestaShop

...

supports a large number of currencies. By default,

...

only one

...

currency

...

is registered for your store, i.e. the currency of your store’s default country. However, you can add and configure new currencies

...

to better meet your customers’ needs. Indeed, customers will appreciate

...

being able to

...

shop

...

in their

...

own currency

...

!

Image Removed

This page is very simple yet essential, as relate to your currencies exchange rates (or "conversion rates"). To quote Wikipedia, "in finance, an exchange rate between two currencies is the rate at which one currency will be exchanged for another. It is also regarded as the value of one country’s currency in terms of another currency". Rates change daily, sometimes drastically depending on current events, and your shop should always be updated to the latest values.

...

Image Added

Changing the default currency

All the exchange rates of the added currencies (official or alternative) are calculated from one unit of your store's default currency. That is why the default currency should be the currency in which you are most comfortable.

To change the default currency of your store:

  1. Go to the International > Localization page

  2. See the ‘Default currency’ feature in the Configuration section

  3. Select the currency you want to set as default

Image Added


If the currency you want to

...

set as default is not available

...

, you must

...

Updating the currency rates

You can update the currency rate by clicking on the "Update" button in the "Exchange rate" frame. This will download the update file from the PrestaShop website's servers, using PrestaShop web-service.

Image Removed

Info
Note that the rates are provided as-is: the PrestaShop team does pay attention to have correct rates in these files, but might slightly differ from the actual ones, if only because these rates can fluctuate greatly in a short time.

Adding a new currency

The easiest way to add a country's currency is to import its localization package. This is done in the "Localization" page, under the "International" menu. Once imported, you must go to the "Currencies" page to enable it. You might need to add a currency not featured in any the localization packages. In that case, you can use the creation form. Click on "Add new currency", and a new page opens:

Image Removed

...

add it whether by importing the localization pack of a country using this currency or by completing the “Add a new currency” form (See “Adding a new currency”).

Adding a new currency

There are two ways of adding a new currency:

1. Import the localization pack of a country using this currency

This can be done in the "Localization" page of the "International" menu.

Image Added

For example, if you want to add the Algerian Dinar, you can import Algeria’s localization pack.

When importing a localization pack, the language will be enabled by default. Once imported, you can manage the status of the currency on the “Currencies'' page.


2. Add the currency manually

Click on the "Add a currency" button. Select the currency you want to add from the list. The fields will be filled in automatically.

By default, the currency is disabled. To activate it in your store, do not forget to switch the Status button to “Yes” and save.

Creating an alternative currency

You may need to add a currency that is not included in any of the localization packs or that is not available in the list of languages. Use this feature to add any cryptocurrency, local currency, etc. that meet your customers’ needs.

  1. Click on the “Add a new currency” button

  2. Check the box “Create an alternative currency”

  3. Complete the fields:

Image Added

  • Currency name. Enter the name of the currency.

  • ISO code. Enter the currency 4217 ISO code. See Wikipedia for more information. You will also be able to find unofficial ISO codes of alternative currencies, such as Bitcoin.

  • Exchange rate. This rate is to be defined according to your

...

  • store's default currency. For example, if the default currency is

...

  • euros and

...

  • your chosen currency is dollars, type "1.

...

  • 20"

...

  • (1€ = $1.20).

  • Decimals. Number of digits following the decimal point for the prices on your store.

  • Status. Any currency can be disabled at any time, both from

...

  • the edit page, and the currencies

...

  • listing on the "Currencies" page.

...

  • When you create a new currency by using the “Add a new currency form”, it is disabled by default.

...

Editing symbols and format

You can customize the format and the symbol of each currency depending on the languages of your store (both the activated and deactivated ones).

When editing a currency, at the bottom of the page, choose the language for which you want to modify the currency symbol and/or format and click on “Edit Symbol/Format”.

Enter the currency symbol and choose the format:

  • just in front of the amount, e.g. □999.99

  • in front with a space between the symbol and the amount, e.g. □ 999.99

  • just after the amount, e.g. 999.99□

  • after the amount with a space between them, e.g. 999.99 □

The white square will be replaced by the currency symbol once the “Symbol” field is filled in.

Please note that this feature is only available when editing a currency.

Updating currency rates

A currency exchange rate, or conversion rate, is the rate at which one currency will be exchanged for another. For example, a conversion rate EUR/USD of 1,22 means that 1 euro equals 1,22 dollars.

If a product costs 15 euros, it will cost 18,30 dollars. (15*1,22 = 18,3)

On the contrary, if a product costs 15 dollars, it will cost 12,30 euros. (15/1,22 = 12,3)


Info

Rates on PrestaShop are provided by the ECB and updated every day. However, note that they might slightly differ from the current ones as these rates can fluctuate greatly in a short time.


Do not forget to regularly update the rates, by following these steps:

Image Added

To update currency rates:

  1. Go to the “Exchange rate” section of the “Currencies” page

  2. Click on the “Update” button


Info

Custom currencies’ exchange rates will not be updated automatically, so you will have to manually update them. For example, if you added Bitcoin and want to update the exchange rate, click on the pencil to modify the currency in the Currencies listing, and enter the exchange rate in the corresponding field. Therefore, for high volatile alternative currencies, it is highly recommended to use a module that can automatically update the currency rate.


Clicking on the “Update” button will automatically update the exchange rates of your store’s currencies. A simple search on the internet is usually sufficient to find a currency exchange rate. There are a lot of converters online that you can use, such as XE.com.

For cryptocurrencies, you can visit the following websites: https://coinmarketcap.com/