WPCS

Lo shortcode accetta value, oppure meta_value con un post_id opzionale; post_id senza meta_value legge la chiave meta wpcs_price. price() moltiplica per il tasso solo quando la valuta corrente differisce dalla base, poi passa il numero a format_price_numeric() e al filtro wpcs_price.

price_html() avvolge il risultato in uno span con un ID univoco e data-amount che contiene il valore base, che la modalità cache di pagina usa poi per ridisegnarlo.

Per i prezzi fissi lo shortcode analizza l'elenco in una mappa e mostra l'importo per la valuta corrente, oppure 'none' se manca. L'elenco del prezzo in tutte le valute usa la stessa mappa invece di convertire.

JPY e TWD sono sempre mostrati senza centesimi; qualsiasi valuta può essere aggiunta a quell'elenco con hide_cents. Le impostazioni includono decimali per valuta e separatori decimali e delle migliaia per valuta. La scelta del separatore è un indice in due array paralleli, dove l'indice 0 significa l'impostazione globale, così i siti esistenti mantengono la loro formattazione.

L'interest è un importo fisso salvato accanto al tasso. get_currencies() lo aggiunge al tasso ovunque tranne che nella pagina delle impostazioni del plugin, così l'amministratore modifica il tasso pulito mentre il front end converte con quello rettificato. Un filtro wpcs_currency_data_manipulation viene eseguito dopo per regole personalizzate.

L'elenco delle informazioni sul prezzo toglie il separatore delle migliaia dalla stringa già formattata, normalizza il separatore decimale, riconverte alla base con back_convert() (1/rate) e poi converte in avanti in ogni altra valuta. L'endpoint [wpcs_converter] usa rate[to] / rate[from], entrambi rispetto alla base, ed elimina i centesimi per le valute senza centesimi.

Per un prezzo convertito lo shortcode ricorda la valuta del visitatore, passa a quella richiesta se è configurata, renderizza e torna indietro, così il resto della pagina mantiene la scelta del visitatore.

Il changelog registra il via vai: Yahoo rimosso nella 1.1.1 (2017), Google rimosso nella 1.1.2 (2018), entrambi reinseriti nella 1.1.3 (2018), le fonti che avevano smesso di funzionare rimosse di nuovo nella 1.1.3 e nella 1.1.4, aggregatori personalizzati tramite un hook nella 1.1.5 (2020). Ogni fonte è una classe con getApiUrl() e parseResponse() su una base condivisa RateProvider.

get_rate_provider() associa il valore dell'opzione a un nome di classe; se non esiste alcuna classe, wpcs_add_aggregator_processor permette a un sito di collegare la propria fonte, e wpcs_announce_aggregator la aggiunge all'elenco delle impostazioni. L'elenco delle impostazioni ha 14 fonti.

La BCE pubblica rispetto a EUR, la Banca nazionale d'Ucraina rispetto a UAH, la Magyar Nemzeti Bank rispetto a HUF. Ogni provider gestisce tre casi: la base è la valuta della banca, la destinazione è la valuta della banca, nessuna delle due. La fonte MNB è un servizio SOAP con decimali a virgola e quotazioni per unità (per esempio 100 JPY), normalizzate prima della divisione.

get_rate() restituisce il testo di errore del provider invece di un numero quando il tasso è negativo. rate_auto_update() converte i risultati in float e sostituisce un tasso solo quando il nuovo valore è superiore a zero, così una fonte difettosa non scrive mai zero né un testo di errore come tasso.

Le impostazioni offrono ogni ora, due volte al giorno, ogni giorno, ogni settimana o ogni mese. Il plugin registra i due intervalli aggiuntivi tramite cron_schedules e pianifica l'evento con l'intervallo selezionato al caricamento quando non è ancora pianificato.

Il gestore AJAX salva il nuovo flag is_etalon, imposta in memoria la nuova valuta predefinita, richiede un tasso per ogni altra valuta tramite il provider attivo e restituisce i tassi al modulo delle impostazioni.

WPCS_World_Currencies contiene simbolo, descrizione, decimali e codice della bandiera per ogni valuta. add_currencies_ajax() aggiunge quelle selezionate, recupera un tasso per ciascuna, registra i simboli sconosciuti come segni personalizzati e scarica la bandiera nella libreria multimediale, ripiegando su un URL remoto della bandiera se il download fallisce. La finestra di aggiunta di massa è mostrata solo nella versione premium.

Ogni span del prezzo porta un ID univoco e l'importo base. Con l'opzione cache attiva, front.js invia le coppie id/importo a wpcs_get_prices_html, che risolve lato server la valuta del visitatore e restituisce una mappa da id a nuovo HTML più la valuta corrente; i widget del selettore vengono poi sincronizzati con essa. La modalità è presente nel codice del 2016.

Mentre i widget del selettore vengono impostati sulla valuta restituita, un flag impedisce che i loro eventi di cambio avviino un altro cambio di valuta.

WPCS_STORAGE costruisce il backend per nome da una classe astratta Storage. SessionStorage::create() restituisce false quando session_start() fallisce, e il wrapper ripiega allora sull'archiviazione in transient. Ogni valore viene sanificato in scrittura.

Il changelog ne indica il motivo: i transient con chiave IP mescolano gli utenti che condividono un indirizzo. CookieStorage usa come chiave dei transient un cookie UUID. Se gli header sono già stati inviati quando l'ID viene creato, stampa uno script nel footer che invia l'ID a un endpoint AJAX protetto da nonce, che imposta il cookie da una risposta pulita.

Nella modalità predefinita wpcs_redirect() ricostruisce l'URL corrente mantenendo gli altri parametri GET e l'#ancora. Nella modalità 'No GET data in link' invia la valuta a wpcs_set_currency_ajax e ricarica. I parametri GET riportati nello script della pagina vengono prima sanificati ricorsivamente.

Alla prima richiesta la valuta di benvenuto viene salvata e il flag impostato; anche le regole geografiche vengono eseguite solo per una prima visita unica. Se una valuta salvata viene poi rimossa dall'elenco, get_currencies() ripiega sulla base.

WC_Geolocation di WooCommerce non è disponibile su un semplice sito WordPress, perciò il plugin include un proprio database dei paesi. lib/GeoIP.dat e geoip.inc sono incapsulati in OpenIpCountryResolver con una cache per richiesta per IP.

Con il database incluso, un header Cloudflare HTTP_CF_IPCOUNTRY viene usato direttamente e la ricerca nel database viene saltata. Una richiesta il cui REMOTE_ADDR è 127.0.0.1 o ::1 viene risolta come 8.8.8.8 prima che gli header del proxy siano letti.

Con una chiave di licenza MaxMind l'amministratore scarica l'archivio GeoLite2-Country; il gestore decomprime il .tar.gz con PharData, trova il file .mmdb, lo copia in uploads/currency-switcher e rimuove i file temporanei sia in caso di successo sia di errore. Senza una chiave il plugin resta sul database incluso. Le ricerche passano per il pacchetto Composer geoip2.

init_geo_currency() risolve il paese, lo fa passare per wpcs_geo_position, lo salva per il visitatore e applica la prima regola corrispondente solo alla prima visita. [wpcs_check_country] stampa il paese rilevato per fare il debug di una regola.

wpcs_get_prices_html è disponibile ai visitatori anonimi. Taglia l'input a 500 voci, accetta solo id che corrispondono al set di caratteri di uniqid() usato da price_html(), salta i prezzi non scalari e codifica la risposta con JSON_HEX_TAG, AMP, APOS e QUOT perché admin-ajax la serve come text/html.

price_html() scrive nei data-* dello span del prezzo i valori che provengono dagli attributi di [wpcs_price], come l'importo base o l'elenco grezzo 'USD:15,EUR:20' di un prezzo fisso. Chiavi e valori sono sottoposti a escape e racchiusi tra virgolette, così il valore di un attributo non può iniettare markup.

wpcs_rates_current_currency passa l'input del visitatore a do_shortcode(). Sopravvivono solo i codici valuta presenti nella configurazione, il risultato passa per esc_attr e la precisione viene convertita in int, così non può essere iniettata alcuna sintassi di shortcode aggiuntiva.

Il campo del modulo del selettore di valuta e il parametro ?currency= vengono controllati con array_key_exists() rispetto all'elenco configurato prima di raggiungere l'archivio, e WPCS_STORAGE::set_val() sanifica ogni valore.

Simboli come руб. sono salvati come entità. La select invia md5(symbol), e il gestore del salvataggio riassocia l'hash all'entità originale dall'elenco noto, così l'entità non viene né codificata due volte né presa dall'input grezzo. Il salvataggio è protetto da check_admin_referer(), e position viene verificata rispetto a un elenco fisso.