Misplaced Pages

Revision as of 09:07, 11 October 2022

This is the template sandbox page for Template:Infobox currency (diff). See also the companion subpage for test cases.

This template uses Lua: Module:Infobox (sandbox) Module:InfoboxImage (sandbox) Module:Check for unknown parameters (sandbox)

Usage

Most commonly used parameters

{{Infobox currency
| name =
| local_name =
| local_name_lang =
| obsolete =
| image_1 =
| image_title_1 =
| image_alt_1 =
| iso_code =
| issuing_authority =
| issuing_authority_website =
| date_of_introduction = 
| date_of_introduction_source =
| using_countries =
| inflation_rate =
| inflation_source_date =
| unit =
| symbol =
| nickname =
| plural =
<!-- subunits,  superunits -->
| subunit_ratio_1 = {{frac|1|100}}
| subunit_name_1 =
| symbol_subunit_1 =
| nickname_subunit_1 =
| plural_subunit_1 =
<!-- banknotes & coins -->
| frequently_used_coins =
| rarely_used_coins =
| frequently_used_banknotes =
| rarely_used_banknotes =
}}

Euro related (ERM)

{{Infobox currency
| local_name =
| local_name_lang =
| image_1 =
| image_title_1 =
| alt1 =
| iso_code =
| issuing_authority =
| issuing_authority_website =
| date_of_introduction = 
| date_of_introduction_source =
| using_countries =
| inflation_rate =
| inflation_source_date =
| ERM_since =
| ERM_fixed_rate_since =
| euro_replace_non_cash =
| euro_replace_cash =
| ERM_fixed_rate =
| ERM_band =
| unit = euro
| subunit_ratio_1 = {{frac|1|100}}
| subunit_name_1 =
| symbol = ]
| plural =
| plural_subunit_1 =
| frequently_used_coins =
| rarely_used_coins =
| frequently_used_banknotes =
| rarely_used_banknotes =
}}

Extensive syntax

{{Infobox currency
| name =
| local_name =
| local_name_lang =
| postfix =
| local_name2 =
| local_name_lang2 =
| local_name3 =
| local_name_lang3 =
| name_abbr =
| obsolete =<!-- /yes -->
| obsolete_notice =
| qid =
| image_1 =
| image_background_1 =
| image_title_1 =
| image_width_1 =
| image_alt1 =    
| image_2 = 
| image_background_2 =
| image_title_2 =
| image_width_2 =
| image_alt2 =
| iso_code =
| iso_notice =
| issuing_authority =
| issuing_authority_title =
| issuing_authority_website =
| date_of_introduction = 
| date_of_introduction_source =
| unofficial_users =
| using_countries =
| inflation_title =
| inflation_rate =
| inflation_source_date =
| inflation_method =
| ERM_since =
| ERM_withdraw =
| ERM_fixed_rate_since =
| euro_replace_non_cash =
| euro_replace_cash =
| ERM_fixed_rate =
| ERM_band =
| pegged_with =
| pegged_by =
| unit =
| symbol =
| plural =
| plural_slavic =
| no_plural =
| nickname =
<!-- superunits: _1 through _5 = -->
| superunit_ratio_1 =
| superunit_name_1 =
| superunit_inline_note_1 =
<!-- subunits: _1 through _5 = -->
| subunit_ratio_1 =
| subunit_name_1 =
| subunit_inline_note_1 =
| symbol_subunit_1 =
| nickname_subunit_1 =
| plural_subunit_1 =
<!-- banknotes and coins -->
| coin_article =
| used_coins =
| frequently_used_coins =
| rarely_used_coins =
| banknote_article =
| used_banknotes =
| frequently_used_banknotes =
| rarely_used_banknotes =
<!-- production -->
| printer =
| value =
| printer_website =
| mint =
| mint_website =
| footnotes =
}}

Parameters

All parameters are optional

Names

• |name= or |currency_name=: overrides the default, the article name ({{PAGENAME}})

For example: "German mark (1871)" → |currency_name=German mark

• |local_name=, |local_name_lang= allows a native name.

Alias names: |currency_name_in_local, local_name1=, |local_name_lang1=

For example: |local_name={{native name|fi|Suomen markka|italics=off}} → Finska mark (Swedish)

Language codes are in ISO 639 language code.

|postfix, postfix1= will be aded as suffix text to local name #1. Its |local_name_lang1= will not show.

|local_name2, local_name_lang2=, |local_name3, local_name_lang3=, |local_name4, local_name_lang4= allow more pairs of name-language.

All official languages of the issuing authority, plus all that appear on the physical currencies. But exclude languages that appear on motto ("E Pluribus Unum", of the US, "Dieu et mon droit" of UK, if it ever appears) that are in such languages for historical reasons, and regional languages on rotation (the don't-be-stupid clause). It is better missing than to guess. It is ok to be missing. Multiple languages: {{Native name list}}

In some languages, indefinite/definite articles are part of the nouns, such as the North Germanic languages. Use indefinite singular form. Example: Faroese króna. One wouldn't write "le franc français" in French franc's infobox.

See {{native name}} documentation for listing multiple languages. (One line per spelling. Use the {{native name}} or similar templates where appropriate. For example: Euro, dólar australiano (Spanish, Portuguese).

Use capitalization rule as if it is in the middle of a sentence in that language. For example, "franc français", not "Franc français", nor "franc Français".

• |name_abbr= Currency name abbreviation. For example, Can$, $NZ. Can be informal. Is not ISO 4127 code, nor symbol. (If provided must be reliable sourtce citable, for example by World Bank.

Active or obsolete

• |obsolete=yes/no. Any other text, like |obsolete=1999, will count as yes (is obsolete) .

This will change the headercolor from blue to pink.

• |obsolete-notice=yes/no will add the notice to the bottom (when |obsolete=yes). It never sets or alters the is-obsolete status:

This infobox shows the latest status before this currency was rendered obsolete.

ISO 4217 code

• |iso_code=, the formal alpha-3 ISO 4217 code like EGP, EUR, USD. Some codes are ambiguously active and obslolete, for these, |obsolete=yes/no is decisive.

|iso_code=''None'' (formatted in any form) can be used. This helps the reader clarifying the status of the currency.

Derived values, as defined by ISO 4217 are added automatically: ISO Numeric Code, ISO Minor Unit (see {{ISO 4217/code}}

When |iso_code= is used, the article is categorised in Category:Currencies with ISO 4217 code (238).

When |iso_code=None is used, the article is categorised in Category:Currencies without ISO 4217 code (91).

Otherwise |iso_code=<blank>, the article is not categorised wrt ISO 4217.

Note: as of 1 November 2022, ISO-related parameters iso_number, iso_exponent, and iso_decimals are deprecated (now automated).

• |iso_comment=
• |iso_ref=

Images

• |image_1=
• |image_title_1=
• |image_background_1= (none) #000000
• |image_width_1= 126 or 252: use a positive integer, no "px". For examples, see East Caribbean dollar, Polish zloty, Chilean peso, Portuguese escudo, Bangladeshi taka
• |image_2=
• |image_title_2=
• |image_background_2=
• |image_width_2=

Pre-euro currencies (ERM)

• |ERM_since= is required for ERM/euro currencies, unless |ERM_withdraw= is used
• |ERM_withdraw= date (for pound sterling and Italian lira)
• |ERM_fixed_rate= "5.94573 mk", (not "1 euro = 5.94573 mk", use symbol if possible)
• |ERM_fixed_rate_since=
• |ERM_band= "15%", not "±15%"
• |euro_replace_non_cash= 1 January 1999
• |euro_replace_cash= 1 January 2002

Currency usage

• |issuing_authority= Central Bank of xyz. If this exists in the infobox, remove duplicate wiki link from the article's "See also" section
• |issuing_authority_title= issuing_authority Central bank Monetary authority, currency board
• |issuing_authority_website= issuing_authority, for example {{URL|www.ecb.eu}}

If this exists in the infobox, remove duplicate link from the article's "External links" section

• |date_of_introduction= 16 August 1965: The date when the issuing authority introduced the medium of currency. Not to be confused with adoption by a country or other entity.
• |date_of_introduction_source= date_of_introduction Name of and reference to the act regarding the introduction of the currency.
• |using_countries= Italicize non-sovereign states, order them as appropriate in the context. Use of {{flag}}, {{flag country}}, or {{flag icon}} recommended. See also Misplaced Pages:Inline templates linking country articles.

Inflation

• |inflation_rate= For additional info, use the next attribute.
• |inflation_source_date= inflation_rate; Prefer central bank data over CIA data. For example:

<ref>, August 2011</ref>

<ref>'', 2010 est.</ref>

• |inflation_method= for example, Consumer price index (CPI), or CPI excluding real estate

Pegging

• |pegged_with= Not in combination with |ERM_since=

For example: |pegged_with=euro = 3 units. If the rate is defined that way, do not put the inverse rate like 1 unit = 0.333333 euro.

• |pegged_by= Use ISO 4217 Code if the list gets too long

Unit & symbol

• |unit= unit name, as used locally. e.g., just "dollar" for Australia, Canada etc.
• |plural= emalangeni (use this is the it doesn't follow English grammar)
• |plural_slavic= Put any non-empty value to enable the Slavic notice. For example see Russian ruble
• |no_plural= put any non-empty value to enable the no-plural notice. For example New Taiwan dollar.
• |symbol= unqualified signs as used locally. For example €, £, $. (). Link to the articles of the currency symbols if exist (e.g. dollar sign, pound sign). Do not use abbreviations here, see |name_abbr=.
• |symbol_comment= age, references, notes, language
• |nickname= For example quid, buck/greenback, loonie/huard

Superunit, subunit (1–5)

subunit (like cent)

• |subunit_ratio_1= _5 For example 1⁄100, 1⁄20, 1⁄240
• |subunit_name_1= _5 Cent (currency), shilling, penny. Do not confuse centavo, centimo, centime, and centesimo.
• |subunit_inline_note_1= _5 This is so small that it is not used in practice
• |plural_subunit_1= _5 plural_slavic, no_plural, for example aurer (of Iceland). Used for irregular plurals like "pence" (GBP).
• |symbol_subunit_1= _5 ¢
• |nickname_subunit__1= _5 Matching subunit_name_(1..5} penny

superunit

• |superunit_ratio_1= _5
• |superunit_name_1= _5
• |superunit_inline_note_1= _5

Frequency (coins)

• |used_coins=
• |frequently_used_coins=
• |rarely_used_coins=
• |coin_article= For example |coin_article=]

• The |coin_article= parameter without an argument will result in ] in boldface type only if that article exists. If that article does not exist, then "Coins" will be in bold and unlinked.
• Use symbol if possible. But it has to be correct down to the position and the spacing. If you are not sure, fall back to the full name. Central bank websites are a good source for authoritative information.

Correct:

$1, 10¢, £5, 500 Kč

Incorrect:

1$, $ 1, 10 ¢, ¢10, £ 5, 5£, 500Kč, Kč 500

• If the symbol is behind the numeral, then put the symbol after the last one.

Recommended:

20, 50, 100, 200, 500, 1000, 5000 Sk

Not recommended:

20 Sk, 50 Sk, 100 Sk, 200 Sk, 500 Sk, 1000 Sk, 5000 Sk

• Use the representation on the coin/banknote, e.g. if it says "100 cents", then it's "100 cents", not "1 dollar"; if it says "1⁄2 franc", then it's not "50 centimes"
• Use {{frac}}: {{frac|1|4}} → 1⁄4, not 1/4 nor ¼
• If the list involves both the subunits and the main unit, do not add a new line after the subunit. For example,

Recommended:

10p, 20p, 50p, £1

Not recommended:

10p, 20p, 50p
£1

However, add a new line with <br/> after the subunit if and only if the total number of lines remains the same.

Recommended:

10p, 20p, 50p

£1, £2, £5

Not recommended:

10p, 20p, 50p, £1, £2,

£5

• Do not put "and" before the last one, e.g. "1, 5, 10, 20, 50, 100 yuan", not "1, 5, 10, 20, 50, and 100 yuan"
• For large numbers, write like these

• 1000 (no space, no comma)
• 10 000 (with &nbsp;, not a regular space)
• 100 000 (with &nbsp;, not a regular space)
• 1 000 000 (with &nbsp;, not a regular space)
• 10 (or higher) (use {{e}} if the number doesn't start with 1)

Frequent vs. rare comments:

• Smallest coins:

• recently and officially phased out (e.g. 10 and 20 h of Czech koruna, 5 New Zealand cents)
• not used in practice because of low value (1 and 5 South Korean won (maybe it's official now...))

• Denominations in the middle

• Ask yourself this question: if you are given change when conducting a daily activity, and denomination X is required to make a mathematically minimal number of coins and banknotes. Would you receive denomination X? This applies to US 50¢ (historical reason about silver stuff in the 1960s) and 20 New Taiwan dollars (a new denomination lacks government support and campaign).

• Banknotes that are being replaced by coins (e.g. Brazilian real's R$1 coin gradually rendered the R$1 banknote obsolete).
• Large denominations

• Ask yourself this question: do ATMs give this denomination? The answer is no for US$50 and US$100. This question also applies to denominations in the middle, e.g. ATMs in Iceland dispense 500, 1000, and 5000 króna notes, making 2000 króna notes "rarely used".
• Ask yourself this question: When someone buys an electronic product that costs several times the largest denomination and pays in cash, are they likely to use denomination X?

You might be thinking, "why do these simple words "rare" and "frequent" have to turn into these long definitions?" The bottom line is, these definitions describe usage in daily life. The issuance numbers quoted by the central banks/governments have little relevance in this sense, as some denominations may be used for interbank transactions, foreign exchange, in casinos, for tax evasion, by criminal elements, etc.

And only use these attributes when you are very sure. If you are not, fall back to a single list where rarely and frequently are not distinguished.

Frequency (banknotes)

• |used_banknotes=
• |frequently_used_banknotes=
• |rarely_used_banknotes=
• |banknote_article= Banknotes of the Hong Kong dollar

|banknote_article= without an argument will result in ], if that article exists. If that article does not exist, then "Banknotes" will be in bold and unlinked.

Production

• |printer= Central Printing Shop, Like issuing_authority
• |printer_website= {{URL|www.komsep.com}}
• |mint= Utopian Mint
• |mint_website= {{URL|www.swissmint.ch}}

• |footnotes=

TemplateData

TemplateData for Infobox currency

Tracking categories

• Public

• Category:ISO 4217:

Category:Currencies with ISO 4217 code (238)

Category:Currencies without ISO 4217 code (91) per |iso_code=none, or {{Infobox cryptocurrency}}

• Maintenance

Category:Pages using Infobox currency with unknown parameters (0)

Category:Pages using ISO 4217 currency to check (0) (tracking, hidden)

Category:Pages using Infobox currency to check (30)

Category:Infobox currency with an unlinked website (5) -- website checking

ISO 4217 Subtemplates used

• {{ISO 4217/code}}
• {{ISO 4217/code-minor-unit}}
• {{ISO 4217/code-to-number}}

{{ISO 4217/code-none}}

See also

• {{Infobox currency sign}}
• {{Infobox cryptocurrency}}

Parameter usage report for Template:Infobox currency.

1. World Bank Style Guide pp134–139)
2. ISO 4217 Standard definition:
   • "Data Standards, ISO 4217 - Currency Code Maintenance: Get the Correct Currency Code". www.six-group.com. SIX Group. 2022-10-01.

• Template sandboxes