WPCS

Shortcode przyjmuje value albo meta_value z opcjonalnym post_id; post_id bez meta_value czyta klucz meta wpcs_price. price() mnoży przez kurs tylko wtedy, gdy bieżąca waluta różni się od bazowej, a następnie przekazuje liczbę do format_price_numeric() i filtra wpcs_price.

price_html() opakowuje wynik w span z unikalnym ID i data-amount zawierającym wartość bazową, której tryb cache strony używa później do ponownego renderowania.

Dla cen stałych shortcode parsuje listę do mapy i pokazuje kwotę dla bieżącej waluty albo 'none', jeśli jej brakuje. Lista ceny we wszystkich walutach używa tej samej mapy zamiast przeliczać.

JPY i TWD są zawsze pokazywane bez groszy/centów; do tej listy można dodać dowolną walutę przez hide_cents. Ustawienia obejmują miejsca dziesiętne dla każdej waluty oraz separatory dziesiętny i tysięcy dla każdej waluty. Wybór separatora jest indeksem w dwóch równoległych tablicach, gdzie indeks 0 oznacza ustawienie globalne, dzięki czemu istniejące witryny zachowują swoje formatowanie.

Interest to stała kwota zapisana obok kursu. get_currencies() dodaje ją do kursu wszędzie poza stroną ustawień wtyczki, więc administrator edytuje czysty kurs, a front przelicza po kursie skorygowanym. Filtr wpcs_currency_data_manipulation działa potem dla własnych reguł.

Lista informacji o cenie usuwa separator tysięcy z już sformatowanego ciągu, normalizuje separator dziesiętny, przelicza z powrotem na bazową przez back_convert() (1/rate), a następnie w przód na każdą inną walutę. Endpoint [wpcs_converter] używa rate[to] / rate[from], oba względem bazowej, i pomija grosze/centy dla walut ich nie mających.

Dla przeliczonej ceny shortcode zapamiętuje walutę odwiedzającego, przełącza na żądaną, jeśli jest skonfigurowana, renderuje i przełącza z powrotem, żeby reszta strony zachowała wybór odwiedzającego.

Changelog śledzi te zmiany: Yahoo usunięte w 1.1.1 (2017), Google usunięte w 1.1.2 (2018), oba dodane z powrotem w 1.1.3 (2018), źródła, które przestały działać, usunięte ponownie w 1.1.3 i 1.1.4, własne agregatory przez hook w 1.1.5 (2020). Każde źródło jest klasą z getApiUrl() i parseResponse() na wspólnej bazie RateProvider.

get_rate_provider() mapuje wartość opcji na nazwę klasy; jeśli klasa nie istnieje, wpcs_add_aggregator_processor pozwala witrynie podpiąć własne źródło, a wpcs_announce_aggregator dodaje je do listy w ustawieniach. Lista w ustawieniach ma 14 źródeł.

ECB publikuje względem EUR, Narodowy Bank Ukrainy względem UAH, Magyar Nemzeti Bank względem HUF. Każdy dostawca obsługuje trzy przypadki: bazą jest waluta banku, celem jest waluta banku, żadne z nich. Źródło MNB to usługa SOAP z przecinkami dziesiętnymi i notowaniami za jednostki (na przykład 100 JPY), normalizowanymi przed dzieleniem.

get_rate() zwraca tekst błędu dostawcy zamiast liczby, gdy kurs jest ujemny. rate_auto_update() rzutuje wyniki na float i zastępuje kurs tylko wtedy, gdy nowa wartość jest większa od zera, więc zepsute źródło nigdy nie zapisuje zera ani tekstu błędu jako kursu.

Ustawienia oferują co godzinę, dwa razy dziennie, codziennie, co tydzień lub co miesiąc. Wtyczka rejestruje dwa dodatkowe interwały przez cron_schedules i przy załadowaniu planuje zdarzenie z wybranym interwałem, jeśli nie jest jeszcze zaplanowane.

Handler AJAX zapisuje nową flagę is_etalon, ustawia nową walutę domyślną w pamięci, żąda kursu dla każdej innej waluty przez aktywnego dostawcę i zwraca kursy do formularza ustawień.

WPCS_World_Currencies przechowuje symbol, opis, miejsca dziesiętne i kod flagi dla każdej waluty. add_currencies_ajax() dodaje wybrane, pobiera kurs dla każdej, rejestruje nieznane symbole jako własne znaki i pobiera flagę do biblioteki mediów, wracając do zdalnego URL flagi, jeśli pobranie się nie powiedzie. Okno dodawania zbiorczego jest pokazywane tylko w wersji premium.

Każdy span ceny niesie unikalne ID i kwotę bazową. Przy włączonej opcji cache front.js wysyła pary id/kwota do wpcs_get_prices_html, które ustala walutę odwiedzającego po stronie serwera i zwraca mapę ID na nowy HTML oraz bieżącą walutę; widżety przełącznika są następnie z nią synchronizowane. Ten tryb jest obecny w kodzie z 2016 roku.

Gdy widżety przełącznika są ustawiane na zwróconą walutę, flaga powstrzymuje ich zdarzenia change przed wywołaniem kolejnego przełączenia waluty.

WPCS_STORAGE buduje backend po nazwie z abstrakcyjnej klasy Storage. SessionStorage::create() zwraca false, gdy session_start() się nie powiedzie, a wrapper wraca wtedy do magazynu transient. Każda wartość jest sanityzowana przy zapisie.

Changelog podaje powód: transients kluczowane po IP mieszają użytkowników dzielących adres. CookieStorage kluczuje transients po UUID z cookie. Jeśli nagłówki zostały już wysłane w chwili tworzenia ID, wypisuje skrypt w stopce, który wysyła ID do endpointu AJAX sprawdzanego przez nonce, a ten ustawia cookie z czystej odpowiedzi.

W trybie domyślnym wpcs_redirect() odbudowuje bieżący URL, zachowując inne parametry GET i #anchor. W trybie 'No GET data in link' wysyła walutę do wpcs_set_currency_ajax i przeładowuje stronę. Parametry GET wypisywane do skryptu strony są najpierw rekurencyjnie sanityzowane.

Przy pierwszym żądaniu waluta powitalna jest zapisywana i ustawiana jest flaga; reguły geo również działają tylko przy pierwszej unikalnej wizycie. Jeśli zapisana waluta zostanie później usunięta z listy, get_currencies() wraca do bazowej.

WC_Geolocation z WooCommerce nie jest dostępne na zwykłej witrynie WordPress, więc wtyczka dostarcza własną bazę krajów. lib/GeoIP.dat i geoip.inc są opakowane w OpenIpCountryResolver z cache dla każdego IP w obrębie żądania.

Z dołączoną bazą nagłówek Cloudflare HTTP_CF_IPCOUNTRY jest używany bezpośrednio, a wyszukiwanie w bazie jest pomijane. Żądanie, którego REMOTE_ADDR to 127.0.0.1 lub ::1, jest rozpoznawane jako 8.8.8.8, zanim zostaną odczytane nagłówki proxy.

Z kluczem licencyjnym MaxMind administrator pobiera archiwum GeoLite2-Country; handler rozpakowuje .tar.gz przez PharData, znajduje plik .mmdb, kopiuje go do uploads/currency-switcher i usuwa pliki tymczasowe przy sukcesie i przy błędzie. Bez klucza wtyczka pozostaje na dołączonej bazie. Wyszukiwanie odbywa się przez pakiet Composer geoip2.

init_geo_currency() ustala kraj, przepuszcza go przez wpcs_geo_position, zapisuje dla odwiedzającego i stosuje pierwszą pasującą regułę tylko przy pierwszej wizycie. [wpcs_check_country] wypisuje wykryty kraj do debugowania reguły.

wpcs_get_prices_html jest dostępne dla anonimowych odwiedzających. Przycina dane wejściowe do 500 wpisów, akceptuje tylko ID zgodne ze zbiorem znaków uniqid() używanym przez price_html(), pomija ceny nieskalarne i koduje odpowiedź flagami JSON_HEX_TAG, AMP, APOS i QUOT, ponieważ admin-ajax serwuje ją jako text/html.

price_html() zapisuje wartości pochodzące z atrybutów [wpcs_price], takie jak kwota bazowa albo surowa lista 'USD:15,EUR:20' ceny stałej, w atrybutach data-* spanu ceny. Klucze i wartości są escapowane i ujęte w cudzysłów, więc wartość atrybutu nie może wstrzyknąć znaczników.

wpcs_rates_current_currency przekazuje dane odwiedzającego do do_shortcode(). Przetrwają tylko kody walut istniejące w konfiguracji, wynik przechodzi przez esc_attr, a precyzja jest rzutowana na int, więc nie da się wstrzyknąć dodatkowej składni shortcode.

Pole formularza przełącznika walut i parametr ?currency= są sprawdzane przez array_key_exists() względem skonfigurowanej listy, zanim trafią do magazynu, a WPCS_STORAGE::set_val() sanityzuje każdą wartość.

Symbole takie jak руб. są zapisywane jako encje. Pole select wysyła md5(symbol), a handler zapisu mapuje hasz z powrotem na oryginalną encję ze znanej listy, więc encja nie jest ani podwójnie kodowana, ani brana z surowych danych wejściowych. Zapis jest chroniony przez check_admin_referer(), a position jest sprawdzane względem stałej listy.