CODEX
Shortcodes, Hooks & Functions
Référence complète de FOX – WooCommerce Currency Switcher
- SC [[woocs]] Le shortcode principal de changement de devise : place la liste déroulante, les drapeaux ou la liste de liens sur n'importe quelle page, widget ou modèle. Les attributs contrôlent l'affichage, le style et les devises qui apparaissent. →
- SC [[woocs_converter]] Ajoute un convertisseur de devises WooCommerce à n'importe quelle page — un petit calculateur AJAX qui convertit un montant entre deux devises sans modifier vos prix de produits. Attributs : exclude, precision. →
- SC [[woocs_geo_hello]] Shortcode de diagnostic pour Geo IP. Placez-le sur une page ou dans un widget pour voir si la géolocalisation fonctionne, quel pays a été détecté et à quelle devise les règles ont abouti. →
- SC [[woocs_get_sign_rate]] Affiche le taux de change actuel d'une devise par rapport à la devise de base de la boutique sous forme de texte brut, n'importe où dans votre contenu. →
- SC [[woocs_price]] Affiche le prix d'un seul produit par son ID, dans la devise choisie par le visiteur — pour les pages de destination et les textes rédigés en dehors de la boucle WooCommerce. →
- SC [[woocs_rates]] Affiche les taux de change de votre boutique aux clients sous forme de tableau. Les attributs vous permettent d'exclure des devises et de modifier la mise en page. →
- SC [[woocs_show_current_currency]] Affiche la devise dans laquelle le visiteur navigue actuellement, avec un texte facultatif avant et après. →
- SC [[woocs_show_custom_price]] Rend tout montant dans votre texte promotionnel basculable. Saisissez la valeur dans la devise de base et elle suit la devise que le visiteur choisit. →
- do_action woocs_before_settings_update Action déclenchée dans wp-admin juste après la vérification du nonce et juste avant que FOX écrive ses options depuis le formulaire soumis. Utilisez-la pour enregistrer des champs supplémentaires ajoutés à la page de réglages du plugin. →
- do_action woocs_exchange_value Point d'entrée dans le plugin : transmettez n'importe quel montant dans la devise de base via cette action et récupérez-le dans la devise sélectionnée par le visiteur. La méthode courante pour rendre vos propres nombres interchangeables. →
- do_action woocs_force_pay_bygeoip_rules Se déclenche sur la page de paiement lorsque « Checkout by GeoIP rules » est activé, vous permettant de spécifier dans quelle devise la commande est forcée pour un pays donné. →
- do_action woocs_freemius_loaded Action déclenchée une fois que le SDK Freemius a été initialisé, le point sûr où l'API de licence est disponible. →
- do_action woocs_sheduler_rates_updated Se déclenche après la fin de la mise à jour planifiée des taux de change. Utilisez-le pour enregistrer l'historique des taux, notifier un système externe ou recalculer quelque chose qui dépend des nouveaux taux. À partir de v.2.4.5 / 1.4.5. →
- do_action woocs_update_rates_wpcron L'événement planifié auquel FOX attache son rafraîchissement des taux. Le déclencher exécute une mise à jour complète des taux de change immédiatement, ce qui permet de piloter les mises à jour depuis un vrai cron serveur au lieu du cron WordPress. →
- apply_filters woocs_add_aggregator_processor Enregistre le code qui récupère les taux depuis votre propre source de taux de change. Fonctionne de paire avec woocs_announce_aggregator. À partir de v.2.3.1 / 1.3.1. →
- apply_filters woocs_add_custom_rate Modifie un taux de devise à la volée, ou remplace entièrement la récupération des taux par votre propre logique. À partir de v.2.3.1 / 1.3.1. →
- apply_filters woocs_announce_aggregator Ajoute votre propre agrégateur à la liste que le propriétaire de la boutique peut choisir dans les réglages. Fonctionne de paire avec woocs_add_aggregator_processor. À partir de v.2.3.1 / 1.3.1. →
- apply_filters woocs_back_convert_price Point d'entrée dans le plugin : convertit un montant de la devise actuellement sélectionnée vers la devise de base de la boutique. La solution pour les règles tierces qui comparent des totaux convertis à des seuils en devise de base. →
- apply_filters woocs_bank_polski_table Sélectionne la table de taux de l'agrégateur Narodowy Bank Polski à lire. Par défaut, la table A. À partir de v.2.3.1 / 1.3.1. →
- apply_filters woocs_capability_allows_change_order Permet à certains utilisateurs de modifier les données de devise des commandes sans leur accorder la capacité manage_options complète. →
- apply_filters woocs_convert_price Point d'entrée dans le plugin : convertit un montant de la devise de base vers la devise actuellement sélectionnée. La méthode standard pour qu'un plugin tiers prenne en compte les devises sans dépendre fortement de FOX. →
- apply_filters woocs_convert_price_wcdp Point d'entrée dans le plugin pour les moteurs de réduction : convertit un montant de la devise de base vers la devise actuelle, mais seulement lorsque le troisième argument est discount__amount. →
- apply_filters woocs_cookie Filtre modifiant le nom du cookie de session FOX. Le renommer empêche les caches qui traitent tout cookie préfixé par wp_ comme un utilisateur connecté de contourner le cache. Doit être enregistré depuis mu-plugins. →
- apply_filters woocs_currency_data_manipulation Filtre l'ensemble du tableau des devises avant que le plugin ne l'utilise — taux, symboles, décimales et positions — afin que les données de devises puissent provenir de n'importe où. →
- apply_filters woocs_currency_manipulation_before_show Filtre la liste des devises juste avant que le sélecteur ne soit affiché, afin que vous puissiez masquer, réorganiser ou renommer les devises par page, par utilisateur ou selon n'importe quelle règle. →
- apply_filters woocs_currency_symbol_on_order Filtre qui indique à FOX de laisser le symbole de la devise intact sur les pages de confirmation de commande et de compte, afin qu'un reçu conserve le symbole de la devise dans laquelle la commande a été payée. Par défaut false. →
- apply_filters woocs_currency_symbols Ajoute ou remplace les symboles de devises. Le crochet à utiliser pour un symbole de devise personnalisé dans WooCommerce, ou pour une devise qui n'a pas du tout de glyphe standard. →
- apply_filters woocs_currname_in_option Modifie le texte d'une ligne de devise dans le menu déroulant du sélecteur, lorsque le code et le symbole par défaut ne sont pas ce que vos clients doivent lire. →
- apply_filters woocs_cut_cart_price_format Supprime le format de prix personnalisé sur les pages du panier et de paiement, où un format décoré entre parfois en conflit avec d'autres plugins. →
- apply_filters woocs_disable_backend_refund_calculation Désactive la conversion de devise pendant le traitement d'un remboursement dans wp-admin, pour les boutiques qui stockent les remboursements dans la devise de base par politique. →
- apply_filters woocs_drop_down_view Change le thème du menu déroulant du sélecteur de devises à la volée, afin que différentes pages ou groupes d'utilisateurs puissent obtenir différents designs de sélecteur. →
- apply_filters woocs_fixed_price_user_rope Filtre qui transmet le prix résolu par la fonctionnalité de prix basés sur le rôle utilisateur, ainsi que l'ID du produit, le type de prix et les rôles utilisateur. Notez la faute de frappe dans le nom du crochet : rope, pas role. →
- apply_filters woocs_fixed_raw_woocommerce_price Filtre le prix brut lorsque des prix fixes par devise sont en jeu. Le point d'attachement habituel pour faire respecter les prix fixes par un plugin de tarification tiers. →
- apply_filters woocs_form_method Modifie la méthode du formulaire du sélecteur de POST à GET, ce dont certains systèmes de cache et constructeurs de pages ont besoin. À partir de v.2.2.0 / 1.2.0. →
- apply_filters woocs_geobone_ip Filtre contrôlant le comportement de première visite uniquement des règles Geo IP. Renvoyer false désactive le drapeau qui fait qu'une règle géo s'applique une fois par visiteur. Par défaut true. →
- apply_filters woocs_get_approximate_amount_text Modifie le libellé autour du montant approximatif affiché sur les pages du panier et de paiement lorsque l'option « Show approx. amount » est activée. →
- apply_filters woocs_init_compatibility_woo_subscriptions Active la compatibilité avec WooCommerce Subscriptions, afin que les montants de renouvellement conservent la devise dans laquelle l'abonnement a été créé. →
- apply_filters woocs_order_formatted_prices Contrôle le formatage des prix sur les pages de commande et de remerciement. Renvoyez false pour laisser le formatage de WooCommerce intact. →
- apply_filters woocs_precision_on_calc Augmente la précision de calcul interne. Nécessaire lorsque les prix unitaires sont très petits — avec quatre décimales, un article à 0.000423 est arrondi à zéro. →
- apply_filters woocs_price_decimal_sep Définit le séparateur décimal par devise ou selon toute autre règle, afin que chaque marché lise les prix comme il s’y attend. →
- apply_filters woocs_price_format Filtre la chaîne de format de prix WooCommerce entière, pour un contrôle total sur l’emplacement du symbole et ce qui entoure le nombre. →
- apply_filters woocs_price_html Filtre le balisage de prix final d’un produit. Le hook pour ajouter un symbole de devise personnalisé, une note ou tout balisage de votre choix à chaque prix dans la boutique. →
- apply_filters woocs_price_html_tail Ajoute du texte ou un balisage après un prix de produit sur les pages boutique et catégorie — un montant approximatif, une note de taxe, une indication par unité. →
- apply_filters woocs_price_shortcode Filtre le prix produit par le shortcode [woocs_price], afin qu’un prix affiché en dehors de la boucle produit puisse suivre sa propre règle. →
- apply_filters woocs_price_thousand_sep Définit le séparateur de milliers par devise ou selon toute autre règle, afin que 1,299.00 et 1 299,00 puissent coexister dans la même boutique. →
- apply_filters woocs_product_fixed_price_data_simple_types Déclare à quels types de produits les prix fixes par devise s’appliquent, afin qu’un type de produit personnalisé puisse en faire partie. →
- apply_filters woocs_raw_woocommerce_price Filtre le prix numérique brut avant le formatage. C’est là que résident les règles d’arrondi des prix — à 50 cents, à 99 cents, à une unité entière. →
- apply_filters woocs_redraw_cart Désactive le redessinage du mini-panier après un changement de devise, ce qui résout les conflits avec les thèmes et scripts qui reconstruisent eux-mêmes le panier. →
- apply_filters woocs_show_side_swither Filtre ayant le dernier mot sur l’affichage du sélecteur latéral flottant sur la page courante, appliqué après les propres paramètres et exclusions du plugin. Notez la faute de frappe dans le nom du hook : swither. →
- apply_filters woocs_side_switcher_data Filtre transmettant tout le tableau de configuration du sélecteur latéral — skin, côté, décalage, couleurs et modèles de champs — avant que le panneau ne soit rendu. →
- apply_filters woocs_woocommerce_available_variation Filtre transmettant le tableau de données d’une variation unique après que FOX a converti ses prix, y compris price_html, en route vers le front-end sous forme de JSON. →
- apply_filters woocs_woocommerce_variation_prices Filtre la fourchette de prix d’un produit variable, afin que la ligne de-de à sur un produit variable suive votre propre logique de devise. →
- fn() $WOOCS->back_convert() Convertit un montant de la devise actuellement sélectionnée vers la devise de base de la boutique — la correction pour un code tiers qui compare un total converti à un seuil exprimé dans la devise de base. →
- fn() $WOOCS->convert_from_to_currency($value, $from_currency, $to_currency) Convertit un montant entre deux devises quelconques directement, sans passer par la devise de base. Disponible à partir de v.2.4.0 / v.1.4.0. →
- fn() $WOOCS->current_currency La propriété contenant la devise dans laquelle le visiteur navigue actuellement. Le point de départ pour presque toute logique personnalisée de devise. →
- fn() $WOOCS->default_currency La propriété contenant la devise de base de la boutique, celle avec laquelle WooCommerce lui-même est configuré et par rapport à laquelle chaque taux est calculé. →
- fn() $WOOCS->get_checkout_page_id() Retourne l'ID de la page de paiement, afin que votre propre code puisse déterminer de manière fiable si la requête actuelle est celle du paiement. →
- fn() $WOOCS->get_currencies($suppress_filters = false) Retourne chaque devise configurée dans les paramètres du plugin, avec son taux, son symbole, ses décimales et sa position — l'ensemble du tableau des devises sous forme de tableau. →
- fn() $WOOCS->get_currency_by_country() Retourne la devise que les règles Geo IP résolvent pour le pays du visiteur. Fonctionne uniquement lorsque l'option Geo IP est activée. →
- fn() $WOOCS->get_currency_price_num_decimals() Retourne le nombre de décimales qu'une devise donnée est configurée pour afficher, afin que votre propre affichage de prix corresponde au reste de la boutique. →
- fn() $WOOCS->get_geo_rules() Retourne le tableau des règles Geo IP — quel pays correspond à quelle devise — pour lecture ou action depuis votre propre code. →
- fn() $WOOCS->get_welcome_currency() Retourne la devise de bienvenue : celle qu'un visiteur pour la première fois voit avant de faire son propre choix. →
- fn() $WOOCS->is_multiple_allowed La propriété qui vous indique si le paiement multi-devise est activé, c'est-à-dire si les clients peuvent payer dans la devise qu'ils ont sélectionnée. →
- fn() $WOOCS->is_use_geo_rules() Retourne 'true' lorsque l'option Geo IP est activée, afin que votre code puisse bifurquer en fonction de l'activation des règles pays. →
- fn() $WOOCS->make_rates_auto_update() Exécute immédiatement une mise à jour complète des taux de change, la même que celle effectuée par le cron intégré. Utilisez-la pour piloter les mises à jour depuis un vrai cron serveur. →
- fn() $WOOCS->reset_currency() Réinitialise le visiteur vers la devise de base de la boutique — utile lorsqu'un processus tiers doit s'exécuter dans un contexte de devise de base. →
- fn() $WOOCS->set_currency() Définit la devise pour le visiteur actuel à partir de votre propre code, quelle que soit la logique nécessaire. Disponible à partir de v.2.1.8 / v.1.1.8. →
- fn() $WOOCS->storage->get_val() Lit une valeur depuis la couche de stockage FOX — la devise sélectionnée entre autres — quel que soit le backend de stockage configuré pour la boutique. →
- fn() $WOOCS->storage->set_val() Écrit une valeur dans la couche de stockage FOX, afin que le code personnalisé puisse persister un état aux côtés du plugin plutôt que de créer sa propre session. →
- fn() $WOOCS->woocs_exchange_value() Convertit un montant de la devise de base de la boutique vers la devise que le visiteur a sélectionnée — l'appel de conversion quotidien. →
- fn() REST API Points de terminaison de l'API REST pour lire les données des devises et les prix des produits par programmation, destinés aux interfaces headless, applications mobiles et intégrations externes. →