Currency Add/Edit

 

Description

This screen enables you to create or edit a currency and its locale information. The locale information enables you to configure the system to display prices the way you want for each currency.

 

 

Toolbar

Currency Toolbar

 

  • Save : Save the current currency and return to the currencies Management screen.
  • Save & Close : Like previous button but just after going back to currency listing.
  • Cancel : Return to the previous screen without saving the modifications.
  • Help : This button enables you to turn ON/OFF the help section, this screen will appear or disappear.

 

Currency Information

 

Currency Information

 

  • Name : Name of the currency.
  • Code : The international ISO code of the currency. Please do not change that for existing currencies and the currency restrictions of payment/shipping methods rely on that field to know whether they can or cannot be used with a particular currency.
  • Symbol : The symbol used to represent the currency in the regions where it's used.
  • Rate : The rate of the currency based on the main currency set in the configuration page. The main currency will always have a rate of 1. As you can see, on this screenshot, the main currency is Euro.
  • Last modified date : The last time the currency was modified (either manually or automatically by the auto rates updater plugin ).
  • Additional fee (in %) : An additional fee that you can add on the conversion rate when your customers pay using this currency for a product with a price in a different currency. That can be useful, for example, when your bank charges you currency conversion fees on payments received in another currency than the currency of your bank account.
  • Published : If a currency is published it means that it can be used by your customers to display your goods prices in this currency but also pay their orders in this currency. The main currency is always considered as published. Also, please note that each payment gateway ( like Paypal or authorize.net ) has a limited number of currencies they accept. So based on the payment plugins you use, before publishing a currency, please make sure that this currency is handled by them. Otherwise, you can still let your users see the prices in their currency while browsing your store but then pay in your main currency by turning the Displayed option to "yes" without publishing the currency.
  • Displayed : If a currency is published or is the main currency, this setting will be disregarded and the currency will always be usable by your customers on the front end. Otherwise, based on this setting, you will be able to select the additional currencies in which you users will be able to display prices of your goods. Those currencies won't be used in the cart display, nor during the checkout as long as they are not published. That can be useful when you want your customers to always pay you in one of several currencies but you also want them to be able to see an equivalent of the price in their own currency.

 

Locale Information

Prices can be displayed differently based on the currency used to display them. For instance, The euro sign will usually be after the value where the dollar sign will usually be before the value. The locale information area will let you personalize the display of your prices for the currency you are creating or editing. You can look at the principal currencies used in the world for some examples of how to use those options. Those options reflect the locale settings that you can find in php: http://www.php.net/manual/en/function.localeconv.php

Locale Informations

 

  • Format : The way you want to display the symbol (basically you will have %i which will display the currency code next to the price, %n which will display the currency symbol next to it, and %ni which will display both). For more information, you can look at  http://www.php.net/manual/en/function.money-format.php
  • Decimal separation : The separation character that will be displayed as decimal separation. For example the , between 9 and 99 in 9,99€.
  • Groups separation : The separation character that will be displayed as separation between groups of digits. For example, the space between 10 and 000 in 10 000€.
  • Digits groups : The number of digits in each group before the decimal separation. For example in 10 000€, you have 3 digits per group but in Japanese you usually have 4 digits per groups : 1 0000€.
  • Sign for positive values : The sign for positive value. Usually, positive prices do not have a sign in front of the value but it could happen like this for instance: +10 000€
  • Sign for negative values : The sign for negative value. It is usually a minus sign: -10 000€
  • International fractional digits : The number of digits after the decimal separation when displaying a price using the international format. It is usually 2 like 9,99€ but it can also often be zero in other currencies like 1 0000?
  • Local fractional digits : The number of digits after the decimal separation when displaying a price using the national format. It is usually 2 like 9,99€ but it can also often be zero in other currencies like 1 0000?
  • Rounding increment : Define here, set how much you will round up the price.
  • Symbol precedes positive value : $10 or 10$
  • Symbol and positive value space separation :$ 10 or $10
  • Symbol precedes negative value : $-10 or -10$
  • Symbol and negative value space separation : $ -10 or $-10
  • Positive sign position : Set the position of the sign in the price
  • Negative sign position : Set the position of the sign in the price