Page Comparison

On the billing dashboard widgets, the platform can convert between currencies for the display of the latest bills.

The user can select currencies from the pulldown menu at the top right of a widget.

...

To set a currency and the rates to convert to this currency :do these steps.

1. In the /var/www/html/ui/config folder, edit the client-config-custom.json file 

2. Create the client.dashboard.widgets.lastbills.currenciesconversionsUI property.

...

1. Create a default currencyCode property first, for example "AUD". On the menu, the currencies will display in the same order as the properties

2. Add a symbol for the currency, for example "$"

3. Add the conversions. First add a default conversion using the month value of "default"

4. Then add any other conversions for a specific month, with a value from 1 (for January) to 12 (for December). You must also include the year value.

In the following example, for May 2020, the platform will multiply the value in Euros by 1.6 to give the value in Australian dollars.

...

1. 
   You can copy this example that will add a conversion to Australian dollars from Euros. The platform will do this calculation:
   inner value (EUR) * conversion rate = outer value (AUD).

   Code Block
   client.dashboard.widgets.lastbills.currenciesconversions: { "currencyCode": "AUD", "symbol": "$", "conversions": [ { "currencyCode": "EUR", "values": [ { "month": "default", "value": 1.6 }, { "month": 12, "year": 2019, "value": 1.4 } ] } ] },

   1. On the currency selector, the currencies display in the same order as the currencyCode properties in the config file

   2. Enter a symbol for the currency, such as $

   3. Enter a value for the default conversion, with the month value of default

   4. Add other conversions for a specific month, with a value from 1 (for January) to 12 (for December) and year.

   5. If your property is the last one in the file, remove the comma (,) from the above example

2. For each currency,

...

1. go to the ../ui/lang folder, edit the lang_xx_XX_custom.json file, and add a currency label for the currencyCode. For example, for Australian dollars in the language file for US English, which is lang_en_US_custom.json, add the following label.

   Code Block
   "dashboard.lastbills.label.currency.AUD":"Aust. Dollar",

   Remember that the labels

...

1. files must always end with the

...

1. __EOF

...

1. label.

2. Check all your JSON files as always because the UI will not load with an invalid configuration. Check there are no commas after the last entry in the file, and that there are no missing commas between entries.

3. Save your files in UTF-8 format

4. To activate your changes, reload the UI. 

5. The platform will automatically load the new configuration, but users should delete the cache and reload the UI in their browsers.