Sprachumschalter, Flaggenauswahl: Einrichtung und Hilfe

Laden Sie die ZIP-Datei von mprflagselector unter "Modules > Module Manager" hoch und installieren Sie sie. Öffnen Sie dann "Configure" für Flag Language Selector. Verwenden Sie bei älteren PrestaShop-Versionen die entsprechende Seite zum Hochladen von Modulen.

Erstellen und aktivieren Sie Ihre Shop-Sprachen in PrestaShop. Verwenden Sie in modernen Versionen "International > Localization > Languages". Mindestens zwei aktive Sprachen müssen dem aktuellen Shop zugewiesen sein, damit eine Auswahl erscheint. Das Modul erstellt keine Übersetzungen.

Erfordert PHP 7.1 oder neuer.

Klicken Sie auf Speichern.

Das Desktop-Dropdown verwendet displayNav2 in PrestaShop 1.7 und neuer beziehungsweise displayNav in früheren Versionen. Ein eigenes Theme muss den passenden Hook ausgeben. Zum Beispiel:

{hook h='displayNav2'}

Die mobile Auswahl verwendet einen separaten Hook. Fügen Sie ihn Ihrem mobilen Menü oder Sprachbereich hinzu, falls Ihr Theme ihn noch nicht ausgibt:

{hook h='displayMobileLanguageSelector'}

Die mobile Ausgabe ist ein Select-Element. Eine Änderung seines Werts öffnet die URL der gewählten Sprache. Das Modul registriert außerdem actionFrontControllerSetMedia für seine Assets.

Das Stylesheet blendet #_desktop_ps_languageselector aus. Prüfen Sie eigene Header auf andere native Wrapper oder doppelte Sprachblöcke.

Das Dropdown zeigt die aktiven Sprachen des aktuellen Shops. Es verwendet die von der Seite bereitgestellten Links zu anderen Sprachen, sofern vorhanden, und sonst die Sprachlinks von PrestaShop. Es behält Abfrageparameter und Fragmente bei, einschließlich des bei deaktiviertem URL-Rewriting benötigten id_lang.

Für die PrestaShop-Seiten mit Bestsellern, neuen Produkten und reduzierten Preisen kann die Auswahl die übersetzte URL der Zielsprache verwenden. In Listen mit einer kompatiblen MPR Filter Revolution-Integration kann sie den Filterpfad übersetzen. Unterstützt eine Liste MPR-Paginierungslinks, behält sie das übersetzte Seitenschlüsselwort und die Seitennummer bei beziehungsweise einen page-Abfrageparameter ohne URL-Rewriting. Diese Listenanpassungen gelten nicht für Seiten, die von Modulen bereitgestellt werden.

Ein Sprachwechsel übersetzt keine fehlenden Inhalte. Das Warenkorbverhalten folgt weiterhin dem normalen Sprachwechsel von PrestaShop.

Die mitgelieferten SVG-Flaggen befinden sich in /modules/mprflagselector/views/img/flags/. Die Zuordnung umfasst:

en: gb   cs: cz   sv: se   da: dk   el: gr
ja: jp   zh: cn   ko: kr   uk: ua

Eine Option kann auch ohne Bild erscheinen, wenn keine entsprechende SVG-Datei vorhanden ist. Das Einstellungsformular enthält keine Upload-Funktion für eigene Flaggen.

Verwenden Sie .mprflag-dropdown, .mprflag-dropdown__toggle, .mprflag-dropdown__menu, .mprflag-dropdown__option und .mprflag-dropdown__option--active im Stylesheet Ihres Themes.

.mprflag-dropdown__toggle { padding: 4px 7px; }
.mprflag-dropdown__option--active { font-weight: 600; }

Für Markup-Änderungen verwenden Sie den Theme-Override-Pfad:

themes/your-theme/modules/mprflagselector/views/templates/hook/flag-selector.tpl

1. Öffnen Sie eine übersetzte Produktseite und wechseln Sie die Sprache im Header.
2. Prüfen Sie die Zielsprache und die Zielseite.
3. Wiederholen Sie den Test auf einer Kategorie und gegebenenfalls einer gefilterten oder paginierten Liste.
4. Testen Sie die mobile Auswahl separat.
5. Testen Sie mit der tatsächlichen URL-Rewriting-Einstellung Ihres Shops.

Erscheint keine Auswahl, prüfen Sie, ob zwei Sprachen im aktuellen Shop aktiv sind und der richtige Hook ausgegeben wird. Fehlt eine Flagge, prüfen Sie den ISO-Sprachcode und die mitgelieferte SVG-Zuordnung. Führt ein Link zu einer Ausweichseite, untersuchen Sie die von PrestaShop oder dem Controller bereitgestellten URLs. Enthalten Links einen Filter- oder Seitenpfad doppelt, prüfen Sie die kompatible MPR-Listenintegration und leeren Sie nach Template-Änderungen die Theme-Caches.

Deinstallieren Sie das Modul im "Module Manager". Das Modul entfernt seine Einstellungen und sein Admin-Menü. Ihre PrestaShop-Sprachen und Übersetzungen werden weiterhin separat verwaltet. Entfernen Sie manuell hinzugefügte Hook-Aufrufe, CSS oder Template-Overrides, die nicht mehr benötigt werden.