Sprachen¶
Sprachen anlegen ab Shopversion 2.3¶
Das Shopsystem wird vollständig in Englisch und Deutsch lokalisiert ausgeliefert. Zusätzliche Sprachen können nachträglich hinzugefügt werden. Hierzu sind sowohl Schritte im Administrationsbereich/Gambio Admin des Shops als auch auf dem FTP-Server notwendig.
Anlegen der Sprache im Administrationsbereich/Gambio Admin¶
Öffne im Gambio Admin den Menüpunkt Einstellungen / Sprachen, Länder, Steuern / Sprachen und klicke ggf. auf aufrufen und dann auf Erstellen. Auf der rechten Seite öffnet sich eine Spalte. Hier findet die shopseitige Einrichtung der Sprache statt. Der Hauptbestandteil wird aber erst durch Kopieren der entsprechenden Dateien auf den FTP-Server erstellt. Ein alleiniges Anlegen der Sprache im Administrationsbereich/ Gambio Admin ist keine vollständige Installation.
Hinweis
Eine im Gambio Admin neu angelegte Sprache kann so lange nicht aktiviert werden, bis die Installation des Sprach-Verzeichnisses auf dem FTP-Server abgeschlossen ist. Ausstehende Dateien und Verzeichnisse werden mit einem entsprechenden Hinweis angezeigt.
Du hast beim Anlegen der Sprache im Gambio Admin folgende Einstellungsmöglichkeiten: Wähle zunächst ob du eine neue Sprache anlegen oder vohandene Sprache kopieren möchtest. Letzteres ist die vorgesehene Auswahl, da Datenbankinhalte der Quellsprache so übernommen werden. Stelle in diesem Fall unter Quellsprache die Sprache ein, aus der du die Inhalte kopieren möchtest (Standard: Deutsch).
Gib unter Name den Namen der Sprache ein (Beispiel: Spanisch). In das Feld Codierung muss der zweistellige ISO-Code für deine Sprache eingetragen werden (Beispiel für Spanisch: es), in das Feld Charset die vorgesehene Zeichencodierung: utf-8. Gib bei Verzeichnis den Namen des hochzuladenen Verzeichnisses auf deinem FTP-Server an (Beispiel: spanish). Achte bei diesen beiden Eingaben bitte auf die genaue Schreibweise!
Dies ist deshalb notwendig, damit sich der Shop auf die richtigen Verzeichnisse und Dateien beziehen kann. Anderenfalls können die übersetzten Sprachdateien nicht gefunden werden. In das Feld Sortierreihenfolge kannst du die gewünschte Sortierreihenfolge der Sprache eintragen. Die Sortierreihenfolge hat Einfluss auf die Position der Eingabefelder für diese Sprache in den Artikel- und Kategorie-Eingabemasken sowie in der Sprachwahl im Administrations- und Shopbereich.
Zudem müssen Einstellungen für die Formate von Datum und Uhrzeit, sowie die verwendete Währung vorgenommen werden. Nachfolgend findest du die Standardbelegung für die Quellsprache Deutsch.
| Feldname | Standardwert (Sprache Deutsch) |
|---|---|
| Datumsformat | d.m.Y |
| Datumsformat (Tag, lang) | %A, %d. %B %Y |
| Datumsformat (Tag, kurz) | %d.%m.%Y |
| Datumsformat (Tag und Uhrzeit) | %d.%m.%Y %H:%M:%S |
| Datumsformat (Geburtsdatum) | tt.mm.jjjj |
| HTML Parameter | dir="ltr" lang="de" |
| Währung | EUR |
| Datumsformat (PHP, Tag und Uhrzeit) | d.m.Y H:i:s |
Ändere hier den Eintrag lang="de" entsprechend des Ländercodes ab, in unserem Beispiel also zu lang="es". Bei anderen Sprachen außerhalb des Euro-Raumes muss ggf. unter Währung der Währungscode EUR ebenfalls angepasst werden.
Anlegen der Sprache auf dem FTP-Server¶
Kopiere das Verzeichnis Shopsystem\Dateien\lang\german von der Installations-CD bzw. aus dem Installationsarchiv deines Shops der Versionsreihe 2.3 oder höher auf deinen Computer. Altnernativ kannst du auch den Ordner direkt von deinem FTP-Server herunterladen. Als Beispiel wird im Folgenden die Sprache Spanisch hinzugefügt. Benenne das zuvor kopierte Verzeichnis german auf deinem Computer in spanish um. Wir empfehlen, den englischen Namen der Sprache in Kleinbuchstaben zu verwenden. Wechsele in das Verzeichnis spanish auf deinem Computer. Nun müssen an den Dateien
/spanish/init.inc.php
sowie
/spanish/admin/init.inc.php
verschiedene Anpassungen vorgenommen werden.
Ändere die Einträge
@setlocale(LC_TIME, 'de_DE.utf8', 'de_DE.UTF-8', 'de_DE@euro', 'de_DE', 'de-DE', 'de', 'ge', 'German');
so ab, dass statt de bzw. DE der jeweilige Ländercode, in unserem Beispiel es bzw. ES, verwendet wird. Zudem muss der Name der Sprache in den letzten beiden Anführungszeichen angepasst werden.
Bevor die eigentliche Übersetzung vorgenommen wird, sollte der Inhalt des Ordners original_sections in den Ordner user_sections kopiert werden. Auf diese Weise steht jederzeit das Original des jeweiligen Sprach-Pakets zur Verfügung.
Nimm die Übersetzung anschließend in den Dateien und Unterverzeichnissen des Ordners user_sections vor. Lade abschließend das gesamte Sprachverzeichnis, in unserem Beipspiel also den Ordner spanish in den Unterordler /lang/ deines Shops hoch.
Zudem sollten die Dateien, welche für die jeweilige Landesflage verwendet werden:
- /lang/spanish/flag.png
- /lang/spanish/icon.gif
- /lang/spanish/admin/images/icon.gif
ausgetauscht werden. Typische Größen sind
- flag.png: 16x11 px
- icon.gif: 32x35 px (sichtbar: 23x16 px)
- /admin/images/icon.gif: 18x13px
Hinweis
Die standardmäßig im Gambio Admin verwendete icon.gif kann wahlweise auch durch eine Datei mit anderem Namen ersetzt werden. Der Dateiname kann hierbei beim Bearbeiten der Sprache unter Einstellungen / Sprachen, Länder, Steuern / Sprachen, nach Aufruf der Seite, im Eingabefeld Symbol angepasst werden. Bitte beachte, dass diese Datei sowohl im Sprachverzeichnis, also z.B. /lang/spanish/ als auch im Unterordner /admin/images/ des Sprachverzeichnisses (z.B. /lang/spanish/admin/images/) hinterlegt werden muss.
Anpassungen und Übersetzungen für Zusatzmodule¶
Oftmals verwenden die Module von externen Anbietern eigene Sprachdateien, die separat angepasst werden müssen. Diese Module sind teilweise im Grundumfang des Shops vorhanden, standardmäßig sind hier z.B. yoochoose und shopgate betroffen.
Wenn hier keine Änderungen vorgenommen werden, wird standardmäßig die deutsche Sprache verwendet. Wenn du keines der genannten Module verwendest, kannst du diesen Abschnitt überspringen.
yoochoose
Die Einbindung für yoochoose findet in der Datei /lang/spanish/admin/init.inc.php statt. Ändere hier folgende Pfadangabe ab:
$coo_lang_file_master->init_from_lang_file('admin/yoochoose/yoo_lang_german.php');
Im Unterordner /admin/yoochoose/ des Shopverzeichnisses stehen die Dateien
- yoo_lang_english.php
- yoo_lang_german.php
- yoo_lang_spanish.php
zur Verfügung. Ändere hier den Dateinamen entsprechend ab. Ggf. müssen in der neu zugewiesenen Datei yoo_lang_... selbst noch Übersetzungen vorgenommen werden.
Shopgate
Die Einbindung von Shopgate findet in der Datei _/lang/spanish/modules/payment/_shopgate.php statt. Dort findest du die Zeile:
require_once DIR_FS_CATALOG.'shopgate/gambiogx/lang/german/modules/payment/shopgate.php';
Hier sollte der im Unterordner /shopgate/gambiogx/lang/ gelegene Ordner german heruntergeladen und umbenannt werden. Nimm die Übersetzungen in den enthaltenen Dateien entsprechend vor und benenne die Datei /admin/german.php entsprechend der Sprache um. Für unser Beispiel würde die Datei also /admin/spanish.php heißen. Lade anschließend das Verzeichnis wieder hoch.
Aktivieren der Sprache im Shop¶
Nachdem alle Änderungen auf dem FTP-Server abgeschlossen worden sind, kann die Sprache im Administrationsbereich/Gambio Admin aktiviert werden. Gehe hierzu unter Einstellungen / Sprachen, Länder, Steuern / Sprachen und setze für die jeweilige Sprache die Haken für aktiv im Frontend bzw. aktiv im Backend. Anschließend müssen unter Toolbox > Cache die Caches für Texte und E-Mail- Vorlagen geleert werden.
Achtung
Bei Änderungen an den Sprachen ist ein Leeren der Caches immer erforderlich. Anderenfalls kann es zu Fehlermeldungen und fehlerhaften Darstellungen im Shop kommen.
Vorhandene Sprachen für Shopversion 2.3 umwandeln¶
Mit der Shopversion 2.3 wird ein vereinfachtes, optimiertes Sprachsystem eingeführt. Dies erfordert Anpassungen am Dateisystem von Sprachpaketen. Beim Update der Shopversion wird diese Änderung für die Standardsprachen Deutsch und Englisch standardmäßig vorgenommen. Zusätzliche Sprachen, die in Version 2.1 oder 2.2 angelegt worden sind, müssen manuell gemäß der neuen Anforderungen angepasst werden.
Beispiel eines Sprachpakets für Französisch (Ordnername french, ISO-Code fr):
Folgende Dateien müssen umbenannt werden:¶
lang/french/french.php
in
lang/french/init.inc.php
lang/french/admin/french.php
in
lang/french/admin/init.inc.php
lang/french/fr.png
in
lang/french/flag.png
lang/french/sections
in
lang/french/original_sections
lang/french/mail_templates
in
lang/french/original_mail_templates
lang/french/original_mail_templates/admin/_samples/create_account_mail.txt
in
lang/french/original_mail_templates/admin/_samples/admin_create_account_mail.txt
lang/french/original_mail_templates/admin/_samples/create_account_mail.html
in
lang/french/original_mail_templates/admin/_samples/admin_create_account_mail.html
sofern vorhanden ebenfalls umbennen:¶
lang/french/original_mail_templates/admin/create_account_mail.html
in
lang/french/original_mail_templates/admin/admin_create_account_mail.html
lang/french/original_mail_templates/admin/create_account_mail.txt
in
lang/french/original_mail_templates/admin/admin_create_account_mail.txt
Folgende Dateien müssen verschoben werden:¶
_lang/french/original_mail_templates/admin _gesamter Inhalt
nach
lang/french/original_mail_templates
Die _samples-Ordner werden beim Verschieben zusammengeführt.
lang/french/original_mail_templates/_samples (gesamter Inhalt OHNE zu überschreiben)
nach
lang/french/original_mail_templates
Bereits vorhandene Dateien bleiben erhalten. Die so ggf. nicht verschobenen Dateien können gelöscht werden.
Ordner anlegen:¶
lang/french/user_mail_templates
lang/french/user_sections
Im Administrationsbereich/Gambio Admin des Shops muss nun unter dem Menüpunkt Toolbox > Cache der Button Cache für Texte leeren geklickt werden.
Anschließend sollte im Shop auf die französische Sprache gewechselt werden können, ohne dass Fehlermeldungen erscheinen.
Mit der neuen Shopversion wurden Texte verändert und hinzugefügt. Diese fehlen in zusätzlichen Sprachpaketen und müssten nachgepflegt werden.
Der Shop zeigt in diesem Fall für diese Texte den Wert aus der Standardsprache an, die im Administrationsbereich/Gambio Admin unter dem Menüpunkt Sprachen definiert ist.