Bitrix Site Manager

Creating and editing currency properties

In this section

  • Context bar
  • Editing form
  • Control buttons
  • This form helps create a new currency or set the parameters of an existing one.

    Context bar

    Button Description
    List Opens a form containing the list of currencies.
    Create Creates a new currency in this form. The button is displayed when editing the existing currency only.
    Delete Deletes the currency being edited.

    Editing form

    Field Description
    *Currency Contains the 3-symbol currency abbreviation (for example: RUR, EUR, USD).
    Face-value Face-value, or quantity of currency units, for which the exchange rate is set. Usually it equals the face-value set by the Central Bank. For most currencies the face-value is 1 (for instance, 26.9 RUR for 1 USD). Some currencies, however, will have a different value (for instance, 23.20 RUR for 100 JPY).
    *Default rate A currency rate which will be used for conversion of the currency in case no other rate is specified in the Currency rates form for this currency. The rate of the base currency equals 1. For other currencies, the rate is specified relative to that of the base currency. That is, the Default rate field of a newly added currency must contain the amount which is fixed for it in the base currency.

    For example, if you set the rate of RUR to 1, then the USD rate can be set to 27.6, and the EUR rate to 34.2. See also: Currency rates.
    Sorting index The currency sort weight. Defines the currency position in lists.
    Currency settings for the site
    Name The full name of the currency for this site.
    Format template Specifies the format for displaying sums in this currency.
    After selecting the template in the drop-down list, all the below fields will contain the default values. You can change the values of these fields if needed.
    *Currency format string Specifies the format for displaying sums in this currency.

    All symbols of the format string are displayed as they are, except for the "#" symbol. When displayed, this symbol is replaced with the real sum (for example, the format string "USD # for 1 item", will be displayed as "USD 210 for 1 item"). The display format depends on the values in the fields described below.
    Decimal point in output The symbol separating the integer and fractional parts of a number.
    Thousand separator in output The symbol separating the thousands of a number.

    Note for developers
    Hexadecimal values can be used to print separators, for example: \xA0.

    Number of decimal digits The number of digits in the fractional part of a number (e.g. cents for USD).

    * - Required fields.

    Control button

    Button Description
    Save Saves the currency parameters. Opens the page with the list of currencies.
    Apply Saves the currency parameters. Editing continues.
    Cancel Cancels current changes and restores parameters to their original values.