Inhalte nach gewählter Währung in WordPress anzeigen
Um in WordPress Inhalte abhängig von der gewählten Währung anzuzeigen, etwa einen Zahlungshinweis nur für Besucher, die in US-Dollar bezahlen, einen eigenen Bestelllink für jede Währung oder einen Hinweis für alle, die nicht die Basiswährung sehen, muss Ihr Code wissen, welche Währung der Besucher gewählt hat. WPCS hält sie in einer PHP-Eigenschaft und wiederholt sie in einer Klasse am <body>-Tag und in einer JavaScript-Variable. Im Folgenden: wie Sie jede davon nutzen, wie Sie die gewählte Währung in Links übergeben und was sich ändert, wenn die Website einen Seiten-Cache verwendet.
Wo WPCS die gewählte Währung speichert
Das Plugin erstellt ein globales Objekt, $WPCS. Zwei seiner Eigenschaften sind hier wichtig:
$WPCS->current_currency: der Code der Währung, die der Besucher gerade sieht, genau so geschrieben wie im Tab Währungen (Currencies), zum BeispielUSDoderEUR.$WPCS->default_currency: die Basiswährung, also die in diesem Tab per Radiobutton ausgewählte.
Die aktuelle Währung ist die letzte Wahl des Besuchers im Währungsumschalter oder in einem Link mit ?currency=EUR, beim ersten Besuch die Willkommenswährung oder eine GeoIP-Regel. Das Plugin speichert sie pro Besucher (Option Währungsspeicherung (Currency storage): Transient, Session oder Cookie) und liest sie bei jedem Seitenaufruf. GeoIP-Regeln werden im WordPress-Hook init angewendet. Lesen Sie die Eigenschaft deshalb in einem Shortcode, einem Template oder einem Hook, der nach init läuft, nicht auf oberster Ebene der functions.php.
Derselbe Wert gelangt an zwei weiteren Stellen ins Frontend:
| Wo | Wert bei gewähltem EUR | Geeignet für |
|---|---|---|
$WPCS->current_currency in PHP | EUR | Shortcodes und Theme-Templates |
Klasse am <body>-Tag | currency-eur (Kleinbuchstaben) | Blöcke per CSS ein- und ausblenden |
JavaScript-Variable wpcs_current_currency | ein Objekt, wpcs_current_currency.name ist EUR | Eigene Skripte |
Vergleichen Sie immer die Eigenschaft, nicht das Objekt. Eine Bedingung wie if ($WPCS == 'USD') vergleicht das ganze Plugin-Objekt mit einem String und ist nie wahr, der Inhalt erscheint also nie. Richtig ist if ($WPCS->current_currency === 'USD').
Inhalte nach gewählter Währung per Shortcode anzeigen
Für einen Satz, einen Hinweis oder einen Link innerhalb einer Seite ist ein umschließender Shortcode am bequemsten: Der Redakteur setzt den Text hinein, und Besucher mit einer anderen Währung erhalten ihn gar nicht erst. Registrieren Sie ihn einmal:
/*
* Child theme functions.php or a code snippets plugin.
* [show_for_currency currency="USD"]...[/show_for_currency] only for USD
* [show_for_currency currency="USD,CAD"]...[/show_for_currency] for USD or CAD
* [show_for_currency not="USD"]...[/show_for_currency] for every currency except USD
*/
add_shortcode('show_for_currency', function ($atts, $content = '') {
global $WPCS;
if (empty($WPCS)) {
return '';
}
$atts = shortcode_atts(array('currency' => '', 'not' => ''), $atts, 'show_for_currency');
$current = strtoupper($WPCS->current_currency);
$only = array_filter(array_map('trim', explode(',', strtoupper($atts['currency']))));
$except = array_filter(array_map('trim', explode(',', strtoupper($atts['not']))));
if ($only && !in_array($current, $only, true)) {
return '';
}
if ($except && in_array($current, $except, true)) {
return '';
}
return do_shortcode((string) $content);
});
Dann verwenden Sie ihn im Inhalt:
[show_for_currency currency="USD"]American Express cards are accepted.[/show_for_currency]
[show_for_currency not="USD"]Prices in your currency are approximate. Payment is taken in US dollars.[/show_for_currency]
Darin enthaltene Shortcodes wie [wpcs_price] funktionieren weiter, weil der Inhalt durch do_shortcode() läuft. Währungscodes werden in Großbuchstaben verglichen, daher funktioniert auch currency="usd".
In einem Theme-Template verwenden Sie dieselbe Prüfung direkt:
<?php
// A template file of your child theme
global $WPCS;
if (!empty($WPCS) && $WPCS->current_currency === 'USD') : ?>
<p class="payment-note">American Express cards are accepted.</p>
<?php endif; ?>
Ganze Blöcke mit CSS-Klassen ein- oder ausblenden
Hängt eine ganze Gruppe von Blöcken, ein Abschnitt eines Page Builders oder ein Widget von der Währung ab, ist ein Shortcode als Umhüllung unpraktisch. Nutzen Sie stattdessen die Body-Klasse. WPCS fügt dem <body>-Tag über den Standardfilter body_class den Text currency- plus den Code in Kleinbuchstaben hinzu. Jedes Theme, das body_class() ausgibt, erhält so currency-usd, currency-eur und so weiter.
- Geben Sie dem Block eine Klasse: Öffnen Sie im Block-Editor die Blockeinstellungen, Erweitert (Advanced) → Zusätzliche CSS-Klasse(n) (Additional CSS class(es)), und tragen Sie
only-usd(nur für USD anzeigen) oderhide-usd(für USD ausblenden) ein. Page Builder haben dasselbe Feld, in Elementor ist es Erweitert (Advanced) → CSS-Klassen (CSS Classes). - Fügen Sie die Regeln einmalig hinzu, eine Zeile pro verwendeter Währung:
/* Appearance → Customize → Additional CSS (Styles → Additional CSS in a block theme) */
body:not(.currency-usd) .only-usd,
body:not(.currency-eur) .only-eur,
body.currency-usd .hide-usd {
display: none !important;
}
Der Unterschied zum Shortcode: Der ausgeblendete Block steht weiterhin im Seitenquelltext, er wird nur nicht angezeigt. Das genügt für Hinweise, Banner und Schaltflächen, aber nicht für alles, was privat bleiben muss, etwa einen Rabattcode für einen einzelnen Markt.
Die aktuelle Währung ausgeben: [wpcs_current_currency]
Um Besuchern zu zeigen, in welcher Währung sie die Preise sehen, hat das Plugin einen eigenen Shortcode, [wpcs_current_currency]. Standardmäßig gibt er Current currency is:, den Code und die Flagge der Währung aus. Seine Attribute:
| Attribut | Standard | Wirkung |
|---|---|---|
text | Current currency is: | Der Text vor dem Code. text="none" gibt keinen Text aus |
code | 1 | 0 blendet den Währungscode aus |
flag | 1 | 0 blendet die Flagge aus. Setzen Sie es auf 0, wenn Ihre Währungen keine Flaggenbilder haben, sonst wird ein leeres Bild ausgegeben |
currency | die gewählte Währung | Zeigt stattdessen die angegebene Währung, zum Beispiel currency="EUR". Sie muss eine Ihrer Währungen sein |
Beispiel: [wpcs_current_currency text="Prices are shown in" flag=0]. Die Ausgabe ist in <span class="wpcs_current_currency wpcs_current_currency_EUR"> eingeschlossen, die Teile liegen in .wpcs_current_currency_text, .wpcs_current_currency_code und .wpcs_current_currency_flag. So können Sie die Beschriftung pro Währung gestalten, zum Beispiel .wpcs_current_currency_EUR .wpcs_current_currency_code { color: #1e5aa8; }. Den nackten Code ohne Markup liefert So zeigen Sie den aktuellen Währungscode an.
Die gewählte Währung in Links übergeben
Jede Seitenadresse mit ?currency= und einem Code schaltet den Besucher auf diese Währung um, und das Plugin merkt sie sich, wie in Eine andere Währung auf verschiedenen Seiten beschrieben. Links zwischen Seiten Ihrer eigenen Website brauchen den Parameter nicht: Die gespeicherte Wahl gilt ohnehin überall. Sie brauchen ihn, wenn der Link diesen Speicher verlässt, etwa bei einem Buchungsformular, einer Bestellseite oder einer anderen Website, die die Währung aus der Adresse liest.
Dieser Shortcode gibt eine beliebige URL mit der Währung des Besuchers zurück, aber nur, wenn es nicht die Basiswährung ist. Links für Besucher in der Basiswährung bleiben mit der einfachen URL identisch, das hält sie cachefähig und vermeidet doppelte Adressen:
/*
* Child theme functions.php or a code snippets plugin.
* [current_currency_url url="https://booking.example.com/form/"]
* returns https://booking.example.com/form/?currency=EUR for a visitor in EUR,
* and the URL unchanged for a visitor in the base currency.
*/
add_shortcode('current_currency_url', function ($atts) {
global $WPCS;
$atts = shortcode_atts(array('url' => home_url('/')), $atts, 'current_currency_url');
$url = $atts['url'];
if (!empty($WPCS) && $WPCS->current_currency !== $WPCS->default_currency) {
$url = add_query_arg('currency', $WPCS->current_currency, $url);
}
return esc_url($url);
});
add_query_arg() fügt je nach Bedarf & oder ? hinzu und ersetzt einen vorhandenen Parameter currency. WordPress führt Shortcodes auch in HTML-Attributen in Anführungszeichen aus, der Shortcode kann also die Linkadresse in einem Custom-HTML-Block oder im klassischen Editor sein. Verwenden Sie darin einfache Anführungszeichen, weil das href doppelte verwendet:
<a class="button" href="[current_currency_url url='https://booking.example.com/form/']">Book now</a>
Linkfelder des Block-Editors und der Page Builder führen Shortcodes meist nicht aus. Verwenden Sie für diese Links die Klasse wpcs-currency-link aus dem nächsten Abschnitt.
Erwartet das Ziel statt eines Parameters currency für jede Währung andere Parameter, etwa ein Formular, das je Markt eine andere Option vorwählt, schreiben Sie pro Währung einen Link innerhalb von [show_for_currency]:
[show_for_currency currency="USD"]<a href="https://forms.example.com/order?plan=us">Order now</a>[/show_for_currency]
[show_for_currency currency="EUR,GBP"]<a href="https://forms.example.com/order?plan=eu">Order now</a>[/show_for_currency]
[show_for_currency not="USD,EUR,GBP"]<a href="https://forms.example.com/order">Order now</a>[/show_for_currency]
Seiten aus dem Cache: Inhalte im Browser umschalten
Alles, was PHP ausgibt, auch die obigen Shortcodes, wird Teil des HTML, das ein Seiten-Cache speichert. Die nächsten Besucher erhalten diese Kopie und sehen den Inhalt, der für den Besucher gewählt wurde, der den Cache gefüllt hat, unabhängig von ihrer eigenen Währung. Die Body-Klasse und die Variable wpcs_current_currency werden mit zwischengespeichert.
Es gibt zwei Auswege. Schließen Sie die Seiten mit währungsabhängigem Inhalt vom Seiten-Cache aus; dann läuft PHP für jeden Besucher, und mehr ist nicht nötig. Oder lassen Sie den Browser die Seite korrigieren. Ist Ich verwende ein Cache-Plugin auf meiner Website (I am using cache plugin on my site) unter Einstellungen (Settings) → Currency Switcher → Optionen (Options) auf Ja (Yes) gesetzt, sendet das Plugin nach jedem Seitenaufruf eine Anfrage mit action=wpcs_get_prices_html, um die Preise neu zu zeichnen, und die Antwort enthält die tatsächliche Währung des Besuchers in current_currency. Dieses Snippet lauscht auf die Antwort, setzt die Body-Klasse erneut und aktualisiert Links mit der Klasse wpcs-currency-link (am Link selbst oder an seinem Container, wie bei Button-Blöcken):
/*
* Child theme functions.php or a code snippets plugin.
* Keeps the body class currency-xxx and links with the class wpcs-currency-link
* in step with the visitor's currency, on cached pages too.
*/
add_action('wp_footer', function () {
?>
<script>
(function ($) {
function applyCurrency(code) {
if (!code) {
return;
}
code = String(code);
var body = $('body');
$.each((body.attr('class') || '').split(/\s+/), function (i, cls) {
if (cls.indexOf('currency-') === 0) {
body.removeClass(cls);
}
});
body.addClass('currency-' + code.toLowerCase());
var base = (typeof wpcs_default_currency !== 'undefined') ? wpcs_default_currency.name : '';
$('a.wpcs-currency-link, .wpcs-currency-link a').each(function () {
if (!this.getAttribute('href')) {
return;
}
var url = new URL(this.href, window.location.href);
if (code === base) {
url.searchParams.delete('currency');
} else {
url.searchParams.set('currency', code);
}
this.href = url.toString();
});
}
// the currency the page was built for
$(function () {
if (typeof wpcs_current_currency !== 'undefined' && wpcs_current_currency) {
applyCurrency(wpcs_current_currency.name);
}
});
// the visitor's real currency, from the plugin's request on cached pages
$(document).on('ajaxSuccess', function (event, xhr, settings) {
if (typeof settings.data !== 'string' || settings.data.indexOf('action=wpcs_get_prices_html') === -1) {
return;
}
try {
applyCurrency(JSON.parse(xhr.responseText).current_currency);
} catch (e) {}
});
})(jQuery);
</script>
<?php
}, 100);
Damit funktioniert die CSS-Klassen-Methode auch auf zwischengespeicherten Seiten: Die passenden Blöcke erscheinen einen Moment nach dem Laden der Seite, sobald die Antwort eintrifft. Der umschließende Shortcode lässt sich so nicht korrigieren, weil der Inhalt der anderen Währungen nie an den Browser gesendet wurde. Verwenden Sie auf zwischengespeicherten Seiten daher CSS-Klassen oder schließen Sie die Seite vom Cache aus. Das Plugin überspringt seine Anfrage bei Adressen, die bereits ?currency= enthalten; solche Adressen sind ohnehin für diese Währung erzeugt. Wenn Sie JavaScript mit einem Optimierungs-Plugin verzögern, muss das Snippet ohne Verzögerung laufen, genau wie der Währungsumschalter; die Ausnahmen finden Sie unter Währungsumschalter funktioniert nicht mit einem Cache-Plugin.
Wenn es nicht funktioniert
- Der Shortcode-Text erscheint auf der Seite. Das Snippet ist nicht aktiv, oder das Feld führt keine Shortcodes aus. Testen Sie es zuerst in einem einfachen Absatz einer Seite.
- Beim Wechsel der Währung ändert sich nichts. Öffnen Sie den Seitenquelltext und suchen Sie in der Zeile
<body class=nachcurrency-. Fehlt es, ruft das Themebody_class()nicht auf; zeigt es bei abgemeldetem Zustand die alte Währung, stammt die Seite aus einem Cache. - Bei Ihnen funktioniert es, bei Besuchern nicht. Seiten-Caches überspringen meist angemeldete Administratoren. Testen Sie in einem privaten Fenster, nachdem Sie alle Cache-Ebenen geleert haben.
- Eine PHP-Bedingung trifft nie zu. Vergleichen Sie
$WPCS->current_currency, nicht$WPCS, verwenden Sie den Code genau wie im Tab Währungen (Currencies) und führen Sie die Prüfung nachinitaus. - Der Link verliert die Währung. Prüfen Sie, dass die Währung des Besuchers nicht die Basiswährung ist:
[current_currency_url]und das Snippet lassen Links in der Basiswährung bewusst ohne den Parameter.
Folgt der Inhalt der gewählten Währung weiterhin nicht, eröffnen Sie ein Thema im WPCS-Support-Forum mit dem Link zur Seite, dem hinzugefügten Code und der Angabe, ob ein Cache- oder Optimierungs-Plugin aktiv ist.