devot:eeDevoted to ExpressionEngine

REEgion Select provides pre-rolled lists of countries, US states, Canadian provinces and UK counties -- as dropdowns or custom markup -- via the plugin, fieldtype, or Low Variables var type.

REEgion Select provides lists of:

• countries (based on the ISO 3166-1 list of countries, dependent territories, and special areas of geographical interest)
• US states (based on the USPS official list of US states and possessions)
• Canadian provinces and territories
• UK counties
• Canadian provinces and US states commingled

Plugin Usage

Use the following EE tags to generate each type of dropdown <select> menu in your templates:

{exp:reegion_select:countries}

{exp:reegion_select:states}

{exp:reegion_select:provinces}

{exp:reegion_select:ukcounties}

{exp:reegion_select:provinces_states}

{exp:reegion_select:states_provinces}

Or use a tag pair to generate your own custom lists or menus, using the following variables:

{exp:reegion_select:countries}
    {region_name}
    {region_alpha2}
    {region_alpha3}
    {count}
    {total_results}
{/exp:reegion_select:countries}

(And likewise for the other region types.)

Plugin Parameters

Available parameters for the plugin include:

• show—a pipe-delimited list of values to show (when you want to restrict the menu to only certain regions);
• hide—a pipe-delimited list of values to hide (when you want to restrict the menu to only certain regions) (EE2-only);
• name, class, id, and tabindex (EE2-only) for your dropdown;
• title—title or heading of the drop-down menu (EE2-only);
• type—whether to use alpha-2 ISO codes (alpha2), alpha-3 ISO codes (alpha3), or the region names (name) as the value for each <option> element;
• selected—which <option> element should be selected by default;
• null_divider—whether or not to show a dashed divider at the top of the menu

Fieldtype Usage

The template tags for REEgion Select custom fields allow you to display either the name of the region ({field_name:name}), the ISO 3166-2 alpha-2 code of the region ({field_name:alpha2}), or the ISO 3166-1 alpha-3 code of the region ({field_name:alpha3}) (applies to countries only).

Low Variables Usage

REEgion Select can also be used as a var type in the Low Variables module. The resulting global variables will output the ISO 3166-2 abbreviation value for your region, but you can access the “name” or “alpha3” values by using the {exp:low_variables:parse} tag:

{exp:low_variables:parse var="var_name" type="name"}

{exp:low_variables:parse var="var_name" type="alpha3"}

Reegion Select fields are also optimized for Low Search, indexing both region names and codes.

Note: the EE1 version does not support the following features, and is no longer being updated:

• tag pair processing for custom markup
• Low Variables support
• alpha-3 country codes
• title, hide, and tabindex parameters
• included fieldtype (EE1 users can download REEgion Select for FieldFrame)

Download REEgion Select

REEgion Select Links

• EE 2.0 Version
• EE 1.6 Version
• New plugin: REEgion Select

This entry was created May 31, 2009, 1:04 pm.
This entry was last updated June 6, 2012, 5:58 am.

Disclaimer: Information about ExpressionEngine add-ons is provided as a service to you, the user, and every member of the ExpressionEngine community. devot:ee is not responsible if you hose, mangle, wreck, or otherwise destroy your EE website by installing an add-on that you found out about at this site, regardless of its rating, Favorites status, commercial or free status, or general popularity. Caveat EEmptor!