ibexa

Path

ez publish / technical manual / 4.x / features / multi-currency / editing a currency


Caution: This documentation is for eZ Publish legacy, from version 3.x to 5.x.

Editing a currency

This part of the 4.x documentation is for eZ Publish 4.0, only reference section is common for all eZ Publish 4.x versions as well as eZ Publish 5.x "LegacyStack", please select the version you are using for the most up to date documentation!

The administration interface allows you to edit currencies. The following text reveals how this can be done.

  1. Open the list of currencies by clicking the "Webshop" tab in the administration interface and selecting the "Currencies" link on the left. Find the target currency in the list and click the "Edit" button for this currency. You will be taken to the currency edit interface that allows to modify the following attributes (these are described in the previous section):
    • Currency code
    • Currency symbol
    • Formatting locale
    • Custom rate
    • Rate factor
  2. Specify the desired currency attributes.
  3. Click the "Store changes" button.

Changing the currency status

The currency edit interface does not support changing the statuses of the currencies. The following text reveals how you can change the status for one or more currencies.

  1. Open the list of currencies by clicking the "Webshop" tab in the admin interface and selecting the "Currencies" link on the left.
  2. Choose the desired status value from the drop-down list in the "Status" column (this can be done for several currencies).
  3. Click the "Apply changes" button to save your changes.

Changing rates for multiple currencies

You can update currency rates and/or rate factors for several currencies at the same time using the list of currencies.

Updating auto rates

To update auto rates, do the following:

  1. Open the list of currencies by clicking the "Webshop" tab in the administration interface and selecting the "Currencies" link on the left.
  2. If the "Update auto rates" button is inactive, this means that the system can not update auto rates because no update handler is specified. The following screenshot shows the situation when the custom rates are specified for all currencies and therefore the system will not use the auto rates. In this case, the auto rates are displayed in gray color. Since no updates were performed, the "N/A" marks are displayed in the "Auto rate" column.
    The list of currencies with disabled possibility to update auto rates.

    The list of currencies with disabled possibility to update auto rates.

  3. Since no update handler is specified, the "Update auto rates" button is inactive. To activate this button, you should choose the desired handler as described in the "Exchange rates update handlers" section and clear the eZ Publish caches. The "Update auto rates" button will become active.
  4. Click the "Update auto rates" button. The auto rates will be automatically updated.
    The list of currencies with updated auto rates.

    The list of currencies with updated auto rates.


    This screenshot shows the situation when the auto rates are updated using EUR as the base currency (the EUR auto rate value is 1.00000). As you can see, the retrieved auto rates are still displayed in gray color because the custom rates are available. However, you can remove the custom rates in order to enable the auto rates.

Enabling auto rates

An auto rate for a currency will not be used if a non-zero custom rate is specified. If you remove the custom rate or set it to 0, the auto rate will be enabled. For example, if you remove all the values from the "Custom rate" column and click the "Apply changes" button, the system will start to use auto rates (look at the next screenshot).

The list of currencies with removed custom rates.

The list of currencies with removed custom rates.


Please note that changing the rates will not result in updating auto prices for your products. It is recommended to click the "Update auto-prices" button when you have finished managing your currencies. This will instruct the system to update auto prices for all products.

Changing custom rates and/or rate factors

It is possible to change custom rates and/or rate factors for several currencies at the same time. The following text reveals how this can be done.

  1. Open the list of currencies by clicking the "Webshop" tab in the administration interface and selecting the "Currencies" link on the left.
  2. Set the desired custom rate in the "Custom rate" column and/or specify the desired rate factor value in the "Factor" column (this can be done for several currencies).
  3. Click the "Apply changes" button to save your changes. The system will automatically re-calculate the final rates indicated in the "Rate" column.
    The list of currencies with one custom rate.

    The list of currencies with one custom rate.


    The screenshot above shows the list of currencies after changing the NOK custom rate and the USD rate factor.

Please note that clicking the "Apply changes" button will not result in updating auto prices for your products. It is recommended to click the "Update auto-prices" button when you have finished managing your currencies. This will instruct the system to update auto prices for all products.

Svitlana Shatokhina (05/05/2006 12:54 pm)

Ricardo Correia (17/04/2013 3:03 pm)

Svitlana Shatokhina, Geir Arne Waaler, Ricardo Correia


Comments

There are no comments.