Sprachen und Übersetzungen¶

Texte in einem wpShopGermany kommen aus drei verschiedenen Quellen. Woher welcher Text kommt, entscheidet darüber, wo eine Änderung hingehört — und ob sie ein Update übersteht.

Was	Wo es liegt	Womit Sie es ändern
Feste Texte des Plugins z. B. „Weiter shoppen“, „Zwischensumme“, Fehlermeldungen	mitgelieferte Sprachdatei `lang/wpsg-<Sprache>.mo` im Plugin-Ordner	Loco Translate oder WPML String Translation, Ablage in `wp-content/languages/wpsg/`
Dynamische Werte des Shops Namen von Zahlungs- und Versandarten, Ländernamen, Versandzonen, Auswahl der Anrede	Datenbank, zusätzlich in `lib/translation.phtml` im Plugin-Ordner	WPML String Translation, gefüllt über den Button „String-Übersetzung füllen“
Inhalte Produkte, Kategorien, Seiten, Beiträge	Datenbank	WPML Multilingual CMS und Translation Management

Die mitgelieferte Sprachdatei¶

wpShopGermany bringt seine deutschen Texte im Programmcode mit und liefert eine vollständige englische Übersetzung (wpsg-en_US) als Datei mit. Ein englischsprachiger Shop braucht dafür kein zusätzliches Plugin: Es genügt, die Sprache in WordPress unter Einstellungen → Allgemein → Sprache der Website umzustellen.

Geladen wird in zwei Stufen:

wp-content/languages/wpsg/wpsg-<Sprache>.mo — wenn diese Datei vorhanden ist, gilt sie.
Andernfalls die mitgelieferte Datei aus dem Plugin-Ordner, wpshopgermany-free/lang/.

Eigene Änderungen an den festen Texten¶

Ändern Sie einen Text nie direkt in der mitgelieferten Datei im Plugin-Ordner. Die mitgelieferten Sprachdateien werden bei jedem Update ersetzt, Ihre Änderung ist danach weg.

Der richtige Ort ist wp-content/languages/wpsg/. Genau dorthin schreiben auch Loco Translate und die String-Übersetzung von WPML, wenn Sie die Übersetzung im Backend bearbeiten. Diese Dateien überstehen jedes Update.

Der Preis dafür: Ihre eigene Datei hat Vorrang. Verbesserungen, die wir an der mitgelieferten Übersetzung vornehmen, kommen bei Ihnen dann nicht an. Nach einem Update, dessen Changelog eine überarbeitete Sprachdatei nennt, erzeugen Sie Ihre Fassung deshalb einmal neu aus der mitgelieferten lang/wpsg-<Sprache>.po und tragen Ihre eigenen Formulierungen dort erneut ein.

Eine weitere Sprache anlegen¶

Mitgeliefert werden Deutsch (im Programmcode) und Englisch (wpsg-en_US). Für jede weitere Sprache legen Sie eine eigene Sprachdatei an:

Kopieren Sie lang/wpsg-en_US.po aus dem Plugin-Ordner. Sie enthält alle Texte des Plugins; die Originaltexte sind deutsch, die Übersetzungen englisch.
Benennen Sie die Kopie nach dem Sprachcode, den WordPress für Ihre Sprache verwendet, etwa wpsg-fr_FR.po für Französisch oder wpsg-nl_NL.po für Niederländisch.
Öffnen Sie die Datei in einem Editor für Sprachdateien, etwa Poedit oder Loco Translate, und ersetzen Sie die englischen Übersetzungen durch Ihre. Beim Speichern entsteht zusätzlich die Datei wpsg-fr_FR.mo, die WordPress liest.
Legen Sie beide Dateien in wp-content/languages/wpsg/ ab.

Stellen Sie danach die Sprache der Website bzw. des Benutzers in WordPress auf diese Sprache um.

Eigene Sprachdateien, die im Ordner lang/ des Plugins liegen und dort nicht mitgeliefert werden, übernimmt der Shop bei einem Update ebenfalls. Der sichere Ort bleibt aber wp-content/languages/wpsg/.

Dynamische Werte¶

Namen, die Sie selbst im Backend vergeben — etwa „Vorkasse“ als Bezeichnung einer Zahlungsart —, stehen in der Datenbank und lassen sich nicht über eine Sprachdatei übersetzen. Der Shop schreibt sie deshalb zusätzlich in die Datei lib/translation.phtml im Plugin-Ordner, damit Übersetzungswerkzeuge sie finden. Die Datei wird automatisch angelegt und bei jeder Änderung im Backend ergänzt; bei einem Update bleibt sie erhalten.

Dazu braucht der Webserver Schreibrechte auf den Ordner lib/ und die Datei darin. Fehlen sie, meldet der Shop das im Backend.

Der Button „String-Übersetzung füllen“ unter wpShopGermany → Konfiguration → Einstellungen → WPML Einstellungen übergibt die Ländernamen, die Namen der Versandzonen, die Auswahl der Anrede und den Text der Widerrufsbelehrung für die Bestellbestätigung an die String-Übersetzung von WPML. Bereits automatisch angelegte Einträge werden dabei entfernt und neu geschrieben — eigene Übersetzungen dieser Einträge in WPML gehen dabei verloren und müssen erneut eingetragen werden.

Inhalte¶

Produkte, Kategorien und Seiten sind Inhalte und werden nicht über Sprachdateien übersetzt, sondern über WPML. Die Einrichtung beschreibt das Tutorial Übersetzungen mit WPML.