Geo and locale boxes form()
Ready selects of countries, regions, cities, currencies, locales, languages and time zones from the framework data.
form()->country_box($name = '', $desc = '', $extra = [], $replace = [])
form()->region_box($name = '', $desc = '', $extra = [], $replace = [])
form()->city_box($name = '', $desc = '', $extra = [], $replace = [])
form()->currency_box($name = '', $desc = '', $extra = [], $replace = [])
form()->locale_box($name = '', $desc = '', $extra = [], $replace = [])
form()->language_box($name = '', $desc = '', $extra = [], $replace = [])
form()->timezone_box($name = '', $desc = '', $extra = [], $replace = [])Options
| Option | Meaning |
|---|---|
$name | Default country, region, city, currency, locale, language, timezone. |
renderer | form method that draws the list: list_box (country default), select2_box (region, city), select_box, radio_box, tom_select_box... |
row_tpl | Text of each item: %icon %name %code for countries. |
country | Country of region_box() / city_box(); default UA. |
countries, regions | Your own list instead of the data handler. |
selected, multiple, js_options | As for the renderer. |
edit_link | In the admin a link to the manage page of the list. |
Example
Code
return form(['country' => 'UA', 'currency' => 'EUR', 'language' => 'en', 'timezone' => 'Europe/Kyiv'])
->country_box(['renderer' => 'select_box'])
->region_box(['country' => 'UA', 'renderer' => 'select_box'])
->city_box(['country' => 'UA', 'renderer' => 'select_box'])
->currency_box(['renderer' => 'select_box'])
->locale_box(['renderer' => 'select_box'])
->language_box(['renderer' => 'select_box'])
->timezone_box(['renderer' => 'select_box']);Notes
- Lists come from the data handlers
geo_countries,geo_regions,geo_cities,currencies,languages_new,timezonesand thesys_locale_langstable; an empty geo table gives an empty list. renderernames a form method: site code only.
See also: demo:form/boxes/country_box, demo:form/boxes/timezone_box, misc:geo