WPCS

Der Shortcode nimmt value oder meta_value mit optionalem post_id; post_id ohne meta_value liest den Meta-Schlüssel wpcs_price. price() multipliziert nur dann mit dem Kurs, wenn die aktuelle Währung von der Basis abweicht, und reicht die Zahl dann an format_price_numeric() und den Filter wpcs_price weiter.

price_html() umhüllt das Ergebnis mit einem Span mit eindeutiger ID und data-amount, der den Basiswert enthält und den der Seiten-Cache-Modus später zum Neurendern nutzt.

Bei festen Preisen parst der Shortcode die Liste in eine Zuordnung und zeigt den Betrag für die aktuelle Währung oder 'none', wenn er fehlt. Die Liste mit dem Preis in allen Währungen nutzt dieselbe Zuordnung, statt umzurechnen.

JPY und TWD werden immer ohne Cent angezeigt; jede Währung lässt sich mit hide_cents zu dieser Liste hinzufügen. Die Einstellungen umfassen Dezimalstellen pro Währung sowie Dezimal- und Tausendertrennzeichen pro Währung. Die Wahl des Trennzeichens ist ein Index in zwei parallele Arrays, wobei Index 0 die globale Einstellung bedeutet, sodass bestehende Websites ihre Formatierung behalten.

Der Aufschlag ist ein fester Betrag, der neben dem Kurs gespeichert wird. get_currencies() addiert ihn überall zum Kurs, außer auf der Einstellungsseite des Plugins, sodass der Admin den reinen Kurs bearbeitet, während das Frontend mit dem angepassten umrechnet. Ein Filter wpcs_currency_data_manipulation läuft danach für eigene Regeln.

Die Preisinfo-Liste entfernt das Tausendertrennzeichen aus dem bereits formatierten String, normalisiert das Dezimaltrennzeichen, rechnet mit back_convert() (1/rate) auf die Basis zurück und dann vorwärts in jede andere Währung. Der Endpunkt [wpcs_converter] verwendet rate[to] / rate[from], beide relativ zur Basis, und lässt bei Währungen ohne Cent die Cent weg.

Bei einem umgerechneten Preis merkt sich der Shortcode die Währung des Besuchers, schaltet auf die angeforderte um, sofern sie konfiguriert ist, rendert und schaltet zurück, sodass der Rest der Seite die Wahl des Besuchers behält.

Das Changelog hält die Fluktuation fest: Yahoo in 1.1.1 entfernt (2017), Google in 1.1.2 entfernt (2018), beide in 1.1.3 wieder hinzugefügt (2018), nicht mehr funktionierende Quellen in 1.1.3 und 1.1.4 erneut entfernt, eigene Aggregatoren über einen Hook in 1.1.5 (2020). Jede Quelle ist eine Klasse mit getApiUrl() und parseResponse() auf einer gemeinsamen RateProvider-Basis.

get_rate_provider() ordnet den Optionswert einem Klassennamen zu; existiert keine Klasse, lässt wpcs_add_aggregator_processor eine Website ihre eigene Quelle einbinden, und wpcs_announce_aggregator fügt sie der Liste in den Einstellungen hinzu. Die Liste in den Einstellungen enthält 14 Quellen.

Die EZB veröffentlicht gegen EUR, die Nationalbank der Ukraine gegen UAH, die Magyar Nemzeti Bank gegen HUF. Jeder Provider behandelt drei Fälle: die Basis ist die Bankwährung, das Ziel ist die Bankwährung, keines von beidem. Die MNB-Quelle ist ein SOAP-Dienst mit Dezimalkommas und Notierungen pro Einheit (zum Beispiel 100 JPY), die vor der Division normalisiert werden.

get_rate() gibt den Fehlertext des Providers statt einer Zahl zurück, wenn der Kurs negativ ist. rate_auto_update() wandelt Ergebnisse in float um und ersetzt einen Kurs nur, wenn der neue Wert über null liegt, sodass eine defekte Quelle nie null oder einen Fehlertext als Kurs schreibt.

Die Einstellungen bieten stündlich, zweimal täglich, täglich, wöchentlich oder monatlich. Das Plugin registriert die zwei zusätzlichen Intervalle über cron_schedules und plant das Ereignis beim Laden mit dem gewählten Intervall, sofern es noch nicht geplant ist.

Der AJAX-Handler speichert das neue Flag is_etalon, setzt die neue Standardwährung im Speicher, fordert über den aktiven Provider einen Kurs für jede andere Währung an und gibt die Kurse an das Einstellungsformular zurück.

WPCS_World_Currencies enthält Symbol, Beschreibung, Dezimalstellen und Flaggencode pro Währung. add_currencies_ajax() fügt die gewählten hinzu, ruft für jede einen Kurs ab, registriert unbekannte Symbole als eigene Zeichen und lädt die Flagge in die Mediathek herunter, mit Rückgriff auf eine entfernte Flaggen-URL, falls der Download fehlschlägt. Der Dialog zum Massenhinzufügen wird nur im Premium-Build angezeigt.

Jeder Preis-Span trägt eine eindeutige ID und den Basisbetrag. Bei aktivierter Cache-Option sendet front.js die ID/Betrag-Paare an wpcs_get_prices_html, das die Währung des Besuchers serverseitig auflöst und eine Zuordnung von ID zu neuem HTML plus die aktuelle Währung zurückgibt; die Umschalter-Widgets werden danach darauf abgeglichen. Der Modus ist im Code von 2016 vorhanden.

Während die Umschalter-Widgets auf die zurückgegebene Währung gesetzt werden, verhindert ein Flag, dass ihre Change-Ereignisse einen weiteren Währungswechsel starten.

WPCS_STORAGE baut das Backend nach Namen aus einer abstrakten Klasse Storage. SessionStorage::create() gibt false zurück, wenn session_start() fehlschlägt, und der Wrapper fällt dann auf Transient-Speicher zurück. Jeder Wert wird beim Schreiben bereinigt.

Das Changelog nennt den Grund: IP-basierte Transients vermischen Nutzer, die sich eine Adresse teilen. CookieStorage adressiert Transients über ein UUID-Cookie. Sind die Header beim Erzeugen der ID bereits gesendet, gibt es ein Footer-Skript aus, das die ID an einen durch Nonce geprüften AJAX-Endpunkt sendet, der das Cookie aus einer sauberen Antwort setzt.

Im Standardmodus baut wpcs_redirect() die aktuelle URL neu auf und behält die anderen GET-Parameter und den #Anker. Im Modus 'No GET data in link' sendet es die Währung an wpcs_set_currency_ajax und lädt neu. In das Seitenskript ausgegebene GET-Parameter werden zuvor rekursiv bereinigt.

Beim ersten Request wird die Willkommenswährung gespeichert und das Flag gesetzt; Geo-Regeln laufen ebenfalls nur bei einem ersten eindeutigen Besuch. Wird eine gespeicherte Währung später aus der Liste entfernt, fällt get_currencies() auf die Basis zurück.

WC_Geolocation von WooCommerce steht auf einer einfachen WordPress-Website nicht zur Verfügung, daher liefert das Plugin seine eigene Länderdatenbank mit. lib/GeoIP.dat und geoip.inc sind in OpenIpCountryResolver gekapselt, mit einem Cache pro Request nach IP.

Bei der mitgelieferten Datenbank wird ein Cloudflare-Header HTTP_CF_IPCOUNTRY direkt verwendet und die Datenbanksuche übersprungen. Ein Request, dessen REMOTE_ADDR 127.0.0.1 oder ::1 ist, wird als 8.8.8.8 aufgelöst, bevor die Proxy-Header gelesen werden.

Mit einem MaxMind-Lizenzschlüssel lädt der Admin das Archiv GeoLite2-Country herunter; der Handler entpackt .tar.gz mit PharData, findet die .mmdb-Datei, kopiert sie nach uploads/currency-switcher und entfernt temporäre Dateien bei Erfolg und bei Fehler. Ohne Schlüssel bleibt das Plugin bei der mitgelieferten Datenbank. Abfragen laufen über das Composer-Paket geoip2.

init_geo_currency() ermittelt das Land, reicht es durch wpcs_geo_position, speichert es für den Besucher und wendet die erste passende Regel nur bei einem ersten Besuch an. [wpcs_check_country] gibt das erkannte Land aus, um eine Regel zu debuggen.

wpcs_get_prices_html ist für anonyme Besucher verfügbar. Es kürzt die Eingabe auf 500 Einträge, akzeptiert nur IDs, die zum von price_html() genutzten Zeichensatz von uniqid() passen, überspringt nicht skalare Preise und kodiert die Antwort mit JSON_HEX_TAG, AMP, APOS und QUOT, weil admin-ajax sie als text/html ausliefert.

price_html() schreibt Werte, die aus den Attributen von [wpcs_price] stammen, etwa den Basisbetrag oder die rohe Liste 'USD:15,EUR:20' eines festen Preises, in data-*-Attribute des Preis-Spans. Schlüssel und Werte werden maskiert und in Anführungszeichen gesetzt, sodass ein Attributwert kein Markup einschleusen kann.

wpcs_rates_current_currency reicht Besuchereingaben in do_shortcode() weiter. Nur Währungscodes, die in der Konfiguration existieren, überleben, das Ergebnis wird mit esc_attr behandelt und die Genauigkeit in int umgewandelt, sodass keine zusätzliche Shortcode-Syntax eingeschleust werden kann.

Das Formularfeld des Währungsumschalters und der Parameter ?currency= werden mit array_key_exists() gegen die konfigurierte Liste geprüft, bevor sie den Speicher erreichen, und WPCS_STORAGE::set_val() bereinigt jeden Wert.

Symbole wie руб. werden als Entities gespeichert. Das Select sendet md5(symbol), und der Speicher-Handler bildet den Hash aus der bekannten Liste auf die ursprüngliche Entity zurück, sodass die Entity weder doppelt kodiert noch aus roher Eingabe übernommen wird. Das Speichern ist durch check_admin_referer() geschützt, und position wird gegen eine feste Liste geprüft.