--- title: "TYPO3: Alle Länder in jeder Sprache nahtlos integriert" url: "https://b13.com/de/wissen/eine-welt-voller-laenderinformationen-nutzen" description: TYPO3 vereinfacht die Arbeit mit Länderlisten, indem es eine umfassende Länder-API integriert, die auf verlässlichen UN-Daten basiert. Vergiss die Erweiterungen von Drittanbietern und genieße aktuelle, lokalisierte Länderlisten in jeder Sprache. image: "https://b13.com/fileadmin/_processed_/d/7/csm_CountryDropdownViewHelper_Sharing_f29f8aced6.png" date: 2025-03-21 modified: 2026-08-19 lastUpdated: 2026-08-19 --- # TYPO3: Alle Länder in jeder Sprache nahtlos integriert [ TYPO3 ](https://b13.com/de/wissen/typo3) [ Open Source ](https://b13.com/de/wissen/open-source) [ Core-Development ](https://b13.com/de/wissen/core-development) [ TYPO3 v12 ](https://b13.com/de/wissen/typo3-v12) Eine Welt voller Länderinformationen nutzen ============================================= Mühelose Integration von mehrsprachigen Länderlisten in dein TYPO3-Projekt ![](https://b13.com/fileadmin/_processed_/c/6/csm_benni_5e519221c4.jpg)Benni Mack 21. März 2025 [ RSS Feed ](https://b13.com/de/rss.xml) ![Ein Cowboy mit einem Hut und einem Globus als Kopf reitet auf einem gelben Pferd, das im Rampenlicht vor einem stilisierten Hintergrund aus grünen Hügeln und abstrakten Formen steht.](https://b13.com/fileadmin/_processed_/6/1/csm_CountryDropdownViewHelper_Headerbild_84f9409425.webp) Seit den Anfängen von TYPO3 ist die Erstellung einer einfachen Länderliste ein allgegenwärtiger Anwendungsfall — meist für die Gestaltung von Kontaktformularen oder für Extension-Autoren, die einen Benutzerregistrierungsprozess aufbauen. Um eine Länderliste in ein beliebiges Frontend-Formular einzubinden, war eine Integration in das TYPO3-eigene Formular-Framework (über die Extension [Form Country Select](https://extensions.typo3.org/extension/form_country_select)) oder eine Integration in die Powermail-Extension ([Powermail Country Viewhelper](https://extensions.typo3.org/extension/reint_powermail_country)) erforderlich. Vor TYPO3 v12 gab es eine nützliche Erweiterung namens „[Static Info Tables](https://extensions.typo3.org/extension/static_info_tables)„. Diese Extension bietet eine statisch verfügbare Datenbanktabelle mit einer Liste aller Länder und anderen statischen Informationen, wie z.B. eine Liste aller Sprachen oder Währungen. Diese Erweiterung gibt es schon seit etwa 20 Jahren und sie war immer mit der neuesten Version von TYPO3 kompatibel. Leider hat die Erweiterung ein paar Nachteile: - Die Informationen waren nur mit dem englischen Namen verfügbar (z. B. „Switzerland“ und nicht „Schweiz“ wie für die Schweizer Nutzer). - Die Daten wurden in einer Datenbank gespeichert, so dass jedes Mal eine Datenbankabfrage erforderlich war, wenn ein Nutzer ein Land aus einem Formular auswählte. Das erste Hindernis wurde mit Zusätzen zur Erweiterung überwunden, meist mit einem Suffix wie „*static\_info\_tables\_da*„ für die dänischen Übersetzungen dieser Liste. Diese Zusätze waren jedoch nicht immer so aktuell wie die Haupterweiterung. Der zweite Punkt bezog sich auf die konzeptionelle Funktionalität des Systems und hatte historische Gründe. Die Liste der installierten Erweiterungsdaten war keinen Änderungen unterworfen, also gab es auch keinen Grund, die Datenbank regelmäßig mit solchen aktualisierten Informationen zu versorgen. Schließlich gibt es elegantere Möglichkeiten, diese Daten abzurufen. Mit TYPO3 v12 wurden all diese Probleme gelöst, indem diese Funktionalität in Core aufgenommen wurde und die [Länder-API](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/Country/Index.html#country-api) verwendet wird, um eine vollständige Liste der aktuellen Länder abzurufen. Wenn du mehr über die neueste Version von TYPO3 erfahren möchtest und wie du deine Installation aktualisieren kannst, kontaktiere uns. [ Kontaktiere uns ](https://b13.com/de/loesungen/typo3-upgrades) Wie TYPO3 die Liste der Länder abruft --------------------------------------- Die TYPO3 Core-Entwickler haben sich die Mühe gemacht, verschiedene bestehende Open-Source-Lösungen zu analysieren, um herauszufinden, wo man die „offizielle Liste“ der Länder findet. Das ist gar nicht so einfach, denn die Ländernamen selbst sind nicht statisch. Zum Beispiel [hat die Türkei ihren offiziellen englischen Namen 2022 in Türkiye geändert](https://en.wikipedia.org/wiki/Turkey#Name). Das weithin bekannte Open-Source-Projekt Debian Linux bietet eine [aktuelle Liste aller Länder](https://salsa.debian.org/iso-codes-team/iso-codes), ihrer vollständigen Namen und ihrer offiziellen englischen Namen, wie sie von den Vereinten Nationen und der [ISO-Norm ISO 31–664](https://www.iso.org/iso-3166-country-codes.html) definiert sind. Glücklicherweise ist diese Liste auch im JSON-Format verfügbar und wird von einem PHP-Wrapper als Composer-Paket namens „[sokil/php-isocodes-db-i18n](https://packagist.org/packages/sokil/php-isocodes-db-i18n)„ bereitgestellt. Darüber hinaus enthält dieses Paket nicht nur die englische Version, sondern auch alle Namen und offiziellen Bezeichnungen in verschiedenen Sprachen — einschließlich aller offiziell unterstützten Sprachen (50+) von TYPO3 Core. Anstatt dieses Paket im JSON-Format für jedes Projekt auszuliefern, benötigt TYPO3 nur dieses Paket im Mono-Repository und wandelt die JSON-Datei in eine vollständige PHP-Klasse um — die so von der PHP-Runtime optimiert wird und nativ von PHP gecached werden kann. Alle Übersetzungen werden dann als XLF-Dateien hinzugefügt, sodass das reguläre Verhalten von TYPO3 bei der Übersetzung von Strings berücksichtigt wird. Funktionen wie das Überschreiben von XLF-Dateien (wie bei jeder anderen XLF-Datei auch) können genutzt werden, und die korrekte Übersetzung wird mit der ausgewählten Site Language im TYPO3-Frontend oder der ausgewählten Sprache der Backend-Nutzer im TYPO3-Backend verbunden. Ein Continuous-Integration-Job prüft regelmäßig, ob dieses Paket aktualisiert wird, so dass **TYPO3 Core immer mit der vollständigen Liste aller Länder gemäß der Definition der Vereinten Nationen ausgeliefert wird**. Wie man die Länder-API in Erweiterungen verwendet --------------------------------------------------- Für die Autoren von Erweiterungen ist die[ Country-API](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/Country/Index.html#country-api) so einfach, wie sie nur sein kann. Es gibt einen einzigen Entry Point: ``` 1

2

3

4

5

6

7

8

9

10

11

12

13

14

``` ``` $provider = new \TYPO3\CMS\Core\Country\CountryProvider();



// get a list of all countries

$allCountries = $provider->getAll();



// get information about a specific country

$switzerland = $provider->getByIsoCode('CH');

$switzerland->getName(); // Switzerland

$switzerland->getOfficialName(); // Swiss Confederation



// And use the LanguageService to use a localized version

$languageService = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Localization\LanguageServiceFactory::class)->create('de-CH');

$languageService->sL($switzerland->getLocalizedNameLabel()); // Schweiz



``` Es gibt Möglichkeiten, die gesamte Liste auf eine bestimmte Auswahl zu filtern, was für die Erstellung deiner Länder-Dropdowns praktisch ist, aber dazu kommen wir später. **Aber Achtung**: Achte darauf, dass die Sprach- und Ländercodes richtig kopiert werden, wenn du sie zu TYPO3 hinzufügst. Ein nativer Fluid ViewHelper ------------------------------ Die meisten Anwendungsfälle sind in Extbase- Extensions auf der Ebene von Fluid-Templates. Es wurde ein neuer ViewHelper `` hinzugefügt: ``` 1

2

3

4

5

6

7

``` ```
name="country"

value="CH"

sortByOptionLabel="true"

prioritizedCountries="{0: 'DE', 1: 'AT', 2: 'CH'}"

excludeCountries="{0: 'IR'}"

/>

``` Dieser ViewHelper nutzt die Country-API und bietet ein `