Plugin CURCY – WooCommerce Multi Currency – Currency Switcher - 2.4.3

CURCY – WooCommerce Multi Currency Premium ist ein Plugin von VillaTheme, das WooCommerce um die Unterstützung mehrerer Währungen erweitert. Der Kunde sieht Preise in der gewählten Währung und bezahlt auch in dieser, der Shopbetreiber verwaltet die Wechselkurse automatisch oder manuell. Das Plugin richtet sich an kleine und mittlere Shops mit internationalem Verkauf.

Währungsumschalter und Darstellungsformen der Preise

CURCY bietet den Währungsumschalter in mehreren Formen: eine Währungsleiste mit wählbarem Stil (Code, Symbol, Flagge, Flagge mit Code oder Flagge mit Symbol), den Currency Price Switcher sowie eine Reihe von Shortcodes, die den Selektor an beliebiger Stelle der Seite einfügen. Die Leiste selbst lässt sich am linken oder rechten Rand platzieren, klappt sich bei vielen Währungen ein und akzeptiert eigene Farben sowie benutzerdefinierte Währungssymbole.

Währungsleiste, Stile und Farben

Die Währungsleiste (Currencies Bar) wird im Tab Design konfiguriert. Zur Auswahl stehen fünf Darstellungsstile: nur der Währungscode (z. B. EUR), das Symbol, die Landesflagge, Flagge mit Code sowie Flagge mit Symbol.

Die Position der Leiste – linker oder rechter Bildschirmrand –, Text- und Hintergrundfarben sowie eigenes CSS erlauben es, das Element an das Theme des Shops anzupassen. Die Sichtbarkeit der Leiste auf einzelnen Seiten wird über Conditional Tags gesteuert, also bedingte WooCommerce-Tags, die die Anzeige auf ausgewählte Unterseiten beschränken.

Shortcodes für Umschalter, Kurse und Konverter

Neben der Leiste stellt CURCY eine Reihe von Shortcodes bereit, die Währungselemente unabhängig vom Page Builder einbetten. Der grundlegende [woo_multi_currency] fügt den Währungsselektor ein, [woo_multi_currency_rates] zeigt eine Tabelle der aktuellen Kurse, [woo_multi_currency_convertor] fügt einen Betragskonverter hinzu, und [woo_multi_currency_current] zeigt die aktuell gewählte Währung an. Verfügbar sind Varianten mit horizontalem und vertikalem Layout sowie Parameter für die Größe von Flagge und Symbol.

Einklappen der Leiste und eigene Währungssymbole

Bei einer großen Zahl aktiver Währungen ist die Funktion Collapse Currencies Bar hilfreich – die Leiste zeigt eine Währung an und blendet die übrigen erst beim Überfahren mit dem Mauszeiger ein.

• Über 200 Währungen – das Plugin erlaubt die Aktivierung einer beliebigen Anzahl, wobei sich ausgewählte Währungen im Frontend des Shops ausblenden lassen.
• Benutzerdefinierte Symbole – derselbe Dollar lässt sich je nach Markt als „USD”, „US$” oder „$” anzeigen.
• Eigene Flaggen – nützlich, wenn sich mehrere Länder dieselbe Währung teilen und die Standardkennzeichnung irreführend ist.

Automatische Wechselkurse, Festpreise und Preisformatierung

CURCY aktualisiert die Wechselkurse automatisch über mehrere Finanz-APIs – den VillaTheme-Server, Xe, Wise, Openexchangerates, Exchangerate API und Currencyapi – in Intervallen von 30 Minuten bis zu einem Monat. Die Kurse lassen sich auch manuell eintragen. Statt einer Umrechnung akzeptiert das Plugin auch einen Festpreis pro Währung, inklusive Massenimport aus einer CSV-Datei, während Rundungsregeln das Format des Endpreises verfeinern.

Automatische Kurs-APIs und Aktualisierungsintervalle

Die automatische Aktualisierung ruft die Kurse aus der gewählten Quelle im Zyklus von 30 Minuten, einer Stunde, 6 Stunden, einem Tag, 2 Tagen, 3 Tagen, einer Woche oder einem Monat ab. Als Quelle stehen der VillaTheme-Server, Xe, Wise (früher TransferWise), Openexchangerates, Exchangerate API oder Currencyapi zur Verfügung.

Nach jeder erfolgreichen Aktualisierung kann der Administrator eine E-Mail-Benachrichtigung erhalten. Ältere Quellen wie Google oder Yahoo Finance gelten als veraltet und sind keine zuverlässige Option mehr.

Festpreise pro Währung und CSV-Import

Fixed Price überschreibt die Kursumrechnung durch einen fest eingetragenen Preis in der jeweiligen Währung – zum Beispiel 11,99 EUR statt umgerechneter 12,37 EUR. Regulärer Preis und Aktionspreis werden für jede Währung separat festgelegt. Bei einem großen Katalog lassen sich Festpreise per CSV-Datei in großen Mengen hochladen, sodass sich Hunderte Produkte mit einem einzigen Import aktualisieren lassen, statt sie einzeln zu bearbeiten.

Wechselgebühr und „Beautify” der Endpreise

Exchange Fee schlägt auf den Kurs eine feste Marge auf, die die Kursdifferenz der Bank oder des Zahlungsanbieters ausgleicht. Price Format sorgt für das „Beautify” des Endpreises – Rundungsregeln wandeln das Umrechnungsergebnis in einen gut lesbaren Betrag um (z. B. 9,87 in 9,99), und jede Währung kann eigene Tausender- und Dezimaltrennzeichen erhalten.

Automatische Währungserkennung nach Land und Sprachzuordnung

CURCY erkennt das Land des Kunden anhand der IP-Adresse und zeigt die zugeordnete Währung an, wobei die gewählte Geolokalisierungsquelle genutzt wird – WooCommerce (ipinfo.io oder ip-api.com), geoPlugin oder MaxMind. In mehrsprachigen Shops mit WPML oder Polylang wählt das Plugin die Währung passend zur aktiven Sprache der Seite, zum Beispiel GBP in der englischen Version und EUR in der spanischen, ohne dass der Kunde manuell umschalten muss.

Ländererkennung per IP und Auswahl der Geo-API

Die Auto-Erkennung bestimmt den Standort des Besuchers auf Länderebene, nicht auf Ebene von Regionen oder Bundesstaaten innerhalb eines Landes. Die Geolokalisierungsquelle wird aus drei Optionen gewählt: die integrierte WooCommerce-Geolokalisierung (ipinfo.io oder ip-api.com), das externe geoPlugin sowie MaxMind Geolocation. Für die korrekte Funktion benötigt der Server Zugriff für ausgehende HTTP-Anfragen an diese Dienste.

Währung nach Sprache bei WPML und Polylang

In mehrsprachigen Shops verknüpft CURCY die Währung mit der aktiven Sprache der Seite. Bei WPML und Polylang – beide offiziell unterstützt – kann die englische Version standardmäßig GBP anzeigen und die spanische EUR, ohne dass der Kunde um eine Auswahl gebeten wird. Im Changelog finden sich zudem Hinweise auf eine Zusammenarbeit mit TranslatePress.

Näherungspreis und manuelle Zuordnung der Währung zum Land

Statt die Ansicht sofort auf die Währung des Kunden umzuschalten, zeigt die Option Approximate Price den Preis in der Basiswährung an und darunter einen ungefähren Betrag in der Währung des Besuchers. Die manuelle Zuordnung der Währung zum Land (Currency by Country) überschreibt die automatische Zuordnung dort, wo die Standardauswahl nicht passt. Die Funktion Change Currency Follow erzwingt einen Währungswechsel bei Änderung des Rechnungs- oder Lieferlands.

Zahlung in der gewählten Währung und Steuerung der Zahlungs-Gateways

CURCY erlaubt es dem Kunden, in der gewählten Währung zu bezahlen, sofern das Zahlungsgateway diese unterstützt – das Plugin selbst ist in erster Linie ein Umschalter und Konverter für die Anzeige, während die tatsächliche Abrechnung vom Zahlungsanbieter abhängt. In der Premium-Version lässt sich steuern, welche Gateways je nach Währung im Checkout erscheinen, es lassen sich separate Checkout-Währungen festlegen und die Bestellwährung erzwingen.

Wann der Kunde in der gewählten Währung zahlt und wann in der Basiswährung

Die Option „Allow multi currency payment” übergibt die vom Kunden gewählte Währung an den Zahlungsprozess. Unterstützt das Gateway diese Währung, zahlt der Kunde genau den angezeigten Betrag; andernfalls erfolgt die Abrechnung in der Basiswährung des Shops.

In Rezensionen gemeldete Fälle, in denen eine falsche Währung an den Anbieter übergeben wurde, liegen meist an der Konfiguration des Gateways, weshalb die Kombination aus Währung und Gateway vor dem Verkaufsstart getestet werden sollte.

Zahlungsmethoden und Checkout-Währungen pro Währung

Die Funktion Zahlungsmethoden pro Währung entscheidet, welches Gateway abhängig von der aktiven Währung im Checkout erscheint – Anbieter, die eine bestimmte Währung nicht unterstützen, werden ausgeblendet. Separat werden die zulässigen Checkout-Währungen festgelegt, sodass ein Shop Preise in vier Währungen anzeigen, aber nur in zwei Währungen Zahlungen annehmen kann. Das verringert das Risiko fehlgeschlagener Transaktionen, wenn manche Gateways nur in einer einzigen Währung funktionieren.

Erzwingen der Bestellwährung und SESSION-Modus

Force currency to checkout erzwingt nach dem Klick auf „Place order” die festgelegte Bestellwährung und synchronisiert die Währung des Warenkorbs mit der Checkout-Währung. Die Option Use SESSION speichert die gewählte Währung in der Sitzung statt in Cookies, was auf Seiten mit Cache hilft, auf denen die Währung zuvor zur Standardwährung zurückgesprungen ist. Der Währungswechsel per JavaScript funktioniert, ohne einen Parameter an die URL anzuhängen.

Für welche Shops CURCY sinnvoll ist

CURCY eignet sich am besten für kleine und mittlere WooCommerce-Shops mit internationalem Verkauf, denen an automatischer Währungserkennung, automatischen Kursen und „schönen” Festpreisen pro Markt gelegen ist, ohne ein großes Budget dafür einzuplanen. Weniger geeignet ist es dort, wo es auf echtes Settlement und Buchhaltung in der Kundenwährung oder auf Reporting nach Währungen ankommt – in solchen Fällen wird häufiger auf Aelia oder WCML verwiesen.

Internationale, mehrsprachige Shops mit marktspezifischen Preisen

Für wen CURCY am besten geeignet ist:

• Kleine und mittlere WooCommerce-Shops, die an Kunden aus verschiedenen Ländern verkaufen.
• Shops mit separaten, „schönen” Katalogpreisen pro Markt statt einer rohen Kursumrechnung.
• Mehrsprachige Shops mit WPML oder Polylang, bei denen die Währung der Sprache der Seite folgen soll.
• Shops, die Zahlungsmethoden abhängig von der Währung steuern, um nur die dafür geeigneten Gateways anzuzeigen.

Für wen CURCY nicht die beste Wahl ist (settlement, cache, analityka)

Für wen CURCY nicht die beste Wahl ist:

• Shops, die ein echtes Settlement und eine Buchhaltung in der Kundenwährung benötigen – hier sind Lösungen wie Aelia oder WCML näher am Bedarf.
• Shops, die gesetzlich verpflichtet sind, nach einem amtlichen Wechselkurs zu rechnen, z. B. dem durchschnittlichen NBP-Kurs aus Tabelle A – das Plugin verfügt über keine dokumentierte native NBP-Anbindung.
• Shops mit aggressivem Cache ohne Möglichkeit zur Konfiguration von Ausnahmen, bei denen die automatische Währungserkennung unzuverlässig sein kann.
• Shops, für die eine umfangreiche Verkaufsanalyse pro Währung das entscheidende Merkmal ist.

Anforderungen und Kompatibilität mit WooCommerce, WordPress und Cache

CURCY benötigt ein aktives WooCommerce ab Version 7.x – die Kompatibilität wurde mit den Linien 9.x und 10.x bestätigt – sowie WordPress ab Version 5.x (getestet mit 6.8 und 6.9) und PHP 7.x oder neuer. Das Plugin unterstützt HPOS, integriert sich mit Elementor und Gutenberg, arbeitet mit WPML und Polylang zusammen und bietet auf Seiten mit Cache den SESSION-Modus.

WordPress, PHP und WooCommerce — Versionen und HPOS

CURCY benötigt WooCommerce ab Version 7.x; die Kompatibilität wurde mit den Linien 9.x und 10.x bestätigt. Bei WordPress liegt die Mindestversion bei 5.x, getestet wurde mit 6.8 und 6.9. Das Plugin läuft mit PHP 7.x oder neuer, im Changelog finden sich zudem Hinweise auf Kompatibilität mit PHP 8. Die Unterstützung von HPOS (High-Performance Order Storage) wurde in Version 2.3.0 hinzugefügt und wird in den folgenden Releases beibehalten.

Page Builder, Mehrsprachigkeit und Cache

Der Währungsumschalter ist als Elementor-Widget mit Vorschau im Gutenberg-Editor verfügbar und funktioniert als Shortcode unabhängig vom Page Builder. Die Mehrsprachigkeit wird von WPML und Polylang unterstützt, mit Hinweisen auf TranslatePress. Zu den Cache-Integrationen zählen LiteSpeed, WP Rocket, WP Fastest Cache und Autoptimize.

Hinweis zum Cache: Die automatische Ländererkennung per IP kann auf Seiten mit aggressivem Cache unzuverlässig sein – in diesem Fall setzt die korrekte Funktion des Umschalters den SESSION-Modus und konfigurierte Cache-Ausnahmen voraus.

Häufig gestellte Fragen