History: Currency Amount Tracker Field

• «
• »

            ! Currency Amount Tracker Field
This field is used to display amounts in currency, using local currency symbols, three-letter international currency codes, or codes of your own making (for a community currency, for instance). Country conventions for decimals and separating thousands can also be set.

!! Options
{FANCYTABLE(head=__Parameter__|__Value__|__Default__|__Description__)}
''amount'' | any decimal | 20.99 | the calculation of the amount
''sourceCurrency'' | 3-letter [http://www.iso.org/iso/support/currency_codes_list-1.htm|ISO 4217] currency code | CAD | source currency,which currency is the amount in?. The three-letter currency code for Amount
''exchangeRatesTrackerId'' |number| 50| the currency field of the tracker
''samerow'' | 0 or 1 | 0 | Will display the next field or checkbox in the same row if set to 1
''size'' | number of charcters | 17 | The visible size of the field in characters
''prepend'' | any text | none | Text that will be displayed before the field
''append'' | any text | none | Text that will be displayed just after the field
''locale'' | language_country code, for example en_US or en_US.UTF-8 or en_US.ISO-8559-1 | en_US | This language code ([http://lcweb.loc.gov/standards/iso639-2/langcodes.html|ISO 639]) + country code ([http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html|ISO 6339]) determines how decimals are displayed and what thousands separator is used
''defaultCurrency'' | 3-letter [http://www.iso.org/iso/support/currency_codes_list-1.htm|ISO 4217] currency code | USD | The three-letter currency code that will display as convert currency
''symbol'' | i or n | n | Set to i for international symbol, n for local
''all_symbol'' | 0 or 1 | 0 | Set to 1 to show symbol for every item (default only shows currency symbol on first item in a list) 
{FANCYTABLE}

!! Examples
{SPLIT()}
{img attId=51}
''locale'' set to fr_CA
(language = French
country = Canada)
---
{img attId=52}
''locale'' set to ja_JP
(language = Japanese
country =  Japan)
---
{img attId=53}
''locale'' set to de_DE (Germany)
''symbol'' set to i
''all_symbol'' set to 1
{SPLIT}

!! Multi-currency
In ((Tiki19)), this field was improved so it can track values in any currency, and on mouse-over, show the equivalent value in other currencies. This is very useful if you need to track items in many currencies.  For example, you get paid in more than one currency, and you'd like to know the value in other currencies.

The exchange rates are stored in a tracker. You can set date ranges for exchange rates.

This field had a bunch of incremental fixes and enhancements in branch 20.x in September 2019, so if you intend to use seriously, you should probably get the ((dev:Daily Build)) or from SVN.

!!! Exchange rate example
{img attId=77 width="600"}


!!! Examples
{CODE(caption=Examples)}
{currency amount=20.99 sourceCurrency=CAD exchangeRatesTrackerId=50 prepend= append= locale=en_US.UTF-8 defaultCurrency=USD symbol=n allSymbol=0}
{CODE}

!! Tiki22
All currency fields now have another index field named permName_base. It contains a numeric value of the amount converted to base currency. Base currency is the currency with rate = 1 in the currency tracker. If you need multiple base currencies, you could use multiple currency trackers each having a different rate = 1 currency. Then, some currency fields will use one currency tracker and others will use the other one.

Sorting: use the "_base" suffix currency field in a LIST context and sort on that.

!!! Other improvements
victor.emanouilov 2020-04-15
https://gitlab.com/tikiwiki/tiki/-/commit/c512d9e12c360e5dce9dcddadf768d28c07c21a1

A couple of updates here that were needed before adding the range filters:

1. Added base currency field to the index - this is taken from the currency tracker - the currency unit that has conversion rate = 1. Each currency field now has its value indexed as text value (e.g. 123USD) and also has a "_base" suffix one that is a numeric value of the amount in the base currency. You should keep one and only one currency with rate = 1 in the currency tracker and that would be the base currency. We will use this later on when we sort and do other operations with currencies.

2. Extended math field to inherit indexable fields from its mirrored field. In case of a currency mirror, this will allow the math field to also have the "_base" suffix field in the index, so calculations of currencies will also store the base currency value in the index.

3. Extended currency field to support range filters - from/to value and from/to currency. This is similar to tracker filters and also similar to the currency field input, so it makes most sense to use it here. Chosen amount and currency is converted to the base currency and then "_base" index field is searched as a numeric range search.

Thus, all the updates here depend on the presence of a base currency with rate = 1 in the currency tracker.

!! Exchange rates tracker as System Tracker since Tiki23
There is a new section in __Control Panels > Trackers > 'System Trackers'__ (bottom of the page). 
The first one available is the __Exchange rates tracker__.
 
You can enable it, select which one it is, select the corresponding fields (Currency, Rate, Date) and also the conversion logic (if the rates are entered straight or reverse pairs). An important update here is removal of the Currency Tracker selection in the Currency field options. We no longer need or want to use that from the field properties as we have a system tracker now. The important part for those of you managing Currency fields is to go to Trackers settings page and configure the system tracker fields.

See ((System Trackers))