Summary

Usage

fetch( 'content', 'country_list',
       hash( [ 'filter', filter, ]
             [ 'value', value    ]  ) )

Parameters

Returns

An array of hashes (see below) or FALSE.

Description

This function returns a structure that contains information about countries which are mentioned in the "country.ini" configuration file. The optional "filter" parameter sets the type of filtering that will be used when the countries are fetched. It can be set to "Name", "Alpha2", "Alpha3" or "IDC". The "value" parameter can be used to set the filter's value. For example, it could be set to "Norway".

Note that the names of the countries are fetched according to the current locale settings.

The function returns an array of hashes. The hashes consist of the following elements:

Examples

Example 1

{def $all_countries=fetch( 'content', 'country_list' )}
 
{foreach $all_countries as $country}
    {$country.Name} <br />
{/foreach}

Outputs the names of all countries specified in the "country.ini" configuration file or its override.

Example 2

{def $country=fetch( 'content', 'country_list', hash( 'filter', 'Name', 'value', 'Norway' ) )}
 
{$country.Name} : {$country.IDC}

Outputs the country name and international dialing code for Norway.