Introduction

What does it do?

Attention

With TYPO3 v12.3 a new form element "Country Select" was introduced which serves the same purpose as the form element provided by this extension. This extension is now considered legacy, you should use TYPO3 Core's form element instead. There will be no compatible version for TYPO3 v13+. However, the current version will receive bug fixes as long as the LTS version is supported by the community.

Have also a look into the Migration chapter when you upgrade from an older version.

The extension provides a form element for the TYPO3 Form Framework which displays a select box with all countries from the ISO 3166-1 standard. The country list is localised according to the language of the website page.

A select box with all countries

A select box with all countries

This is especially useful for forms on websites with an international audience, where the visitor can select his country.

The value of an option is the alpha-2 code of the country, the label is the localised country name.

By default, the list is sorted alphabetically by country name. However, it is possible to modify the order of the countries or the country list as a whole.

Where does the country list come from?

The list of countries is based on the symfony/intl package, which in turn uses the localisation data of the ICU library.

Release Management

This extension uses semantic versioning which basically means for you, that

  • Bugfix updates (e.g. 1.0.0 => 1.0.1) just includes small bug fixes or security relevant stuff without breaking changes.

  • Minor updates (e.g. 1.0.0 => 1.1.0) includes new features and smaller tasks without breaking changes.

  • Major updates (e.g. 1.0.0 => 2.0.0) breaking changes which can be refactorings, features or bug fixes.