Currency Loop

Currency loop lists currencies.

{loop type="currency" name="the-loop-name" [argument="value"], [...]}

Important informations :

* : argument is required
** : at least one of ** marked argument is required

Global arguments

Argument Description

Determine if loop is use in backend context.

default : false

example : backend_context="on"


force return result for i18n tables even if there is no record

default : false

example : force_return="on"


The maximum number of results to display.

example : limit="10"

name *

The loop name. This name must be unique and is used to reference this loop further in the page (see ifloop, elseloop or pageloop)


The first product to display offset. Will not be used if `page` argument is set.

default : 0

example : offset="1"


The page to display.

example : page="2"

Loop arguments

Argument Description

A boolean value to display only the default currency.

example : default_only="true"


A single or a list of currency ids.

example : exclude="2", exclude="1,4,7"


A single or a list of currency ids.

example : id="2", id="1,4,7"


A lang id

example : lang="1"


A list of values

Expected values :
  • code : order by currency code
  • code_reverse : reverse order by currency code
  • id : order by id
  • id_reverse : order by id DESC
  • name : order by currency name
  • name_reverse : reverse order by currency name

default : manual

example : order="id_reverse"

Global outputs

Variable Description
$LOOP_COUNT the current results index, starting from 1
$LOOP_TOTAL the total number of results returned by the loop
$CREATE_DATE The creation date of this Currency
$UPDATE_DATE The last modification date of this Currency

Loop outputs

Variable Description
$ID the currency id
$ISOCODE the ISO numeric currency code
$IS_DEFAULT returns if the currency is the default currency
$IS_TRANSLATED check if the currency is translated
$LOCALE The locale used for this research
$NAME the currency name
$POSITION the currency position
$RATE the currency rate
$SYMBOL the ISO numeric currency symbol