New Semantics

Deutsch

English

Deutsch

English

Theme

Sprach-Mapping ​

Shopware 6 identifiziert Sprachen per UUID. newmeta nutzt Kurz-Codes (en, de, fr, …). Der Sprach-Mapping-Tab ueberbrueckt das: jede CMS-Sprache bekommt eine Shopware-Sprach-UUID.

Jeder Store-API-Request von der CMS an Shopware haengt diese UUID als sw-language-id-Header an. Ohne Mapping nutzt die CMS die Default-Sprache von Shopware — egal in welcher Sprache der Besucher surft.

Tab oeffnen ​

Klicke VOD / Shop → Shopware 6 → Sprach-Mapping.

Sprach-Mapping-Tab mit Liste von CMS-zu-Shopware-Zeilen
Jede Zeile ordnet eine CMS-Sprache einer Shopware-Sprach-UUID zu.

1. Shopware-Sprachen laden ​

Klicke Shopware-Sprachen laden. Der Button ruft /api/backend/shopware6 ?action=sw6_languages auf und fuellt die Shopware-Seiten-Dropdowns.

Benoetigt funktionierende Verbindung

Der Load-Call spricht mit Shopware. Ist der Verbindungstest im Verbindung-Tab rot, erst das beheben — siehe Shopware 6 Setup.

2. Auto-Detect ​

Klicke Auto-Detect, damit die CMS jede CMS-Sprache automatisch mit einer Shopware-Sprache gleichen Zwei-Buchstaben-Codes verknuepft (de → de-DE, en → en-GB).

Auto-Detect-Ergebnis mit vorbefuellten Shopware-Sprach-Dropdowns
Auto-Detect befuellt die Dropdowns mit dem besten Zwei-Buchstaben-Treffer.

Vorschlaege gegenpruefen — Shopware hat oft en-GB und en-US, Auto-Detect nimmt den ersten Treffer. Abweichungen manuell korrigieren.

3. Mappings manuell hinzufuegen ​

Wenn Auto-Detect eine Sprache uebersieht:

  1. Klicke Mapping hinzufuegen.
  2. Waehle links die CMS-Sprache.
  3. Waehle rechts die Shopware-Sprach-UUID im Dropdown.
  4. Trage Locale als Shopware-Locale-Code ein (z.B. de-DE, en-GB).
  5. Klicke Sprach-Mapping speichern.

Feld-Referenz pro Zeile ​

FeldZweck
CMS-SpracheKurz-Code aus der CMS (en, de, fr, …). Nach dem Anlegen schreibgeschuetzt.
Shopware-SpracheUUID + Name + Locale der Shopware-Sprache.
LocaleShopware-Locale-Code. Einige Shopware-Plugins lesen den Locale-String explizit.

Mapping entfernen ​

Muelleimer-Icon in der Zeile, dann Sprach-Mapping speichern, damit die Aenderung uebernommen wird.

Aktuelle Sprache entfernen

Wenn du das Mapping der aktuell gebrowsten Sprache entfernst, faellt die CMS bei jedem Request auf Shopwares Default-Sprache zurueck — alle Produkttitel erscheinen ploetzlich in dieser Default-Sprache. Immer fuer jede live geschaltete CMS-Sprache ein Mapping vorhalten.

Haeufige Fehler ​

Dropdown leer

Ist das Shopware-Sprache-Dropdown leer, wurde Shopware-Sprachen laden nicht geklickt oder der Call schlug fehl. Erneut laden. Wenn es weiter scheitert, zuerst den Verbindungstest im Verbindung-Tab pruefen.

Produkttitel in falscher Sprache

Falsches Rendering bedeutet meist: Die UUID zeigt auf eine Sprache, die am Sales Channel nicht aktiviert ist. In Shopware: Sales Channels → dein Kanal → Languages — dort die Sprache aktivieren und anschliessend in der CMS neu mappen.

Locale vom Shopware-Plugin ignoriert

Einige Plugins nutzen locale statt der Sprach-UUID. Wenn Plugin-seitige Uebersetzungen fehlen, die Spalte Locale mit dem Shopware-Locale-Code fuellen (de-DE, en-GB).

Siehe auch ​