Währungsauswahl: Einrichtung und Hilfe

Laden Sie die ZIP-Datei von mprcurrencyselector unter "Modules > Module Manager" hoch und installieren Sie sie. Öffnen Sie "Configure" für Währungssymbol-Auswahl.

Bereiten Sie mindestens zwei aktive Währungen in der PrestaShop-Währungsverwaltung vor, in modernen Versionen unter "International > Localization > Currencies". Lassen Sie den Katalogmodus beim Testen der Auswahl deaktiviert.

Erfordert PrestaShop 1.6.1 bis 9.x und PHP 7.1 oder neuer. Die Auswahl verwendet ab PrestaShop 1.7 displayNav2 und unter PrestaShop 1.6 displayNav; stellen Sie sicher, dass Ihr Theme den Hook für Ihre PrestaShop-Version ausgibt.

Das Formular Einstellungen der Währungsauswahl hat die Registerkarten Allgemein und "Theme styles". Klicken Sie nach Änderungen auf Konfiguration speichern.

Die Auswahl verwendet Ihre aktiven PrestaShop-Währungen. Erstellen und verwalten Sie Währungen in PrestaShop.

Öffnen Sie "Theme styles", um die von ThemeDetector erzeugten gemeinsamen Stiloptionen anzupassen. Die Standardwerte stammen aus den erkannten Theme-Werten. Das Modul ordnet diese Tokens zu:

Für CSS-Anpassungen im Theme verwenden Sie .mprcurrency-dropdown, .mprcurrency-dropdown__toggle, .mprcurrency-dropdown__menu und .mprcurrency-dropdown__option--active. Zum Beispiel:

.mprcurrency-dropdown__menu {
  border-radius: 8px;
}

Das Modul registriert keine Zuordnung für --mprcurrency-primary-hover.

Die geschlossene Schaltfläche zeigt das Symbol der aktuellen Währung, ersatzweise den ISO-Code, falls kein Symbol verfügbar ist. Das Dropdown hebt die aktive Währung hervor. Die Auswahl einer anderen Option sendet die native PrestaShop-Anfrage SubmitCurrency=1&id_currency=... an die Startseite des Shops. Das Modul behält die aktuelle Produkt- oder Kategorieseite in diesem erzeugten Link nicht bei.

PrestaShop verwaltet die Speicherung der Währungswahl, Wechselkurse, umgerechnete Preise, Rundung und Einschränkungen der Zahlungswährungen. Konfigurieren Sie diese separat in PrestaShop.

Die Auswahl gibt im Katalogmodus oder bei nur einer aktiven Währung kein Markup zurück. Sie wird ab PrestaShop 1.7 über displayNav2 und unter PrestaShop 1.6 über displayNav ausgegeben. Wenn Sie einen eigenen Header pflegen, geben Sie den passenden Hook an der vorgesehenen Position aus. Dieses Beispiel gilt ab PrestaShop 1.7; verwenden Sie unter PrestaShop 1.6 stattdessen displayNav:

{hook h='displayNav2'}

Das Modul registriert views/css/currency-selector.css und views/js/currency-selector.js über actionFrontControllerSetMedia. Sein CSS blendet den nativen Desktop-Wrapper #_desktop_ps_currencyselector und den PrestaShop-1.6-Wrapper #header #currencies-block-top aus. Stylesheet und JavaScript der Auswahl werden nur geladen, wenn das Modul für den aktuellen Shop und Gerätetyp im Hook für Ihre PrestaShop-Version registriert ist, der Katalogmodus ausgeschaltet ist und mehrere Währungen aktiv sind. Dadurch wird die Regel zum Ausblenden der nativen Auswahl nicht geladen, wenn diese Voraussetzungen nicht erfüllt sind. Ein eigenes Theme mit einem anderen Wrapper erfordert eigene Prüfungen der Platzierung und Darstellung.

1. Öffnen Sie eine Shop-Seite mit zwei aktiven Währungen und ausgeschaltetem Katalogmodus.
2. Prüfen Sie das aktuelle Symbol, öffnen Sie das Dropdown und wählen Sie eine andere Währung.
3. Prüfen Sie, ob sich die aktive Option ändert und PrestaShop die erwarteten Preise anzeigt.
4. Testen Sie den Header auf Desktop- und Mobilgeräten.

Fehlt die Auswahl, prüfen Sie die Anzahl aktiver Währungen, den Katalogmodus, die Hook-Platzierung und die geladenen Assets. Erscheinen beide Auswahlen, untersuchen Sie den nativen Wrapper Ihres Themes. Sind Preise oder verfügbare Währungen an der Kasse falsch, prüfen Sie die Währungs- und Zahlungseinstellungen von PrestaShop.

Deinstallieren Sie das Modul im "Module Manager". Das Modul entfernt sein Menü und seine Einstellungen und hebt die Registrierung seiner Theme-Stile auf. Schlägt die Bereinigung der Theme-Stile fehl, meldet die Deinstallation einen Fehler, bevor die restliche Moduleinrichtung entfernt wird. Beheben Sie diesen Fehler und versuchen Sie es erneut. Ihre PrestaShop-Währungen und Wechselkurse werden weiterhin von PrestaShop verwaltet. Entfernen Sie alle manuell hinzugefügten Header-Anpassungen.