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

OptionMeaning
$nameDefault country, region, city, currency, locale, language, timezone.
rendererform method that draws the list: list_box (country default), select2_box (region, city), select_box, radio_box, tom_select_box...
row_tplText of each item: %icon %name %code for countries.
countryCountry of region_box() / city_box(); default UA.
countries, regionsYour own list instead of the data handler.
selected, multiple, js_optionsAs for the renderer.
edit_linkIn 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, timezones and the sys_locale_langs table; an empty geo table gives an empty list.
  • renderer names a form method: site code only.

See also: demo:form/boxes/country_box, demo:form/boxes/timezone_box, misc:geo