Product Feed Pro déclenche un grand ensemble de crochets d'action et de filtre WordPress tout au long de la création du flux, de la génération du flux et des écrans d'administration. Utilisez-les pour ajouter vos propres champs à l'éditeur de flux, modifier les données qui entrent dans un flux ou étendre l'interface utilisateur d'administration du plugin sans modifier directement les fichiers du plugin.
De plus, Product Feed Elite et d'autres modules complémentaires AdTribes s'appuient sur bon nombre des mêmes crochets pour étendre Product Feed Pro. Lorsqu'un crochet existe spécifiquement pour qu'un module complémentaire puisse se connecter au comportement principal, cela est noté ci-dessous.
Comment les crochets s'intègrent dans le pipeline du flux
Une exécution de génération de flux comporte trois étapes : le plugin résout les paramètres du flux et démarre un lot de produits, il parcourt les produits et construit la ligne de données de chacun, puis il écrit les lignes terminées dans le fichier de flux et conclut. Les crochets sous Génération de flux et traitement par lots et la plupart des filtres de Données produit et sortie du flux s'exécutent pendant l'étape intermédiaire, une fois par produit ou une fois par lot. Les crochets sous Assistant de modification de flux et Pages d'administration, paramètres et notifications ne s'exécutent que lorsque quelqu'un utilise l'administration WordPress (création, modification ou gestion d'un flux), et non lors d'une actualisation planifiée du flux. Gardez cela à l'esprit lorsque vous choisissez un crochet : un filtre qui modifie les données d'un produit n'affecte que les futures générations de flux, tandis qu'une action liée à l'écran de modification de flux ne s'exécute que lorsqu'une personne travaille activement dans cet écran.
Actions
Les actions sont des crochets que WordPress exécute à des points spécifiques pendant l'exécution, ou lorsque des événements spécifiques se produisent.
Pages d'administration, menus et notifications
| Crochet | Détail |
|---|---|
adt_pfp_help_menu_items | S'exécute à la fin du menu déroulant Aide dans l'en-tête d'administration du plugin, après les liens Ressources intégrés. Permet à Elite et à d'autres modules complémentaires d'ajouter leurs propres éléments de menu Aide. Comme l'en-tête s'affiche sur chaque page d'administration de Product Feed, votre rappel doit limiter sa propre sortie aux pages où il doit apparaître. |
adt_license_page_enqueue_scripts | S'exécute à la fin de l'enchaînement des scripts de la page de licence, permettant aux modules complémentaires d'enchaîner leurs propres scripts ou styles sur cet écran. |
adt_license_page_content | S'exécute à l'intérieur de la zone de contenu de l'onglet de la page de licence. Reçoit l'ID de l'onglet actif et la liste complète des onglets enregistrés, afin que chaque module complémentaire puisse afficher son propre contenu d'onglet uniquement lorsque son onglet est actif. |
adt_pfp_settings_page_tab_content | S'exécute après le rendu du contenu de l'onglet de la page des paramètres intégrée, permettant à d'autres codes d'ajouter du contenu pour l'onglet actif, y compris un onglet personnalisé non intégré à Product Feed Pro. |
adt_pfp_settings_page_export_import_tab_content | Se déclenche à la fin de l'onglet Paramètres → Exportation/Importation, après l'option intégrée « écraser les flux existants », pour les extensions qui souhaitent ajouter leurs propres contrôles d'exportation/importation. |
adt_edit_feed_tab_content | Se déclenche après le rendu du modèle de contenu de l'onglet intégré Modifier le flux, permettant à d'autres codes d'ajouter du contenu pour l'onglet actif. |
adt_pfp_manage_feeds_before_title | Se déclenche à l'intérieur de l'enveloppe de la page Gérer les flux, au-dessus du titre de la page. |
adt_pfp_manage_feeds_after_title | Se déclenche immédiatement à côté du titre de la page « Gérer les flux », pour injecter du contenu à côté de l'en-tête. |
adt_manage_feeds_table_row_actions | Se déclenche à l'intérieur de la cellule Actions de chaque ligne du tableau Gérer les flux. Reçoit l'objet de flux pour cette ligne, afin que les extensions puissent ajouter leurs propres liens d'action par flux. |
adt_pfp_after_display_admin_notice_generic | Se déclenche immédiatement après le rendu d'une notification d'administrateur générique de flux de produits, vous permettant d'ajouter du balisage supplémentaire après celle-ci. |
adt_pfp_notice_updated | Se déclenche après la modification de la valeur stockée d'une notification d'administrateur, par exemple lorsqu'un utilisateur la rejette ou la reporte. |
adt_pfp_before_dismiss_admin_notice | Se déclenche au début du gestionnaire AJAX « rejeter la notification d'administrateur », avant la mise à jour de la valeur stockée de la notification. |
adt_after_register_adt_product_feed_post_type | Se déclenche juste après que le plugin a enregistré son type de publication personnalisé interne adt_feed, afin que d'autres codes puissent s'appuyer en toute sécurité sur le fait que le type de publication est déjà disponible. |
adt_after_migrate_to_custom_post_type | Se déclenche après la fin de la migration unique des données de flux héritées vers le type de publication personnalisé adt_feed, déclenchée depuis la page Paramètres. |
adt_after_install_activate_plugin | Se déclenche après que le gestionnaire AJAX « installer et activer » de la liste de contrôle de configuration a tenté de télécharger et d'activer un plugin sœur. Reçoit le slug du plugin demandé et le résultat de l'installation. |
Cycle de vie du flux : création, clonage, suppression et annulation
| Crochet | Détail |
|---|---|
adt_create_product_feed_before_save | Se déclenche juste avant qu'un nouveau flux ne soit enregistré, lorsqu'un flux est créé via le flux de création de flux hérité. C'est votre dernière chance de modifier l'objet de flux avant qu'il ne soit écrit dans la base de données. |
adt_clone_product_feed_before_save | Se déclenche juste avant qu'un flux cloné ne soit enregistré, dans tous les endroits où un flux peut être dupliqué (l'action de clonage unique, l'action de duplication en masse, WP-CLI et l'API des capacités). Reçoit le clone en mémoire et le flux d'origine à partir duquel il a été cloné. |
adt_after_clone_product_feed | Se déclenche juste après qu'un flux cloné a été enregistré et que son calendrier de rafraîchissement a été enregistré, à partir des mêmes points d'entrée de clonage que adt_clone_product_feed_before_save. |
adt_before_delete_product_feed | Se déclenche immédiatement avant la suppression d'un flux, avant que ses données ne soient détruites. Se déclenche de la même manière depuis l'interface d'administration, WP-CLI et l'API des capacités. |
adt_after_delete_product_feed | Se déclenche immédiatement après la suppression d'un flux, à partir des mêmes points d'entrée que adt_before_delete_product_feed. |
adt_before_cancel_product_feed | Se déclenche immédiatement avant que l'état d'exécution d'un flux en cours ne soit réinitialisé et que son statut ne passe à Arrêté. |
adt_after_cancel_product_feed | Se déclenche juste après que le traitement d'un flux a été annulé, sauvegardé, et que sa tâche de mise à jour des statistiques a été mise en file d'attente. |
Assistant de modification du flux : onglet traitement
Chaque onglet de l'écran Modifier le flux déclenche une paire de hooks lorsque son formulaire est soumis : un filtre que vous pouvez utiliser pour modifier ce qui est sauvegardé, et une action qui se déclenche juste après sa sauvegarde. Tous déclenchent également l'action équivalente de l'API des capacités lorsqu'elle existe.
| Crochet | Détail |
|---|---|
adt_after_process_general_tab_form | Se déclenche après la sauvegarde des paramètres de l'onglet Général. Reçoit le flux sauvegardé, les propriétés qui ont été appliquées, et une copie du flux tel qu'il était avant la modification. |
adt_after_process_filters_rules_tab_form | Se déclenche après la sauvegarde de l'onglet combiné hérité Filtres et Règles (uniquement pertinent sur les sites utilisant encore le paramètre adt_use_legacy_filters_and_rules). |
adt_after_process_filters_tab_form | Se déclenche après la sauvegarde de l'onglet Filtres. |
adt_after_process_rules_tab_form | Se déclenche après la sauvegarde de l'onglet Règles. |
adt_after_process_field_mapping_tab_form | Se déclenche après la sauvegarde de l'onglet Mappage des champs. |
adt_after_process_category_mapping_tab_form | Se déclenche après la sauvegarde de l'onglet Mappage des catégories. |
adt_after_process_conversion_analytics_tab_form | Se déclenche après la sauvegarde des paramètres UTM de l'onglet Conversion et Analyse. |
adt_process_tab_form | Se déclenche comme solution de repli lorsque l'onglet soumis ne correspond à aucun des onglets intégrés de Product Feed Pro, permettant à Elite ou à d'autres modules complémentaires de gérer le traitement des formulaires pour leurs propres onglets personnalisés. |
Assistant de modification du flux : points d'injection de modèle
| Crochet | Détail |
|---|---|
adt_avant_la_page_de_gestion_du_flux_de_produits | Se déclenche près du haut de chaque onglet de l'assistant de modification du flux, avant que le contenu de cet onglet ne soit rendu. Reçoit un numéro $step qui indique quel onglet est actuellement actif (0 pour Général, 1 pour Mappage des catégories, 4 pour Filtres et Règles, 5 pour Conversion et Analyse, 7 pour Mappage des champs), afin que votre rappel puisse cibler un onglet spécifique. |
adt_parametres_generaux_du_flux_avant_le_champ_pays | Se déclenche dans l'onglet Général, juste avant la ligne du champ Pays. |
adt_parametres_generaux_du_flux_apres_les_pays_de_livraison | Se déclenche dans l'onglet Général, juste après la ligne « Inclure tous les pays d'expédition ». Ceci est nouveau dans Product Feed Pro 13.5.7. C'est ainsi que Product Feed Elite ajoute son bascule « Afficher uniquement la méthode d'expédition la moins chère par pays », ce qui en fait un endroit éprouvé pour ajouter votre propre ligne à l'onglet Général. |
adt_parametres_generaux_du_flux_apres_l_intervalle_de_rafraichissement | Se déclenche dans l'onglet Général, juste après la ligne de l'intervalle d'actualisation. |
Génération de flux et traitement par lots
| Crochet | Détail |
|---|---|
woosea_avant_l_obtention_des_produits | Se déclenche une fois par lot de génération de flux, juste après la résolution des attributs, règles et filtres du flux et juste avant que le plugin ne commence à interroger les produits. |
adt_avant_la_creation_du_flux_xml_yandex | Se déclenche juste avant que le plugin ne construise la structure XML racine pour un flux au format Yandex. |
adt_avant_le_traitement_par_lot_du_flux_de_produits | Se déclenche juste avant le traitement de chaque lot de produits lors de la génération du flux. Reçoit l'ID du flux, le décalage actuel et la taille du lot sur le point de s'exécuter. |
adt_apres_la_generation_du_flux_de_produits | Se déclenche après la fin d'une exécution complète de génération de flux et que le fichier de flux final est en place. Un bon crochet pour les tâches post-génération telles que les notifications ou la purge du cache. |
Filtres
Les filtres sont des crochets qui modifient les données avant qu'elles ne soient utilisées, qu'il s'agisse d'une valeur affichée dans l'administration, d'une requête ou de données écrites dans le fichier de flux.
Moteur de filtres et de règles
Les onglets Filtres et Règles de Product Feed Pro permettent à un propriétaire de boutique d'inclure, d'exclure ou de transformer des produits en fonction de conditions. Ces filtres étendent ce moteur.
| Crochet | Détail |
|---|---|
adt_pfp_obtention_des_conditions_des_regles_de_filtres | Filtre la liste des conditions de comparaison disponibles lors de la création d'un filtre ou d'une règle (par exemple « Contient », « Entre »), vous permettant d'ajouter vos propres types de conditions à la liste déroulante. |
adt_pfp_evaluation_d_une_condition_de_regle_de_filtre | Vous permet de résoudre un type de condition personnalisé que la liste de conditions du plugin ne gère pas, lorsqu'un filtre ou une règle évalue un produit. Retournez true ou false pour le résoudre, ou transmettez le null entrant pour revenir au comportement par défaut du plugin (les conditions non gérées sont transmises par défaut). Utilisez ceci conjointement avec adt_pfp_get_filters_rules_conditions. Enregistrer une condition dans la liste déroulante sans la gérer ici laisse la condition sans effet lors de l'exécution d'un flux. |
adt_pfp_obtention_des_attributs_des_regles_de_filtres | Filtre la liste groupée des attributs proposés dans les listes déroulantes du constructeur de filtres et de règles. Reçoit la liste des attributs, le canal du flux, si vous créez un filtre ou une règle, et le flux lui-même (null pour un flux qui n'a pas encore été enregistré). |
adt_pfp_obtention_des_actions_des_regles | Filtre la liste des actions disponibles dans la liste déroulante « alors » d'une règle (comme « Définir la valeur » ou « Combiner les champs »), vous permettant d'enregistrer vos propres actions de règle. |
adt_pfp_application_des_actions_des_regles | Filtre les données du flux d'un produit après que les actions configurées d'une règle ont été appliquées. |
adt_pfp_traitement_d_une_action_de_regle | Filtre les données du flux d'un produit après qu'une action de règle unique a été traitée, dans la boucle qui exécute chaque action à tour de rôle. |
adt_pfp_filtrage_des_donnees_du_flux_de_produits | Filtre les données finales d'un produit après l'exécution des filtres du flux. Ceci est également déclenché par le moteur de filtres hérité et, deux fois, par le générateur de flux d'avis produits Google. |
adt_pfp_peut_etre_ignorer_le_filtre | Filtre si une règle de filtre hérité spécifique doit être complètement ignorée, sur les sites utilisant encore le moteur de filtres hérité. |
adt_pfp_produit_filtre_passe_flux_de_produits | Filtre si un produit a passé toutes les règles de filtre héritées du flux dans l'ensemble. |
Données produit et sortie du flux
| Crochet | Détail |
|---|---|
adt_obtention_des_donnees_du_produit | Filtre le tableau de données complet d'un seul produit, juste avant qu'il ne soit transmis au moteur de filtres et de règles, puis au fichier de flux. C'est le crochet principal pour modifier quoi que ce soit sur la façon dont un produit apparaît dans un flux. |
adt_flux_obtention_des_attributs | Filtre la liste de mappage d'attributs configurée du flux, à la fois au début de la génération du flux et à nouveau par produit lors du calcul de la valeur. |
adt_flux_de_produits_parametres_de_requete_obtention_produits | Filtre les arguments complets de WP_Query utilisés pour récupérer le lot de produits pour la génération du flux. |
adt_flux_de_produits_obtention_id_produit | Filtre l'ID du produit en cours de traitement pour l'élément actuel de la boucle, juste avant que le plugin ne charge l'objet produit. |
adt_flux_de_produits_filtrage_visibilite_catalogue | Filtre la liste des valeurs de visibilité du catalogue qui devraient exclure un produit du flux. |
adt_donnees_produit_format_disponibilite | Filtre la valeur finale de disponibilité (comme « en stock » ou « hors stock ») pour un produit, après que le mappage spécifique au canal du plugin ait été exécuté. |
adt_donnees_flux_produits_prix_arrondi_nombre_decimales | Filtre le nombre de décimales utilisées lorsque le plugin calcule les variantes de prix arrondis pour un produit. |
adt_donnees_flux_produits_prix_arrondi_precisions | Filtre la précision d'arrondi passée à round() de PHP pour ces variantes de prix arrondis. |
adt_donnees_flux_produits_prix_arrondi_mode | Filtre la constante de mode d'arrondi PHP (par exemple PHP_ROUND_HALF_UP) utilisée pour les variantes de prix arrondis. |
adt_flux_versement_devise | Filtre le code de devise utilisé lors de la construction du texte de paiement échelonné « achetez maintenant » d'un produit. |
adt_merkandi_niveaux_de_prix | Filtre dans une liste de paliers de prix basés sur la quantité pour un produit au format Merkandi, pour les intégrations de vente en gros ou de prix par quantité. Lorsque cela renvoie un tableau non vide, le plugin affiche un bloc de prix au lieu d'un prix fixe. |
adt_pfp_flux_google_shopping_lien_canal | Filtre le lien du site écrit dans l'en-tête du fichier de flux au format Google Shopping. |
adt_pfp_flux_lien_canal | Filtre l'élément de lien au niveau du canal pour les formats de flux RSS Yandex, Zap.co.il, Salidzini.lv et Pinterest Board. |
En-tête CSV du flux de produits AdTribes | Filtre la chaîne de la ligne d'en-tête juste avant qu'elle ne soit écrite comme première ligne d'un flux au format CSV ou TXT. |
Données de ligne CSV du flux de produits AdTribes | Filtre le tableau de valeurs qui composent une seule ligne CSV ou TXT, juste avant qu'elle ne soit écrite dans le fichier de flux. |
Produit JSONL du flux de produits AdTribes | Filtre les données d'un seul produit avant qu'elles ne soient ajoutées au lot, pour les flux aux formats JSONL et JSONL.GZ uniquement. |
Produits de prévisualisation du flux de produits AdTribes | Filtre le nombre cible de produits à inclure lorsqu'un flux est généré en mode aperçu (par défaut 5). |
Taille de lot de prévisualisation du flux de produits AdTribes | Filtre la taille du lot de requêtes utilisé lors des requêtes répétées de produits en mode aperçu jusqu'à ce que le nombre cible soit atteint. |
Nombre maximal de requêtes de prévisualisation du flux de produits AdTribes | Filtre le nombre maximum de requêtes par lots que le mode aperçu exécute avant d'abandonner. |
Tableau de codes UTM du flux de produits AdTribes | Filtre le tableau des paramètres UTM de Google Analytics avant qu'ils ne soient assemblés en une chaîne de requête et ajoutés au lien du flux d'un produit. |
Ajouter des codes UTM au flux de produits AdTribes | Filtre la chaîne de requête UTM finale assemblée, juste avant qu'elle ne soit ajoutée au lien du flux d'un produit. |
Taille de lot adaptative
Nouveau dans Product Feed Pro 13.5.7. Au lieu d'un nombre fixe de produits par lot, le plugin peut désormais dimensionner chaque lot automatiquement en fonction du temps qu'a pris le lot précédent et de la mémoire qu'il a utilisée. Ces filtres vous donnent le contrôle sur ce comportement.
| Crochet | Détail |
|---|---|
Activer le lot adaptatif du flux de produits AdTribes | Filtre si la taille de lot adaptative est utilisée du tout pour un flux (activée par défaut, sauf si l'utilisateur a manuellement épinglé une taille de lot dans les paramètres du flux). Retournez false pour rétablir le comportement précédent de taille fixe sans modifier les paramètres. C'est le filtre à utiliser en premier pour diagnostiquer si la taille adaptative est impliquée dans un problème de génération de flux. |
Taille du lot du flux de produits AdTribes | Filtre la taille de lot de départ pour un flux, avant que la taille adaptative ne prenne le relais pour les lots suivants. |
Budget temporel du lot du flux de produits AdTribes | Filtre le budget de temps par lot, en secondes, que la taille adaptative vise à ne pas dépasser. |
Limite de mémoire (octets) du flux de produits AdTribes | Filtre le plafond de mémoire, en octets, utilisé par le garde-mémoire adaptatif. Retourner 0 désactive le garde-mémoire. |
Taille du prochain lot adaptatif du flux de produits AdTribes | Filtre la taille que le plugin a calculée pour le lot suivant, vous donnant le dernier mot sur la valeur adaptée. |
Seuil d'avertissement de mémoire du flux de produits AdTribes | Filtre le seuil de mémoire, en octets, qui déclenche un avertissement de faible mémoire dans les journaux pendant le traitement par lots (ne s'active que lorsque la journalisation est activée). |
Exporter et importer
| Crochet | Détail |
|---|---|
Propriétés des données d'exportation du flux Product Feed Pro | Filtre la liste des clés de propriétés du flux incluses lors de l'exportation d'un flux via l'outil Exporter/Importer. Nouveau dans Product Feed Pro 13.5.7, donc un module complémentaire peut enregistrer ses propres propriétés de flux et les faire passer par l'exportation et l'importation. Toute propriété qu'un flux n'a pas réellement est ignorée en toute sécurité. |
Importer des flux AdTribes | Déclenche une action, pas un filtre, lorsqu'un utilisateur clique sur Importer les flux dans l'outil Exporter/Importer. Product Feed Pro lui-même n'inclut pas la logique d'importation, donc Elite et d'autres modules complémentaires s'accrochent ici pour effectuer l'importation réelle. |
Mettre à jour avant la version 13.3.5 pour enregistrer le flux | Filtre un objet de flux pendant la routine de mise à niveau unique qui a migré les anciens flux basés sur cron vers le type de publication de flux actuel. Uniquement pertinent si vous personnalisez ce chemin de migration historique. |
Données d'expédition
| Crochet | Détail |
|---|---|
Devise des frais de livraison du flux de produits AdTribes | Filtre le code de devise utilisé lors du calcul des frais de port pour un flux. |
Prix du produit de livraison du flux de produits AdTribes | Filtre le prix du produit utilisé comme base pour les calculs des tarifs de livraison. |
Données de livraison du flux de produits AdTribes | Filtre le tableau complet des données d'expédition pour un produit, la sortie finale du pipeline de données d'expédition. |
Pays de livraison du flux de produits AdTribes | Filtre la liste résolue des pays pour les zones d'expédition définies sur « Partout ». |
Colis de livraison du flux de produits AdTribes | Filtre le colis d'expédition synthétique construit en interne avant qu'il ne soit transmis au calcul des tarifs de WooCommerce. |
Tableau de livraison du flux de produits AdTribes | Filtre une seule entrée de méthode d'expédition avant qu'elle ne soit ajoutée aux données d'expédition d'un produit. S'exécute une fois par tarif, à la fois pour les méthodes d'expédition régulières et pour le retrait en magasin. |
Appliquer la taxe de livraison | Filtre si la taxe est appliquée en plus des frais de port calculés. |
Convertir les frais de livraison du flux de produits AdTribes | Filtre la valeur brute des frais de port avant qu'elle ne soit formatée pour le flux. |
Arguments de localisation des prix des frais de livraison du flux de produits AdTribes | Filtre les arguments utilisés lors du formatage des frais de port dans leur chaîne d'affichage finale. |
Coupon de livraison gratuite du flux de produits AdTribes | Un filtre de court-circuit qui vous permet de remplacer la propre détection du plugin d'un coupon de livraison gratuite actif, utilisé lors de l'évaluation des règles de livraison gratuite. Retournez true ou false pour remplacer, ou null pour laisser le plugin exécuter sa propre vérification. |
Tarification, devise et formatage
| Crochet | Détail |
|---|---|
Devise des données du produit AdTribes | Filtre le code de devise utilisé lors de la création des données du flux produit. |
Devise du flux de produits AdTribes | Filtre le code de devise utilisé pour résoudre les espaces réservés {{CURRENCY}} dans l'onglet Mappage des champs. |
Données de localisation des prix Product Feed Pro | Filtre les données du flux produit après que ses champs de prix ont été localisés pour l'affichage. |
adt_product_feed_localize_price_args | Filtre les arguments passés au formatage des prix de WooCommerce lors de la localisation d'un prix pour la sortie du flux. |
adt_pfp_format_date | Filtre la chaîne de date formatée finale utilisée dans la sortie du flux, après que tout formatage de date spécifique au canal a déjà été effectué. |
adt_format_refresh_interval_manage_feeds_table | Filtre les libellés d'intervalle d'actualisation (comme « Toutes les heures ») affichés dans le tableau Gérer les flux. |
adt_product_feed_refresh_interval_labels | Filtre le même type de libellés d'intervalle d'actualisation, utilisé par une partie différente de l'interface d'administration. |
adt_product_feed_refresh_interval_options | Filtre la liste des choix d'intervalle d'actualisation proposés dans le menu déroulant de l'onglet Général. |
Catégories, attributs et mappage des champs
| Crochet | Détail |
|---|---|
adt_pfp_get_categories_dropdown_args | Filtre les arguments get_terms() utilisés pour construire le menu déroulant des catégories de produits dans le générateur de filtres et de règles. |
adt_pfp_get_categories_dropdown | Filtre la liste des termes de catégorie renvoyés pour ce même menu déroulant, après l'exécution de la requête. |
adt_product_feed_attributes | Filtre la liste principale des attributs standard disponibles pour le mappage des champs. |
adt_product_feed_dynamic_attributes | Filtre la liste des attributs personnalisés basés sur des taxinomies proposés dans l'interface de mappage des champs. |
adt_product_feed_custom_attributes | Filtre la liste des attributs produit personnalisés (non taxinomiques) proposés pour le mappage des champs, mis en cache pendant 24 heures. |
adt_product_feed_field_mapping_prefix_replace | Filtre la carte de remplacement des espaces réservés (comme {{CURRENCY}}) utilisée pour résoudre les jetons dans la valeur de préfixe d'une ligne de mappage de champ. |
adt_product_feed_field_mapping_suffix_replace | Filtre le même type de carte de remplacement pour la valeur Suffix d'une ligne de mappage de champ. |
Historique des commandes et des ventes
| Crochet | Détail |
|---|---|
adt_total_product_orders_lookback_today | Filtre la date de référence « aujourd'hui » utilisée lors du calcul de la fenêtre d'historique des commandes pour l'attribut Total des commandes de produits. |
adt_total_product_orders_lookback_today_limit | Filtre la date limite la plus ancienne utilisée pour interroger les commandes qui comptent pour cet historique. |
adt_total_product_orders_lookback_allowed_products | Filtre la liste finale des identifiants de produits et de variations considérés comme « récemment commandés » pour cette fonctionnalité. |
adt_variation_total_sales_enable_cache | Filtre si le plugin met en cache le nombre total de ventes d'une variation. |
adt_variation_total_sales_cache_expiration | Filtre combien de temps, en secondes, la valeur du total des ventes mise en cache est conservée. |
adt_invalidate_variation_sales_cache_ids | Filtre quels identifiants de variations ont leur valeur de total des ventes mise en cache effacée lorsque le statut d'une commande change. |
Pages d'administration, paramètres et notifications
| Crochet | Détail |
|---|---|
adt_pfp_admin_capability | Filtre la capacité WordPress requise pour accéder à chaque page d'administration de Product Feed Pro (par défaut manage_options). Appliqué de manière cohérente à chaque classe de page d'administration, donc le changer à un endroit change l'accès partout. |
adt_manage_product_feed_allowed_roles | Filtre une liste supplémentaire de rôles d'utilisateurs, au-delà de la vérification de capacité ci-dessus, autorisés à gérer les flux. |
adt_license_page_tabs | Filtre les onglets affichés sur la page d'administration des licences. Product Feed Pro lui-même n'ajoute aucun onglet, donc Elite et d'autres modules complémentaires enregistrent leurs onglets de licence ici. |
adt_pfp_settings_page_tabs | Filtre la liste des onglets sur la page d'administration des paramètres. |
adt_general_settings_args | Filtre les définitions de champs affichées dans l'onglet Général de la page des paramètres. |
adt_settings_other_settings_args | Filtre les définitions de champs pour l'onglet « Autres paramètres » de la page des paramètres. |
adt_admin_plugin_page_title | Filtre le titre de la page d'administration principale « Gérer les flux ». |
adt_admin_plugin_menu_title | Filtre le texte de l'étiquette de l'élément de menu d'administration de niveau supérieur du plugin (affiché sous « Product Feed » dans la barre latérale de WordPress). |
adt_pfp_feed_polling_interval | Filtre la fréquence, en millisecondes, à laquelle la page Gérer les flux interroge le serveur pour les mises à jour du statut de génération des flux. |
adt_manage_feeds_row_actions | Filtre les liens d'action de ligne (Actualiser, Annuler, Supprimer, etc.) affichés pour chaque flux dans le tableau Gérer les flux. |
adt_edit_feed_get_tabs | Filtre l'ensemble des onglets affichés sur l'écran Modifier le flux. |
adt_update_temp_product_feed | Filtre la configuration temporaire non sauvegardée du flux à mesure qu'un utilisateur parcourt l'assistant de modification du flux avant que le flux ne soit finalisé. |
adt_edit_feed_general_tab_props | Filtre les valeurs des propriétés du flux sur le point d'être enregistrées lorsque l'onglet Général est soumis, juste avant l'enregistrement du flux. |
adt_edit_feed_filters_rules_tab_props | Filtre les valeurs des propriétés du flux sur le point d'être enregistrées lorsque l'onglet combiné hérité Filtres et Règles est soumis. |
adt_edit_feed_filters_tab_props | Filtre les valeurs des propriétés du flux sur le point d'être enregistrées lorsque l'onglet Filtres est soumis. |
adt_edit_feed_rules_tab_props | Filtre les valeurs des propriétés du flux sur le point d'être enregistrées lorsque l'onglet Règles est soumis. |
adt_edit_feed_field_mapping_tab_props | Filtre les valeurs des propriétés du flux sur le point d'être enregistrées lorsque l'onglet Mappage des champs est soumis. |
adt_edit_feed_category_mapping_tab_props | Filtre les valeurs des propriétés du flux sur le point d'être enregistrées lorsque l'onglet Mappage des catégories est soumis. |
adt_edit_feed_conversion_analytics_tab_props | Filtre les valeurs des propriétés du flux sur le point d'être enregistrées lorsque l'onglet Conversion et Analyse est soumis. |
adt_pfp_autoloaded_ajax_settings | Filtre les paramètres qui, lorsqu'ils sont enregistrés via le point de terminaison AJAX des paramètres du plugin, sont stockés avec autoload activé. |
adt_pfp_allowed_ajax_settings | Filtre la liste autorisée des noms d'options que le point de terminaison AJAX est autorisé à mettre à jour, afin que les plugins compagnons puissent l'étendre avec leurs propres options préfixées par adt_. |
adt_pfp_regenerate_action_schedulers_count | Filtre le nombre d'exécution des flux régénérés pendant la routine « régénérer les planificateurs » de l'administrateur, permettant aux modules complémentaires d'ajouter leurs propres actions planifiées au total. |
adt_pfp_cron_notices_data | Filtre la liste des définitions de notifications pilotées par cron, permettant à Elite et à d'autres extensions d'enregistrer leurs propres notifications d'administration. |
adt_pfp_show_notice | Filtre si une notification d'administration spécifique doit s'afficher, en fonction de sa clé, de son contexte et de ses données. |
adt_pfp_get_all_admin_notices | Filtre la liste finale des notifications d'administration renvoyées à l'interface utilisateur d'administration. |
adt_pfp_show_get_elite_notice | Filtre si la notification de mise à niveau « Obtenir Elite » s'affiche. |
adt_pfp_show_notice_bar_lite | Filtre si la barre de notification de la version gratuite s'affiche sur les pages d'administration du plugin. |
pfp_notice_bar_lite_upgrade_link | Filtre l'URL « Mettre à niveau vers Elite » affichée dans cette barre de notification. Contrairement à la plupart des hooks de ce plugin, celui-ci n'utilise pas le préfixe adt_. |
adt_pfp_show_logo_upgrade_button | Filtre si le bouton « Mettre à niveau vers Elite » du logo s'affiche dans l'interface d'administration. |
adt_is_plugin_page | Filtre si l'écran d'administration actuel est considéré comme une page Product Feed Pro ou Elite, utilisé pour contrôler le chargement des ressources spécifiques au plugin. |
postmeta_form_limit | Filtre la limite de lignes de la propre requête du plugin qui exclut les clés méta internes adt_ de la liste déroulante « Ajouter un champ personnalisé » de l'éditeur classique. Le plugin réutilise intentionnellement ce nom de filtre exact du cœur de WordPress afin que les rappels existants qui ciblent déjà postmeta_form_limit fonctionnent de la même manière ici. |
adt_kses_allowed_tags | Filtre la liste des balises HTML autorisées transmises au JavaScript d'administration du plugin, utilisé pour la désinfection côté client. |
adt_kses_allowed_attrs | Filtre la liste des attributs HTML autorisés transmis avec adt_kses_allowed_tags au JavaScript d'administration du plugin. |
adt_show_pfp_{menu_slug}_page | Un filtre dynamique, un par page d'administration, nommé d'après le slug de menu de cette page. Retourner false masque cette page d'administration spécifique. |
adt_allowed_install_plugins | Filtre la liste des plugins sœurs autorisés à être installés via l'installateur en un clic du plugin. |
adt_pfp_setup_checklist_sister_plugins | Filtre la liste des plugins sœurs suggérés dans la liste de configuration de l'intégration. |
adt_pfp_setup_checklist_eligible | Filtre si le site actuel est éligible pour voir la liste de configuration (seules les nouvelles installations sont éligibles par défaut). |
adt_pfp_show_setup_checklist | Filtre si la liste de contrôle de configuration s'affiche ou non. |
adt_pfp_setup_checklist_steps | Filtre le tableau des étapes de la liste de contrôle d'intégration affichées sur la page Gérer les flux. |
Assainissement et sortie HTML
| Crochet | Détail |
|---|---|
adt_product_feed_allowed_html_tags | Filtre les balises HTML qui survivent à l'assainissement pour les canaux de flux qui prennent en charge un formatage HTML limité, comme Google Merchant Center. |
adt_product_feed_pure_plain_text_content | Filtre le contenu entièrement converti en texte brut utilisé pour les canaux qui nécessitent du texte brut sans HTML, comme Pinterest. |
adt_product_feed_legacy_project_hash_keyspace | Filtre l'ensemble de caractères utilisé pour générer le hachage de projet de style hérité d'un flux. |
API des capacités et suivi
Product Feed Pro enregistre un ensemble d'actions auprès de l'API des capacités de WordPress, une norme émergente pour exposer les fonctionnalités du plugin aux agents d'IA et aux outils d'automatisation.
| Crochet | Détail |
|---|---|
adt_pfp_enable_abilities | Filtre si le plugin s'enregistre auprès de l'API des capacités ou non. |
adt_pfp_ability_tracking_status | Filtre le tableau d'état du suivi et de l'intégration renvoyé par la capacité « obtenir l'état du suivi », permettant à Elite de remplacer les entrées que ce plugin de base ne possède pas, comme l'état réel de l'API de conversion Facebook. |
Ressources et type de publication
| Crochet | Détail |
|---|---|
adt_product_feed_cpt_args | Filtre les arguments d'enregistrement pour le type de publication personnalisé adt_feed interne du plugin. |
adt_product_feed_data | Filtre le tableau de données par défaut créé pour chaque nouvel objet de flux, permettant à d'autres codes d'enregistrer des propriétés par défaut supplémentaires. |
adt_product_feed_max_history_products | Filtre le nombre d'instantanés historiques du nombre de produits conservés par flux. |
adt_pfp_enable_subresource_integrity_check | Filtre si le plugin ajoute des attributs d'intégrité de sous-ressource à ses propres balises de script et de style intégrées en production. |
adt_facebook_pixel_post_id | Filtre l'ID de publication utilisé pour résoudre le produit actuel pour le suivi des événements Facebook Pixel, utile lorsque le contexte global de la publication ne correspond pas au produit réellement consulté. |
adt_pfp_enqueue_add_cart_script | Filtre si le script de suivi des clics d'ajout au panier du plugin se charge sur la page actuelle. |
Exemples de personnalisation courants
Ces exemples utilisent de vraies signatures de hooks vérifiées par rapport au code actuel du plugin. Ajoutez-les à un plugin personnalisé ou au fichier functions.php de votre thème.
Ajouter votre propre propriété de flux à l'exportation/importation
adt_pfp_export_feed_data_properties reçoit la liste des clés de propriété Product_Feed que l'outil Export/Import lit, plus le flux en cours d'exportation :
add_filter( 'adt_pfp_export_feed_data_properties', 'my_custom_export_property', 10, 2 );
function my_custom_export_property( $data_properties, $feed ) {
$data_properties[] = 'my_custom_property';
return $data_properties;
}
Toute propriété que votre code ajoute et que l'objet de flux ne possède pas réellement est ignorée en toute sécurité. Il est donc sûr de l'ajouter, même pour les propriétés qui n'existent que lorsque votre propre module complémentaire est actif.
Ajouter une ligne de paramètres à l'onglet Général
adt_general_feed_settings_after_shipping_countries se déclenche juste après la ligne « Inclure tous les pays d'expédition » dans l'onglet Général, et reçoit le flux en cours d'édition :
add_action( 'adt_general_feed_settings_after_shipping_countries', 'my_custom_general_tab_row' );
function my_custom_general_tab_row( $feed ) {
echo '<tr><td>My setting</td><td>...</td></tr>';
}
Enregistrez la valeur du nouveau champ à partir du filtre adt_edit_feed_general_tab_props, qui s'exécute lorsque le formulaire de l'onglet Général est soumis, afin que votre paramètre soit réellement écrit dans le flux.
Enregistrer et évaluer une condition de filtre personnalisée
L'ajout d'une condition personnalisée fonctionnelle au générateur de filtres et de règles nécessite deux hooks ensemble : un pour l'ajouter à la liste déroulante, et un pour l'évaluer lorsqu'un flux s'exécute.
add_filter( 'adt_pfp_get_filters_rules_conditions', 'my_custom_condition' );
function my_custom_condition( $conditions ) {
$conditions[] = array(
'value' => 'starts_with',
'label' => __( 'Starts with', 'my-textdomain' ),
);
return $conditions;
}
add_filter( 'adt_pfp_evaluate_filters_rules_condition', 'my_evaluate_starts_with', 10, 5 );
function my_evaluate_starts_with( $result, $condition, $product_value, $filter_value, $case_sensitive ) {
if ( 'starts_with' !== $condition ) {
return $result;
}
return 0 === ( $case_sensitive ? strpos( $product_value, $filter_value ) : stripos( $product_value, $filter_value ) );
}
L'enregistrement de la condition sans la gérer également dans adt_pfp_evaluate_filters_rules_condition la laisse sans effet lorsqu'un flux s'exécute, car rien n'indique au plugin comment la vérifier.
Désactiver le dimensionnement adaptatif par lots pour un flux
adt_product_feed_adaptive_batch_enabled reçoit la valeur par défaut actuelle et l'ID du flux :
add_filter( 'adt_product_feed_adaptive_batch_enabled', 'my_disable_adaptive_batching', 10, 2 );
function my_disable_adaptive_batching( $enabled, $feed_id ) {
if ( 123 === $feed_id ) {
return false;
}
return $enabled;
}
Remplacez 123 par l'ID de votre flux (visible dans l'URL de modification du flux) afin que cela n'affecte que ce flux et que tous les autres flux continuent d'utiliser le dimensionnement adaptatif.
FAQ
Dois-je lire le code source du plugin pour utiliser ces hooks ?
Non. Vous n'avez besoin que du nom du hook, du moment où il se déclenche et des arguments qu'il transmet, le tout indiqué ci-dessus.
Ces noms de hooks changeront-ils dans une future mise à jour ?
Les noms des hooks font partie de l'API publique du plugin, et AdTribes évite de les renommer sans préavis. Néanmoins, testez tout code personnalisé sur un site de staging après avoir mis à jour le plugin.
Où dois-je ajouter ce code ?
Ajoutez-le à un plugin personnalisé (spécifique au site) ou au fichier
functions.php de votre thème actif si vous n'utilisez pas de thème enfant. Ne modifiez pas directement les fichiers de Product Feed Pro, car toute modification y sera perdue lors de la prochaine mise à jour du plugin.Besoin de plus d'aide ?
Si vous utilisez Product Feed Elite ou un autre plugin premium AdTribes et que vous avez besoin d'aide pour une personnalisation spécifique, ouvrez un ticket de support et l'équipe pourra vous indiquer le hook approprié à votre cas d'utilisation.
Si vous utilisez le plugin gratuit Product Feed Pro, posez votre question sur le forum de support de WordPress.org.
