WPCS - WordPress Currency Switcher Professional

Umgerechnete Preise in WordPress Currency Switcher runden: 10, 5 oder .99

Umgerechnete Preise ergeben exakte Beträge: 49 USD bei einem Kurs von 0,86 sind 42,14 EUR, und 12.500 USD bei 88,2 sind 1.102.500 INR. Um umgerechnete Preise in WordPress Currency Switcher (WPCS) auf ganze Zahlen, auf die nächsten 10 oder 1.000 oder auf Endungen wie .99 zu runden, ändern Sie entweder die Dezimalstellen der Währung oder fügen dem Filter wpcs_price ein paar Zeilen PHP hinzu. Der Filter hat eine Falle, an der die meisten Rundungs-Snippets unter PHP 8 scheitern, sobald ein Preis über 1.000 liegt. Der Code unten umgeht sie.

Weniger Dezimalstellen ohne Code

Jede Währungszeile auf dem Tab Währungen (Currencies) (Einstellungen (Settings) → Currency Switcher) hat zwei Auswahlfelder, die die Dezimalstellen steuern:

  • Cent ausblenden (Hide cents) gibt ganze Zahlen aus. Aus 42,14 wird 42 und aus 42,50 wird 43, weil das Plugin beim Weglassen der Cent kaufmännisch aufrundet.
  • Dezimalstellen: 0 (Decimals: 0) bis Dezimalstellen: 8 (Decimals: 8) legt fest, wie viele Dezimalstellen ausgegeben werden. Das funktioniert nur, solange die Zeile auf Cent anzeigen (Show cents) steht.

JPY und TWD werden unabhängig von der Einstellung der Zeile immer ohne Cent ausgegeben. Speichern Sie mit Optionen speichern (Save options) und leeren Sie Ihren Seiten-Cache.

Diese Einstellungen ändern, wie viele Ziffern angezeigt werden, nicht den Betrag selbst: Aus 42,14 können sie weder 45 noch 42,99 machen. Dafür brauchen Sie den Filter. Wie die Zahl ausgegeben wird (Trennzeichen, Position des Symbols, Währungscode), ist ein eigenes Thema und wird unter Preisformat anpassen behandelt.

Wie der Filter wpcs_price funktioniert und warum viele Snippets scheitern

Jeder von [wpcs_price] ausgegebene Preis läuft durch die Methode price() des Plugins. Sie multipliziert den Betrag in der Basiswährung mit dem Kurs, formatiert das Ergebnis mit den Dezimalstellen und Trennzeichen der Währung und wendet erst dann den Filter an:

return apply_filters('wpcs_price', $this->format_price_numeric($price, $currency));

Der Filter wpcs_price erhält also Text wie 1,234.50 oder 1.234,50, keine Zahl, und was er zurückgibt, wird unverändert ausgegeben. Daraus folgen zwei Dinge:

  • Wird $price direkt an round(), ceil() oder eine Division übergeben, funktioniert das, solange Preise unter 1.000 bleiben und einen Punkt als Dezimaltrenner verwenden, und scheitert darüber. Unter PHP 8 löst round('1,234.50', -3) einen schwerwiegenden TypeError aus, und WordPress zeigt „Es gab einen kritischen Fehler auf deiner Website“. '1,234.50' / 10 erzeugt nur eine Warnung und rechnet mit 1. Ein einzeiliges Snippet wie return round($price, -3); scheitert genau auf diese Weise, und zwar nur bei den teuren Preisen.
  • Die Rückgabe einer bloßen Zahl verwirft die Formatierung: 1000 wird als 1000 statt als 1,000.00 ausgegeben.

Der Filter läuft auch für Preise, die in der Basiswährung angezeigt werden, weil sie auf dieselbe Weise formatiert werden. Der funktionierende Ansatz: den Text mit den Trennzeichen der aktuellen Währung wieder in eine Zahl umwandeln, runden und mit $WPCS->format_price_numeric() erneut formatieren – der Methode, die das Plugin selbst verwendet.

Ein Rundungs-Snippet, das mit jedem Preis funktioniert

Fügen Sie dies in die functions.php eines Child-Themes oder in ein Code-Snippets-Plugin ein. Es legt eine Regel pro Währung fest. Die Basiswährung und Währungen ohne Regel bleiben exakt.

/*
 * WPCS: round converted prices per currency.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('wpcs_price', function ($price) {
    global $WPCS;

    // Leave prices in the base currency exactly as you typed them.
    if (empty($WPCS) || $WPCS->current_currency === $WPCS->default_currency) {
        return $price;
    }

    $currency = $WPCS->current_currency;

    // $price arrives formatted, for example "1,234.50": turn it back into a number.
    $number = str_replace($WPCS->get_thousands_separator($currency), '', $price);
    $number = (float) str_replace($WPCS->get_decimal_separator($currency), '.', $number);

    switch ($currency) {
        case 'EUR':
            $number = floor($number) + 0.99;     // 42.14 -> 42.99
            break;
        case 'INR':
            $number = ceil($number / 10) * 10;   // 4,322 -> 4,330
            break;
        case 'IDR':
            $number = round($number, -3);        // 812,611 -> 813,000
            break;
        default:
            return $price;                       // other currencies: unchanged
    }

    // Print it again with the decimals and separators of this currency.
    return $WPCS->format_price_numeric($number, $currency);
});

Ersetzen Sie die Codes und Regeln durch Ihre eigenen. Einige Details sind wichtig:

  • get_thousands_separator() und get_decimal_separator() geben die Trennzeichen aus dem Auswahlfeld Format der Währung zurück, oder die globalen, wenn es auf default steht. Das Snippet funktioniert weiter, wenn Sie das Format später ändern.
  • format_price_numeric() wendet die Einstellungen für Cent und Dezimalstellen (Decimals) der Zeile an. Eine Endung auf .99 braucht Cent anzeigen (Show cents) mit zwei Dezimalstellen. Für Regeln mit ganzen Zahlen stellen Sie die Währung auf Cent ausblenden (Hide cents), sonst wird 4,330 als 4,330.00 ausgegeben.
  • Um alle Währungen auf dieselbe Weise zu runden, ersetzen Sie den gesamten switch-Block durch eine einzige Regel, zum Beispiel $number = ceil($number / 10) * 10;.

Rundungsformeln

Setzen Sie eine dieser Zeilen anstelle einer Regel in das Snippet ein. $number ist der exakte umgerechnete Betrag.

ErgebnisBeispielCode
Auf die nächste 10 aufrunden341.20 → 350$number = ceil($number / 10) * 10;
Nächste 5511 → 510, 514 → 515$number = round($number / 5) * 5;
Nächste 1.000345,667 → 346,000$number = round($number, -3);
Nächste 0,5012.30 → 12.50$number = round($number * 2) / 2;
Endung auf .9941.20 → 41.99$number = floor($number) + 0.99;
Nächste ganze Zahl mit Endziffer 9517 → 519, 521 → 519$number = max(9, round($number / 10) * 10 - 1);

ceil() und die Regel .99 zeigen nie weniger als die exakte Umrechnung; round() geht in beide Richtungen zum nächsten Wert. Für größere Schritte ersetzen Sie 10 durch 50 oder 100. Das PHP-Handbuch beschreibt round() und sein Präzisionsargument.

Preise, die der Filter nicht rundet

  • Feste Preise. [wpcs_price type=fixed value=USD:49,EUR:45] zeigt jeden Betrag so, wie Sie ihn eingegeben haben, und überspringt den Filter; siehe feste Preise pro Währung.
  • In PHP umgerechnete Beträge. $WPCS->wpcs_exchange_value() und die Action wpcs_exchange_value formatieren das Ergebnis ohne den Filter. Verwenden Sie in Ihren eigenen Templates stattdessen $WPCS->price($amount): Es rechnet um, formatiert und führt den Filter aus, sodass Ihre Rundung greift (es gibt die Zahl ohne Währungssymbol zurück).
  • Umrechner und Kurstabelle. [wpcs_converter] und [wpcs_rates] zeigen exakte Beträge und Kurse.
  • Das Preisinfo-Symbol. Bei aktivierter Option Preisinfo-Symbol anzeigen (Show price info icon) wird die Liste der anderen Währungen unter dem Symbol berechnet, solange die Währung des Besuchers noch die aktuelle ist, sodass eine für diese Währung geschriebene Regel auf jede Zeile angewendet wird. Prüfen Sie die Liste oder schalten Sie das Symbol aus, wenn Sie pro Währung unterschiedlich runden.

Steht Ich verwende ein Cache-Plugin auf meiner Website (I am using cache plugin on my site) auf Ja (Yes), werden die Preise nach dem Laden der Seite per AJAX neu gezeichnet. Dieses Neuzeichnen nutzt dieselbe Methode price(), sodass die Rundung auch dort greift.

Das Ergebnis prüfen

Erstellen Sie eine Entwurfsseite mit diesen Zeilen und rufen Sie die Vorschau auf:

[wpcs]
[wpcs_price value=9.99]
[wpcs_price value=499]
[wpcs_price value=12500]
  • Wechseln Sie zu jeder Währung mit einer Regel. Die letzte Zeile ist die wichtigste: Sie überschreitet in jeder Währung 1.000 und deckt Code auf, der das Tausendertrennzeichen ignoriert.
  • Wechseln Sie zur Basiswährung: Die drei Beträge müssen genau so erscheinen, wie sie eingegeben wurden.
  • Ein kritischer Fehler nach dem Hinzufügen des Snippets bedeutet, dass irgendwo (Theme, Snippets-Plugin) noch ein anderes Rundungs-Snippet aktiv ist. Das PHP-Fehlerprotokoll nennt es mit round(): Argument #1 ($num) must be of type int|float, string given.
  • Leeren Sie nach jeder Änderung den Seiten-Cache und testen Sie in einem privaten Fenster, in dem Sie nicht angemeldet sind.

Wirken die Zahlen weiterhin falsch, posten Sie das verwendete Snippet und die Währungseinstellungen der betroffenen Zeile im WPCS-Support-Forum.