FormItCountryOptions

What is FormItCountryOptions?¶

FormItCountryOptions is an assistance snippet for FormIt 1.7.0+ that will output an option list of countries in the world. It is useful for forms that need a dropdown list of countries.

Usage¶

Simply add the Snippet to your form, inside a <select> element:

<select name="country">
    [[!FormItCountryOptions? &selected=`[[!+fi.country]]`]]
</select>

Note how we are passing the value of the "fi.country" placeholder (which stores the value of the country field) into the selected parameter. This tells FormItCountryOptions to select the last-selected option in the form.

FormItCountryOptions Properties¶

FormItCountryOptions comes with some default properties you can override. They are:

Prioritizing Countries¶

Sometimes you want to have certain countries appear at the top of the list, in an option group. FormItCountryOptions supports this, with the &prioritized option. For example:

[[!FormItCountryOptions?
    &selected=`[[+fi.country]]`
    &prioritized=`US,GB,DE,RU,JP,FR,NL,CA,AU,UA`
]]

Will output a list that looks like this:

You simply pass the ISO codes of the countries you wish to prioritize in the &prioritized parameter. You can also adjust the text of the option groups with the &prioritizedGroupText and &allGroupText properties.

See Also¶

1. FormIt.Hooks
   1. FormIt.Hooks.email
   2. FormIt.Hooks.FormItAutoResponder
   3. FormIt.Hooks.math
   4. FormIt.Hooks.recaptcha
   5. FormIt.Hooks.redirect
   6. FormIt.Hooks.spam
   7. FormIt.Hooks.FormItSaveForm
2. FormIt.Validators
3. FormIt.FormItRetriever
4. FormIt.Tutorials and Examples
   1. FormIt.Examples.Custom Hook
   2. FormIt.Examples.Simple Contact Page
   3. FormIt.Handling Selects, Checkboxes and Radios
   4. FormIt.Using a Blank NoSpam Field
5. FormIt.FormItCountryOptions
6. FormIt.FormItStateOptions