Land und Bundesland im Adressformular und Checkout erfassen
Eine Kundin ändert ihr Lieferland von den USA zu Kanada. Wenn Kalifornien ausgewählt bleibt oder das Formular weiter eine US-Postleitzahl verlangt, muss sie die Adresse nachträglich korrigieren. Lass die Länderauswahl bestimmen, welche Regionen angeboten werden und welche Regeln für die Adresse gelten.
Die Anleitung für Website-Formulare erklärt das gemeinsame HTML-Beispiel, den öffentlichen Schlüssel und die erlaubten Domains.
Was du brauchst
Du brauchst Zugriff auf die Felder und die Verarbeitung deines Adress- oder Checkout-Formulars. Erstelle ein CountriesDB-Projekt mit öffentlichem Schlüssel und erlaube den Checkout-Hostnamen. Lege vorab fest, in welche Länder du lieferst und wann eine Region erforderlich ist.
So richtest du die Adressfelder ein
1. Frage zuerst nach dem Land
Platziere das Land vor Region, Ort und Postleitzahl. Gib den Lieferfeldern eigene Namen und IDs, wenn du auch eine Rechnungsadresse erfasst. Lass die Region im HTML optional und entscheide je nach Zielland, ob sie ausgefüllt werden muss.
<script src="https://unpkg.com/@countriesdb/widget@latest/dist/index.js?public_key=YOUR_PUBLIC_KEY"></script>
<label for="shipping-country">Land</label>
<select id="shipping-country" name="shipping_country" class="country-selection"
data-name="shipping-country" data-label="Land auswählen" data-preselected="" required></select>
<label for="shipping-region">Bundesland / Provinz / Region</label>
<select id="shipping-region" name="shipping_region" class="subdivision-selection"
data-country="shipping-country" data-label="Region auswählen" data-prefer-official></select>
2. Berechne Versand und Steuern bei einem Wechsel neu
Verwirf die bisherige Region, wenn das Land wechselt. Aktualisiere davon abhängige Versandkosten, Versandoptionen oder Steuern. Passe die angebotenen Länder über die Filteroptionen des Widgets an dein Liefergebiet an und prüfe das Liefergebiet auch auf dem Server.
3. Prüfe die Werte auf dem Server
Sende zwei Testbestellungen mit unterschiedlichen Kombinationen. Prüfe, ob dein Checkout die erwarteten Codes erhält, etwa US und US-CA bei einer ISO-Konfiguration, und eine Region aus einem anderen Land ablehnt. Teste auch ein Zielland, in dem das Regionsfeld leer bleiben darf. Die Anleitung zur Validierung hilft dir zu entscheiden, ob du zusätzlich eine Postanschrift prüfen solltest.
Häufige Fragen
Brauche ich Unterstützung aus der Entwicklung?
In den meisten Checkouts muss jemand die Felder mit gespeicherten Adressen, Versandoptionen und serverseitigen Regeln verbinden.
Sollte das Bundesland immer Pflicht sein?
Die Regel hängt vom Zielland ab. Ein allgemeines Pflichtfeld kann gültige Adressen blockieren.
Kann ich dieselben IDs für die Rechnungsadresse verwenden?
Vergib eigene IDs und Feldnamen. Wenn beide Feldpaare auf derselben Seite stehen, richte mehrere Instanzen nach der Widget-Dokumentation ein und teste sie gemeinsam.
Belegt ein gültiges Paar aus Land und Region die Zustellbarkeit?
Es bestätigt die geografische Zuordnung. Für die Postanschrift und die Vorgaben des Versanddienstes gelten eigene Prüfungen.