devot:eeDevoted to ExpressionEngine

If you want to add your own language, it’s as easy as creating a new folder within the language folder and reference it via the language parameter.

Parameters:

 
• language: language folder name. Like ‘english’, ‘french’, ‘german’, ‘italian’, ‘russian’, ‘spanish’ etc. Defualt value: ‘default’
 
• type: It may be either “alpha2” or “alpha3”. If you give “alpha2” then other parameter like show, hide and selected should have alpha2 values. If you give “alpha3” then other parameter like show, hide and selected should have alpha3 values. Default value: ‘alpha2’
 
• show: alpha code separated with pipe operator(”|”). The values of this parameter will depend on type parameter. Means you have to provide same alpha type code which provided into “type” parameter. It’s case in-sensitive.
 
• hide: alpha code separated with pipe operator(”|”). The values of this parameter will depend on type parameter. Means you have to provide same alpha type code which provided into “type” parameter. It’s case in-sensitive.
 
• orderby: one of parameter can paased: alpha2, alpha3, country and file. Please Note: If you are giving orderby parameter as file then countries will be sorted as according to language file. Default value: ‘file’
 
• sort: either desc or asc

Variables:

 
• {country_count}: country count. Starting at 1.
 
• {country_total_results}: the total number of counties.
 
• {country_alpha2}: country alpha2 code in upper case.
 
• {country_alpha3}: country alpha3 code in upper case.
 
• {country_name}: name of the country.
 
• {iso_number}: country ISO number

Examples

Example 1:

     <label for="country_code">Your country</label>
     <select name="country_code" id="country_code">
         <option value="">Please choose your country</option>
         {exp:country_list:countries language="german"}
             <option value="{country_alpha2}"{if "{country_code}" == "{country_alpha2}"} selected="selected"{/if}>{country_name}</option>
         {/exp:country_list:countries}    	
     </select>

Example 2:

     <label for="country_code">Your country</label>
     <select name="country_code" id="country_code">
         <option value="">Please choose your country</option>
         {exp:country_list:countries type="alpha2" orderby="alpha2" sort="asc" show="gb|us|in" hide="in" language="german"}
             <option value="{country_alpha2}"{if "{country_code}" == "{country_alpha2}"} selected="selected"{/if}>{country_name}</option>
         {/exp:country_list:countries}
     </select>

Example 3:

     <ul>
         {exp:country_list:countries type="alpha2" orderby="alpha2" sort="asc" show="gb|us|in" hide="in" language="german"}
             <li>{country_name}</li>
         {/exp:country_list:countries}
     </ul>

Example 4:

     {exp:country_list:countries type="alpha2" show="{member_country_code}" language="{language}"}{country_name}{/exp:country_list:countries}

Known Limitation

 
• only one plugin per template.
 
• requires UTF-8.
 
• “orderby” it not working for non-latin characters.
 
• countries may be called differently.

Version History

 
• 1.0.2 - initial release