Lieferland, Währung und Steuer automatisch erkennen

Installation

1. Plugin installieren und aktivieren.
2. Erweiterungen → Meine Erweiterungen → Konfiguration öffnen.

In fünf Minuten einsatzbereit

Die Voreinstellungen passen für die meisten Shöps. Sie müssen nur prüfen, ob Ihre Länder eingerichtet sind.

1. Einstellungen → Länder: Die Länder, in die Sie liefern, müssen aktiv und für den Versand verfügbar sein, und dem Verkaufskanal zugeordnet.
2. Einstellungen → Versandarten: Legen Sie je Land eine Versandart mit einer Regel an, zum Beispiel „Lieferadresse Land ist Österreich“. Ohne solche Regeln sieht jedes Land dieselbe Versandart.
3. Im Plugin unter Nur zum Testen ein Länderkürzel eintragen, etwa AT, und den Shop in einem privaten Fenster öffnen. So prüfen Sie alles ohne VPN.
4. Das Testfeld danach leeren. Solange dort ein Land steht, wird jeder echte Besucher so behandelt, als käme er von dort.

Die Einstellungen

Allgemein

• Verhalten: Besucher zuerst fragen zeigt einen Hinweis und ändert erst nach Zustimmung etwas. Automatisch anwenden setzt die Werte ohne Hinweis. Weiterleiten schickt den Besucher direkt zur passenden Domain und benötigt eine Zuordnung unter Zuordnung.
• Lieferland setzen: Steuert Steuersatz, Bruttopreise, Versandkosten und verfügbare Versandarten. Das ist die wichtigste Einstellung.
• Währung setzen: Wirkt nur bei Ländern, die unter Zuordnung eine Währung haben.
• Auswahl merken: Wie lange die Entscheidung des Besuchers gilt, bevor erneut gefragt wird.
• Suchmaschinen-Bots: Eingeschaltet lassen. Google sieht dann immer den Shop-Standard, Ihre indexierten Preise bleiben stabil.

Cookies und Einwilligung

• Sofort ausführen: Standard.
• Erst nach Cookie-Einwilligung: Es passiert nichts, bis der Besucher die Gruppe „Land und Währung“ im Cookie-Manager akzeptiert.
• Ohne Cookie: Das Land wird bei jedem Seitenaufruf serverseitig erkannt und gesetzt. Preise stimmen ab der ersten Seite, es wird nichts auf dem Gerät gespeichert. Hinweis und Weiterleitung entfallen in diesem Modus.

Erkennung

• Wie der Besucher erkannt wird: Nach Standort, nach Browsersprache, oder Standort mit Browsersprache als Reserve.
• Server-Header: Eingeschaltet lassen. Liest CF-IPCountry, GEOIP_COUNTRY_CODE und ähnliche. Cloudflare und die meisten Hoster liefern das ohne Zutun.
• MaxMind-Datenbank: Optional. Pfad zu einer lokalen .mmdb-Datei, benötigt das Paket geoip2/geoip2. Ist der Pfad falsch, passiert nichts, der Shop läuft normal weiter.
• Externer Dienst: Standardmäßig aus, und dabei sollte es für einen Shop in der EU bleiben. Eingeschaltet wird die IP des Besuchers an einen Dritten gesendet, das gehört dann in Ihre Datenschutzerklärung.

Zuordnung

• Land zu Währung: Eine Zeile je Land, zum Beispiel CH=CHF. Nicht gelistete Länder behalten die Währung des Shops. Die Währung muss dem Verkaufskanal zugeordnet sein.
• Land zu Shop-Domain: Nur nötig, wenn Sie weiterleiten oder einen Link anbieten wollen, zum Beispiel AT=https://shop.at.
• Browsersprache zu Shop-Domain: Wird genutzt, wenn das erkannte Land keine eigene Domain hat.

Darstellung

• Position: Leiste oben, Leiste unten, Modal in der Mitte, kleine Box unten rechts oder unten links.
• Länderauswahl im Header: Zeigt neben Sprache und Währung eine Auswahl der versandfähigen Länder. Nach dem Umschalten den Cache leeren, der Header wird über ESI separat gecacht.
• Farben: Leer lassen, dann folgt der Hinweis Ihrem Theme.
• Besucher muss sich entscheiden: Sperrt die Seite, bis Ja oder Nein gewählt wurde. Mit Bedacht einsetzen, es steht zwischen jedem Besucher und Ihrem Shop.

Texte

Überschrift, Text und Buttons sind Snippet-Felder. Die Formulierung liegt in den Snippet-Sets, also je Sprache. Die Platzhalter %country% und %currency% werden ersetzt.

Wenn etwas nicht erscheint

• Kein Hinweis: Storefront neu gebaut? bin/build-storefront.sh ist nötig, theme:compile allein baut kein JavaScript.
• Kein Hinweis trotz Neubau: Der Besucher hat bereits entschieden. Cookie zaiba-auto-local löschen oder ein neues privates Fenster öffnen.
• Nichts ändert sich: Ist das Land dem Verkaufskanal zugeordnet und für den Versand verfügbar?
• Länderauswahl fehlt: Cache leeren. Bei weniger als zwei versandfähigen Ländern wird sie absichtlich nicht angezeigt.
• Einstellung wirkt nicht: bin/console cache:clear, die Seiten werden gecacht.