WPCS

Le shortcode accepte value, ou meta_value avec un post_id facultatif ; post_id sans meta_value lit la clé meta wpcs_price. price() ne multiplie par le taux que si la devise courante diffère de la devise de base, puis transmet le nombre à format_price_numeric() et au filtre wpcs_price.

price_html() enveloppe le résultat dans un span avec un ID unique et data-amount contenant la valeur de base, que le mode cache de page utilise plus tard pour le rendre à nouveau.

Pour les prix fixes, le shortcode analyse la liste en une table et affiche le montant de la devise courante, ou 'none' s'il est absent. La liste des prix dans toutes les devises utilise la même table au lieu de convertir.

JPY et TWD sont toujours affichés sans centimes ; n'importe quelle devise peut être ajoutée à cette liste avec hide_cents. Les réglages comprennent les décimales par devise ainsi que les séparateurs décimal et des milliers par devise. Le choix du séparateur est un index dans deux tableaux parallèles, où l'index 0 signifie le réglage global, de sorte que les sites existants gardent leur formatage.

L'intérêt est un montant fixe stocké à côté du taux. get_currencies() l'ajoute au taux partout sauf sur la page de réglages de l'extension, si bien que l'administrateur modifie le taux brut tandis que le front office convertit avec le taux ajusté. Un filtre wpcs_currency_data_manipulation s'exécute ensuite pour les règles personnalisées.

La liste d'informations de prix retire le séparateur des milliers de la chaîne déjà formatée, normalise le séparateur décimal, reconvertit en base avec back_convert() (1/rate) puis convertit vers chacune des autres devises. Le point d'accès [wpcs_converter] utilise rate[to] / rate[from], tous deux relatifs à la base, et supprime les centimes pour les devises sans centimes.

Pour un prix converti, le shortcode mémorise la devise du visiteur, bascule sur la devise demandée si elle est configurée, effectue le rendu, puis rebascule pour que le reste de la page garde le choix du visiteur.

Le changelog garde la trace de ces mouvements : Yahoo retiré en 1.1.1 (2017), Google retiré en 1.1.2 (2018), les deux rajoutés en 1.1.3 (2018), sources qui ont cessé de fonctionner retirées à nouveau en 1.1.3 et 1.1.4, agrégateurs personnalisés via un hook en 1.1.5 (2020). Chaque source est une classe avec getApiUrl() et parseResponse() sur une base commune RateProvider.

get_rate_provider() associe la valeur de l'option à un nom de classe ; si aucune classe n'existe, wpcs_add_aggregator_processor permet à un site de brancher sa propre source, et wpcs_announce_aggregator l'ajoute à la liste des réglages. La liste des réglages compte 14 sources.

La BCE publie par rapport à l'EUR, la Banque nationale d'Ukraine par rapport à l'UAH, la Magyar Nemzeti Bank par rapport au HUF. Chaque fournisseur gère trois cas : la base est la devise de la banque, la cible est la devise de la banque, aucune des deux. La source MNB est un service SOAP avec des décimales à virgule et des cotations par unités (par exemple 100 JPY), normalisées avant la division.

get_rate() renvoie le texte d'erreur du fournisseur au lieu d'un nombre lorsque le taux est négatif. rate_auto_update() convertit les résultats en float et ne remplace un taux que lorsque la nouvelle valeur est supérieure à zéro, si bien qu'une source défaillante n'écrit jamais zéro ni un texte d'erreur comme taux.

Les réglages proposent toutes les heures, deux fois par jour, tous les jours, toutes les semaines ou tous les mois. L'extension enregistre les deux intervalles supplémentaires via cron_schedules et planifie l'événement avec l'intervalle sélectionné au chargement lorsqu'il n'est pas encore planifié.

Le gestionnaire AJAX enregistre le nouvel indicateur is_etalon, définit en mémoire la nouvelle devise par défaut, demande un taux pour chaque autre devise via le fournisseur actif et renvoie les taux au formulaire de réglages.

WPCS_World_Currencies contient le symbole, la description, les décimales et le code du drapeau de chaque devise. add_currencies_ajax() ajoute celles qui sont sélectionnées, récupère un taux pour chacune, enregistre les symboles inconnus comme signes personnalisés et télécharge le drapeau dans la médiathèque, avec repli sur une URL de drapeau distante si le téléchargement échoue. La boîte de dialogue d'ajout en masse n'est affichée que dans la version premium.

Chaque span de prix porte un ID unique et le montant de base. Avec l'option cache activée, front.js envoie les paires id/montant à wpcs_get_prices_html, qui résout la devise du visiteur côté serveur et renvoie une table d'ID vers le nouveau HTML ainsi que la devise courante ; les widgets de sélection sont ensuite synchronisés avec elle. Ce mode est présent dans le code de 2016.

Pendant que les widgets de sélection sont réglés sur la devise renvoyée, un indicateur empêche leurs événements de changement de lancer un autre changement de devise.

WPCS_STORAGE construit le backend par son nom à partir d'une classe abstraite Storage. SessionStorage::create() renvoie false lorsque session_start() échoue, et l'enveloppe se rabat alors sur le stockage par transient. Chaque valeur est assainie à l'écriture.

Le changelog en donne la raison : les transients indexés par IP mélangent les utilisateurs qui partagent une adresse. CookieStorage indexe les transients par un cookie UUID. Si les en-têtes sont déjà envoyés quand l'ID est créé, il affiche un script de pied de page qui envoie l'ID à un point d'accès AJAX protégé par nonce, lequel définit le cookie à partir d'une réponse propre.

Dans le mode par défaut, wpcs_redirect() reconstruit l'URL courante en gardant les autres paramètres GET et l'ancre #. Dans le mode « No GET data in link », elle envoie la devise à wpcs_set_currency_ajax et recharge. Les paramètres GET repris dans le script de la page sont d'abord assainis de façon récursive.

À la première requête, la devise de bienvenue est stockée et l'indicateur est posé ; les règles géographiques ne s'exécutent aussi que pour une première visite unique. Si une devise stockée est retirée plus tard de la liste, get_currencies() se rabat sur la devise de base.

WC_Geolocation de WooCommerce n'est pas disponible sur un WordPress ordinaire ; l'extension embarque donc sa propre base de pays. lib/GeoIP.dat et geoip.inc sont enveloppés dans OpenIpCountryResolver avec un cache par requête indexé par IP.

Avec la base intégrée, un en-tête Cloudflare HTTP_CF_IPCOUNTRY est utilisé directement et la recherche dans la base est ignorée. Une requête dont REMOTE_ADDR est 127.0.0.1 ou ::1 est résolue comme 8.8.8.8 avant la lecture des en-têtes de proxy.

Avec une clé de licence MaxMind, l'administrateur télécharge l'archive GeoLite2-Country ; le gestionnaire décompresse le .tar.gz avec PharData, trouve le fichier .mmdb, le copie dans uploads/currency-switcher et supprime les fichiers temporaires en cas de succès comme d'erreur. Sans clé, l'extension reste sur la base intégrée. Les recherches passent par le paquet Composer geoip2.

init_geo_currency() résout le pays, le fait passer par wpcs_geo_position, le stocke pour le visiteur et applique la première règle correspondante lors d'une première visite seulement. [wpcs_check_country] affiche le pays détecté pour déboguer une règle.

wpcs_get_prices_html est accessible aux visiteurs anonymes. Il découpe l'entrée à 500 éléments, n'accepte que les ID qui correspondent au jeu de caractères de uniqid() utilisé par price_html(), ignore les prix non scalaires, et encode la réponse avec JSON_HEX_TAG, AMP, APOS et QUOT car admin-ajax la sert en text/html.

price_html() écrit dans des attributs data-* du span de prix des valeurs issues des attributs de [wpcs_price], comme le montant de base ou la liste brute 'USD:15,EUR:20' d'un prix fixe. Les clés et les valeurs sont échappées et entre guillemets, de sorte qu'une valeur d'attribut ne peut pas injecter de balisage.

wpcs_rates_current_currency transmet une entrée de visiteur à do_shortcode(). Seuls survivent les codes de devise présents dans la configuration, le résultat passe par esc_attr, et la précision est convertie en entier, de sorte qu'aucune syntaxe de shortcode supplémentaire ne peut être injectée.

Le champ du formulaire de sélection de devise et le paramètre ?currency= sont vérifiés avec array_key_exists() par rapport à la liste configurée avant d'atteindre le stockage, et WPCS_STORAGE::set_val() assainit chaque valeur.

Des symboles tels que руб. sont stockés comme entités. Le select envoie md5(symbole), et le gestionnaire d'enregistrement associe le hachage à l'entité d'origine de la liste connue, si bien que l'entité n'est ni encodée deux fois ni prise dans une entrée brute. L'enregistrement est protégé par check_admin_referer(), et la position est vérifiée par rapport à une liste fixe.