Countries API - CountriesDB

Länder- und Bundesland-Dropdown für ein WordPress-Formular

Ergänze ein eigenes WordPress-Formular um ein Länder-Dropdown und eine passende Auswahl für Bundesland, Provinz oder Region.

Länder- und Bundesland-Dropdown für ein WordPress-Formular

Wer in einem WordPress-Formular von den USA zu Kanada wechselt, sollte danach kanadische Provinzen zur Auswahl sehen. Mit zwei fest hinterlegten Listen musst du diese Abhängigkeit selbst pflegen. Das CountriesDB-Widget aktualisiert die Regionsauswahl, sobald sich das Land ändert.

Die Anleitung für Website-Formulare erklärt das gemeinsame HTML-Beispiel und die Einrichtung des Kontos.


Was du brauchst

Du brauchst ein Formular, dessen HTML und Verarbeitung du kontrollierst. Es kann in einem Block für individuelles HTML stehen oder aus deinem Theme kommen. WPForms, Gravity Forms und Contact Form 7 verwalten ihre Felder und Einsendungen selbst. Hier bindest du das eigenständige Widget in dein eigenes Formular ein.

Erstelle ein CountriesDB-Projekt, lege einen öffentlichen Schlüssel an und füge den Hostnamen der veröffentlichten Seite zu den erlaubten Domains hinzu.


So bindest du die Felder ein

1. Öffne das HTML des Formulars

Nutze im Block-Editor einen Block für Individuelles HTML oder bearbeite die Formularvorlage deines Themes. Die WordPress-Dokumentation zum HTML-Block erklärt, welche Berechtigungen beim Speichern von Skripten greifen. Wird das Skript entfernt, bitte die Website-Administration, es über das Theme einzubinden.

2. Füge die Felder und das Skript hinzu

Setze die beiden Felder in das vorhandene Formular. Übernimm die Feldnamen, die deine Formularverarbeitung erwartet. Lade das Skript einmal pro Seite und ersetze den Platzhalter durch den öffentlichen Schlüssel. Die vorhandene Schaltfläche zum Absenden bleibt im Formular.

<script src="https://unpkg.com/@countriesdb/widget@latest/dist/index.js?public_key=YOUR_PUBLIC_KEY"></script>

<label for="country">Land</label>
<select id="country" name="country" class="country-selection"
        data-name="country" data-label="Land auswählen" data-preselected="" required></select>

<label for="region">Bundesland / Provinz / Region</label>
<select id="region" name="region" class="subdivision-selection"
        data-country="country" data-label="Region auswählen"></select>

3. Sende das veröffentlichte Formular probeweise ab

Rufe die Seite unter dem erlaubten Hostnamen auf, wähle Land und Region und wechsle dann das Land. Die bisherige Region muss verschwinden. Sende einen Test ab und kontrolliere die Werte im Zielsystem, etwa im CRM. Bleiben die Felder leer, prüfe das Skript im veröffentlichten HTML und die erlaubten Domains.


Häufige Fragen

Brauche ich Unterstützung aus der Entwicklung?
Wenn du das Formular und seine Verarbeitung bereits selbst verwaltest, kannst du die Felder einfügen. Lass dir helfen, falls das Theme die Felder erzeugt oder die Verarbeitung angepasst werden muss.

Sind Bundesländer und Provinzen verfügbar?
Ja, soweit für das ausgewählte Land Unterteilungen verfügbar sind. Für internationale Formulare eignet sich eine Beschriftung wie „Bundesland / Provinz / Region“.

Verschickt der Block E-Mails oder speichert er Anfragen?
Diese Aufgaben übernimmt weiterhin deine Formularverarbeitung. Das Widget befüllt die beiden Auswahllisten.

Wie prüfe ich die Codes nach dem Absenden?
Rufe die Backend-Validierungs-API auf dem Server auf und hinterlege den privaten Schlüssel dort.


Links


Verwandte Anleitungen