Casa
Knowledge Base
Personalizzazione
Ganci e filtri disponibili in Product Feed Pro

Ganci e filtri disponibili in Product Feed Pro

Product Feed Pro attiva un ampio set di hook di azione e filtro di WordPress durante la creazione, la generazione e le schermate di amministrazione del feed. Usali per aggiungere i tuoi campi all'editor del feed, modificare i dati che vanno in un feed o estendere l'interfaccia utente di amministrazione del plugin senza modificare direttamente i file del plugin.

Questo è un riferimento per sviluppatori. Si presume che tu sia a tuo agio nell'aggiungere codice tramite un plugin personalizzato o il file functions.php del tuo tema. Se sei nuovo agli hook di WordPress, leggi prima la Guida per sviluppatori di plugin WordPress sugli hook.

Inoltre, Product Feed Elite e altri add-on AdTribes si basano su molti degli stessi hook per estendere Product Feed Pro. Dove esiste un hook specificamente per consentire a un add-on di inserirsi nel comportamento principale, ciò è indicato di seguito.

Come gli hook si inseriscono nella pipeline del feed

Un'esecuzione di generazione del feed ha tre fasi: il plugin risolve le impostazioni del feed e avvia un batch di prodotti, scorre i prodotti e costruisce la riga di dati di ciascuno, quindi scrive le righe finite nel file del feed e conclude. Gli hook sotto Generazione del feed ed elaborazione batch e la maggior parte dei filtri Dati del prodotto e output del feed vengono attivati durante la fase intermedia, una volta per prodotto o una volta per batch. Gli hook sotto Creazione guidata del feed e Pagine di amministrazione, impostazioni e avvisi vengono attivati solo quando qualcuno utilizza l'amministrazione di WordPress (creando, modificando o gestendo un feed), non durante un aggiornamento pianificato del feed. Tieni presente questo quando scegli un hook: un filtro che modifica i dati di un prodotto influisce solo sulle future generazioni del feed, mentre un'azione collegata alla schermata di modifica del feed viene eseguita solo quando una persona sta attivamente lavorando in quella schermata.

Azioni

Le azioni sono hook che WordPress esegue in punti specifici durante l'esecuzione, o quando si verificano eventi specifici.

Pagine di amministrazione, menu e avvisi

Aggancio	Dettaglio
`adt_pfp_help_menu_items`	Viene attivato alla fine del menu a discesa Aiuto nell'intestazione di amministrazione del plugin, dopo i collegamenti alle Risorse integrati. Consente a Elite e ad altri add-on di aggiungere le proprie voci di menu di Aiuto. Poiché l'intestazione viene visualizzata in ogni pagina di amministrazione di Product Feed, la tua callback deve limitare il proprio output alle pagine in cui dovrebbe apparire.
`adt_license_page_enqueue_scripts`	Viene attivato alla fine dell'accodamento degli script della pagina Licenza, consentendo agli add-on di accodare i propri script o stili in quella schermata.
`adt_license_page_content`	Viene attivato all'interno dell'area del contenuto della scheda della pagina Licenza. Riceve l'ID della scheda attiva e l'elenco completo delle schede registrate, in modo che ogni add-on possa visualizzare il proprio contenuto della scheda solo quando la sua scheda è attiva.
`adt_pfp_settings_page_tab_content`	Viene attivato dopo il rendering del contenuto della scheda della pagina Impostazioni integrata, consentendo ad altro codice di aggiungere contenuto per la scheda attiva, inclusa una scheda personalizzata non integrata in Product Feed Pro.
`adt_pfp_settings_page_export_import_tab_content`	Si attiva alla fine della scheda Impostazioni → Esporta/Importa, dopo l'opzione predefinita “sovrascrivi feed esistenti”, per i componenti aggiuntivi che desiderano aggiungere i propri controlli di esportazione/importazione.
`adt_edit_feed_tab_content`	Si attiva dopo il rendering del modello di contenuto della scheda Modifica feed predefinita, consentendo ad altro codice di aggiungere contenuto per la scheda attiva.
`adt_pfp_manage_feeds_before_title`	Si attiva all'interno del wrapper della pagina Gestisci feed, sopra il titolo della pagina.
`adt_pfp_manage_feeds_after_title`	Si attiva immediatamente accanto al titolo della pagina “Gestisci feed”, per inserire contenuto accanto all'intestazione.
`adt_manage_feeds_table_row_actions`	Si attiva all'interno della cella Azioni di ogni riga nella tabella Gestisci feed. Riceve l'oggetto feed per quella riga, in modo che i componenti aggiuntivi possano aggiungere i propri link di azione per feed.
`adt_pfp_after_display_admin_notice_generic`	Si attiva subito dopo il rendering di un avviso generico di Product Feed, permettendoti di aggiungere markup aggiuntivo dopo di esso.
`adt_pfp_notice_updated`	Si attiva dopo che il valore memorizzato di un avviso di amministrazione cambia, ad esempio quando un utente lo ignora o lo rimanda.
`adt_pfp_before_dismiss_admin_notice`	Si attiva all'inizio dell'handler AJAX “ignora avviso di amministrazione”, prima che il valore memorizzato dell'avviso venga aggiornato.
`adt_after_register_adt_product_feed_post_type`	Si attiva subito dopo che il plugin registra il suo tipo di post personalizzato interno `adt_feed`, in modo che altro codice possa fare affidamento sul fatto che il tipo di post sia già disponibile.
`adt_after_migrate_to_custom_post_type`	Si attiva dopo che la migrazione una tantum dei dati dei feed legacy nel tipo di post personalizzato `adt_feed` è terminata, attivata dalla pagina Impostazioni.
`adt_after_install_activate_plugin`	Si attiva dopo che l'handler AJAX “installa e attiva” della checklist di configurazione tenta di scaricare e attivare un plugin sorella. Riceve lo slug del plugin richiesto e il risultato dell'installazione.

Ciclo di vita del feed: crea, clona, elimina e annulla

Aggancio	Dettaglio
`adt_create_product_feed_before_save`	Si attiva subito prima che un nuovo feed venga salvato, quando un feed viene creato tramite il flusso legacy di creazione feed. Questa è la tua ultima occasione per modificare l'oggetto feed prima che venga scritto nel database.
`adt_clone_product_feed_before_save`	Si attiva appena prima che un feed clonato venga salvato, in tutti i punti in cui un feed può essere duplicato (l'azione di clonazione singola, l'azione di duplicazione in blocco, WP-CLI e l'API Abilities). Riceve il clone in memoria e il feed originale da cui è stato clonato.
`adt_after_clone_product_feed`	Si attiva subito dopo che un feed clonato è stato salvato e il suo programma di aggiornamento registrato, attraverso gli stessi punti di accesso di clonazione di `adt_clone_product_feed_before_save`.
`adt_before_delete_product_feed`	Si attiva immediatamente prima che un feed venga eliminato, prima che i suoi dati vengano distrutti. Si attiva nello stesso modo dall'interfaccia di amministrazione, WP-CLI e l'API Abilities.
`adt_after_delete_product_feed`	Si attiva subito dopo l'eliminazione di un feed, dagli stessi punti di ingresso di `adt_before_delete_product_feed`.
`adt_before_cancel_product_feed`	Si attiva subito prima che lo stato di esecuzione di un feed in corso venga reimpostato e il suo stato cambi in Interrotto.
`adt_after_cancel_product_feed`	Si attiva subito dopo che l'elaborazione di un feed è stata annullata, salvata e il suo task di aggiornamento delle statistiche è stato accodato.

Procedura guidata di modifica del feed: elaborazione delle schede

Ogni scheda della schermata Modifica Feed attiva una coppia di hook quando il suo modulo viene inviato: un filtro che puoi usare per cambiare ciò che viene salvato e un'azione che si attiva subito dopo che è stato salvato. Tutti attivano anche dall'azione equivalente dell'API Abilities, ove esistente.

Aggancio	Dettaglio
`adt_after_process_general_tab_form`	Si attiva dopo il salvataggio delle impostazioni della scheda Generale. Riceve il feed salvato, le proprietà che sono state applicate e una copia del feed com'era prima della modifica.
`adt_after_process_filters_rules_tab_form`	Si attiva dopo il salvataggio della scheda combinata legacy Filtri e Regole (rilevante solo sui siti che utilizzano ancora l'impostazione `adt_use_legacy_filters_and_rules`).
`adt_after_process_filters_tab_form`	Si attiva dopo il salvataggio della scheda Filtri.
`adt_after_process_rules_tab_form`	Si attiva dopo il salvataggio della scheda Regole.
`adt_after_process_field_mapping_tab_form`	Si attiva dopo il salvataggio della scheda Mappatura Campi.
`adt_after_process_category_mapping_tab_form`	Si attiva dopo il salvataggio della scheda Mappatura Categorie.
`adt_after_process_conversion_analytics_tab_form`	Si attiva dopo il salvataggio delle impostazioni UTM della scheda Conversioni e Analisi.
`adt_process_tab_form`	Si attiva come fallback quando la scheda inviata non corrisponde a nessuna delle schede integrate di Product Feed Pro, consentendo a Elite o ad altri add-on di gestire l'elaborazione dei moduli per le proprie schede personalizzate.

Procedura guidata di modifica del feed: punti di iniezione del modello

Aggancio	Dettaglio
`adt_before_product_feed_manage_page`	Si attiva in cima a ogni scheda nella procedura guidata di modifica del feed, prima che venga visualizzato il contenuto della scheda. Riceve un numero `$step` che indica quale scheda è attualmente attiva (0 per Generale, 1 per Mappatura Categorie, 4 per Filtri e Regole, 5 per Conversioni e Analisi, 7 per Mappatura Campi), in modo che la tua callback possa puntare a una scheda specifica.
`adt_general_feed_settings_before_country_field`	Si attiva nella scheda Generale, appena prima della riga del campo Paese.
`adt_general_feed_settings_after_shipping_countries`	Si attiva nella scheda Generale, subito dopo la riga “Includi tutti i paesi di spedizione”. Questa è una novità di Product Feed Pro 13.5.7. È così che Product Feed Elite aggiunge il suo interruttore “Mostra solo il metodo di spedizione più economico per paese”, che lo rende un punto collaudato per aggiungere la propria riga alla scheda Generale.
`adt_general_feed_settings_after_refresh_interval`	Si attiva nella scheda Generale, subito dopo la riga dell’intervallo di aggiornamento.

Generazione del feed ed elaborazione batch

Aggancio	Dettaglio
`woosea_before_get_products`	Si attiva una volta per batch di generazione del feed, subito dopo che gli attributi, le regole e i filtri del feed sono stati risolti e appena prima che il plugin inizi a interrogare i prodotti.
`adt_before_yandex_create_xml_feed`	Si attiva immediatamente prima che il plugin crei la struttura XML principale per un feed in formato Yandex.
`adt_before_product_feed_batch_processing`	Si attiva subito prima che ogni batch di prodotti venga elaborato durante la generazione del feed. Riceve l'ID del feed, l'offset corrente e la dimensione del batch che sta per essere eseguito.
`adt_after_product_feed_generation`	Si attiva dopo che l'intera generazione del feed è terminata e il file del feed finale è pronto. Un buon hook per attività post-generazione come notifiche o pulizia della cache.

Filtri

I filtri sono hook che modificano i dati prima che vengano utilizzati, sia che si tratti di un valore mostrato nell'amministrazione, di una query o di dati scritti nel file del feed.

Motore di filtri e regole

Le schede Filtri e Regole di Product Feed Pro consentono al proprietario di un negozio di includere, escludere o trasformare prodotti in base a condizioni. Questi filtri estendono tale motore.

Aggancio	Dettaglio
`adt_pfp_get_filters_rules_conditions`	Filtra l'elenco delle condizioni di confronto disponibili durante la creazione di un filtro o di una regola (ad esempio "Contiene", "Tra"), consentendo di aggiungere tipi di condizioni personalizzati al menu a discesa.
`adt_pfp_evaluate_filters_rules_condition`	Consente di risolvere un tipo di condizione personalizzato che l'elenco di condizioni del plugin non gestisce, quando un filtro o una regola valuta un prodotto. Restituisci `true` o `false` per risolverlo, o passa il `null` in ingresso per tornare all'impostazione predefinita del plugin (le condizioni non gestite vengono passate per impostazione predefinita). Usalo insieme a `adt_pfp_get_filters_rules_conditions`. Registrare una condizione nel menu a discesa senza gestirla anche qui lascia che la condizione non faccia nulla quando viene eseguito un feed.
`adt_pfp_get_filters_rules_attributes`	Filtra l'elenco raggruppato di attributi offerti nei menu a discesa del costruttore di Filtri e Regole. Riceve l'elenco degli attributi, il canale del feed, se si sta creando un filtro o una regola e il feed stesso (`null` per un feed non ancora salvato).
`adt_pfp_get_rules_actions`	Filtra l'elenco delle azioni disponibili nel menu a discesa "then" di una Regola (come "Imposta valore" o "Combina campi"), consentendo di registrare le proprie azioni di regola.
`adt_pfp_apply_rule_actions`	Filtra i dati del feed di un prodotto dopo che le azioni configurate di una regola sono state applicate.
`adt_pfp_process_rules_action`	Filtra i dati del feed di un prodotto dopo che una singola azione di regola è stata elaborata, all'interno del ciclo che esegue ogni azione a turno.
`adt_pfp_filter_product_feed_data`	Filtra i dati finali del feed di un prodotto dopo l'esecuzione dei filtri del feed. Questo viene attivato anche dal motore legacy dei filtri e, due volte, dal costruttore del feed di recensioni dei prodotti Google.
`adt_pfp_maybe_skip_filter`	Filtra se una specifica regola del filtro legacy debba essere saltata interamente, sui siti che utilizzano ancora il motore legacy dei filtri.
`adt_pfp_filter_passed_product_feed`	Filtra se un prodotto ha superato tutte le regole del filtro legacy del feed nel complesso.

Dati del prodotto e output del feed

Aggancio	Dettaglio
`adt_get_product_data`	Filtra l'array completo dei dati per un singolo prodotto, poco prima che venga passato al motore dei filtri e delle regole e quindi al file del feed. Questo è il gancio principale per modificare qualsiasi cosa sull'aspetto di un prodotto in un feed.
`adt_feed_get_attributes`	Filtra l'elenco di mappatura degli attributi configurato del feed, sia all'inizio della generazione del feed che di nuovo per prodotto durante il calcolo del valore.
`adt_product_feed_get_products_query_args`	Filtra gli argomenti completi di `WP_Query` utilizzati per recuperare il batch di prodotti per la generazione del feed.
`adt_product_feed_get_product_id`	Filtra l'ID del prodotto in fase di elaborazione per l'elemento corrente nel ciclo, poco prima che il plugin carichi l'oggetto prodotto.
`adt_product_feed_filter_catalog_visibility`	Filtra l'elenco dei valori di visibilità del catalogo che dovrebbero escludere un prodotto dal feed.
`adt_product_data_availability_format`	Filtra il valore finale di disponibilità (come "in stock" o "out of stock") per un prodotto, dopo che la mappatura specifica del canale del plugin è stata eseguita.
`adt_product_feed_data_rounded_price_number_of_decimals`	Filtra il numero di cifre decimali utilizzate quando il plugin calcola le varianti di prezzo arrotondato per un prodotto.
`adt_product_feed_data_rounded_price_precisions`	Filtra la precisione di arrotondamento passata a `round()` di PHP per quelle varianti di prezzo arrotondato.
`adt_product_feed_data_rounded_price_mode`	Filtra la costante di modalità di arrotondamento PHP (ad esempio `PHP_ROUND_HALF_UP`) utilizzata per le varianti di prezzo arrotondato.
`adt_product_feed_installment_currency`	Filtra il codice valuta utilizzato durante la creazione del testo della rata "compra ora, paga dopo" di un prodotto.
`adt_merkandi_pricing_tiers`	Filtra in un elenco di fasce di prezzo basate sulla quantità per un prodotto in formato Merkandi, per integrazioni di prezzi all'ingrosso o per quantità. Quando questo restituisce un array non vuoto, il plugin visualizza un blocco prezzi invece di un prezzo fisso.
`adt_pfp_google_shopping_feed_channel_link`	Filtra il link del sito scritto nell'intestazione di un file di feed in formato Google Shopping.
`adt_pfp_feed_channel_link`	Filtra l'elemento del link a livello di canale per i formati di feed Yandex, Zap.co.il, Salidzini.lv e Pinterest RSS Board.
`Intestazione CSV del feed prodotti AdTribes`	Filtra la stringa della riga di intestazione prima che venga scritta come prima riga di un feed in formato CSV o TXT.
`Dati riga CSV del feed prodotti AdTribes`	Filtra l'array di valori che compongono una singola riga CSV o TXT, prima che venga scritta nel file del feed.
`Prodotto JSONL del feed prodotti AdTribes`	Filtra i dati di un singolo prodotto prima che vengano aggiunti al batch, solo per i feed in formato JSONL e JSONL.GZ.
`Prodotti di anteprima del feed prodotti AdTribes`	Filtra il numero target di prodotti da includere quando un feed viene generato in modalità di anteprima (il valore predefinito è 5).
`Dimensione batch di anteprima del feed prodotti AdTribes`	Filtra la dimensione del batch di query utilizzata durante l'interrogazione ripetuta dei prodotti in modalità di anteprima fino al raggiungimento del conteggio target.
`Query massime di anteprima del feed prodotti AdTribes`	Filtra il numero massimo di query batch che la modalità di anteprima esegue prima di arrendersi.
`Array codice UTM del feed prodotti AdTribes`	Filtra l'array di parametri UTM di Google Analytics prima che vengano assemblati in una stringa di query e aggiunti al link del feed di un prodotto.
`Aggiungi codice UTM al feed prodotti AdTribes`	Filtra la stringa di query UTM finale assemblata, prima che venga aggiunta al link del feed di un prodotto.

Dimensionamento batch adattivo

Novità in Product Feed Pro 13.5.7. Invece di un numero fisso di prodotti per batch, il plugin ora può dimensionare ogni batch automaticamente in base a quanto tempo ha impiegato il batch precedente e quanta memoria ha utilizzato. Questi filtri ti danno il controllo su quel comportamento.

Aggancio	Dettaglio
`Adattivo abilitato per il feed prodotti AdTribes`	Filtra se il dimensionamento batch adattivo viene utilizzato per un feed (il valore predefinito è abilitato, a meno che l'utente non abbia bloccato manualmente una dimensione del batch nelle impostazioni del feed). Restituisci `false` per ripristinare quel feed al vecchio comportamento a dimensione fissa senza modificare alcuna impostazione. Questo è il filtro da utilizzare per primo quando si diagnostica se il dimensionamento adattivo è coinvolto in un problema di generazione del feed.
`Dimensione batch del feed prodotti AdTribes`	Filtra la dimensione iniziale del batch per un feed, prima che il dimensionamento adattivo prenda il sopravvento per i batch successivi.
`Budget di tempo per batch del feed prodotti AdTribes`	Filtra il budget di tempo per batch, in secondi, che il dimensionamento adattivo cerca di rispettare.
`Limite di memoria in byte del feed prodotti AdTribes`	Filtra il limite di memoria, in byte, utilizzato dalla protezione della memoria del dimensionamento adattivo. Restituire `0` disabilita la protezione della memoria.
`Dimensione batch successiva adattiva del feed prodotti AdTribes`	Filtra la dimensione che il plugin ha calcolato per il batch successivo, dandoti l'ultima parola sul valore adattato.
`Soglia di avviso memoria del feed prodotti AdTribes`	Filtra la soglia di memoria, in byte, che attiva un avviso di memoria insufficiente nei log durante l'elaborazione batch (si attiva solo quando la registrazione è abilitata).

Esporta e importa

Aggancio	Dettaglio
`Proprietà dati feed di esportazione Product Feed Pro`	Filtra l'elenco delle chiavi delle proprietà del feed incluse quando un feed viene esportato tramite lo strumento Esporta/Importa. Novità in Product Feed Pro 13.5.7, in modo che un add-on possa registrare le proprie proprietà del feed e farle passare attraverso l'esportazione e l'importazione. Qualsiasi proprietà che un feed non ha effettivamente viene saltata in sicurezza.
`Importa feed`	Attiva un'azione, non un filtro, quando un utente fa clic su Importa feed nello strumento Esporta/Importa. Product Feed Pro stesso non include la logica di importazione, quindi Elite e altri add-on si agganciano qui per eseguire l'importazione effettiva.
`Aggiorna alla versione 13.3.5 prima di salvare il feed`	Filtra un oggetto feed durante la routine di aggiornamento una tantum che ha migrato i feed legacy basati su cron al tipo di post del feed corrente. Rilevante solo se stai personalizzando quel percorso di migrazione storico.

Dati di spedizione

Aggancio	Dettaglio
`Valuta costo spedizione del feed prodotti AdTribes`	Filtra il codice valuta utilizzato quando si calcola il costo di spedizione per un feed.
`Prezzo prodotto spedizione del feed prodotti AdTribes`	Filtra il prezzo del prodotto utilizzato come base per i calcoli delle tariffe di spedizione.
`Dati spedizione del feed prodotti AdTribes`	Filtra l'array completo dei dati di spedizione per un prodotto, l'output finale della pipeline dei dati di spedizione.
`Paesi spedizione del feed prodotti AdTribes`	Filtra l'elenco risolto dei paesi per le zone di spedizione impostate su "Ovunque".
`Pacco spedizione del feed prodotti AdTribes`	Filtra il pacco di spedizione sintetico creato internamente prima che venga passato al calcolo delle tariffe di WooCommerce.
`Array spedizione del feed prodotti AdTribes`	Filtra una singola voce del metodo di spedizione prima che venga aggiunta ai dati di spedizione di un prodotto. Si attiva una volta per tariffa, sia per i metodi di spedizione regolari che per il ritiro in loco.
`Applica imposta sulla spedizione`	Filtra se l'imposta viene applicata in aggiunta al costo di spedizione calcolato.
`Converti costo spedizione del feed prodotti AdTribes`	Filtra il valore grezzo del costo di spedizione prima che venga formattato per il feed.
`Argomenti localizzazione prezzo costo spedizione del feed prodotti AdTribes`	Filtra gli argomenti utilizzati durante la formattazione del costo di spedizione nella sua stringa di visualizzazione finale.
`Coupon spedizione gratuita presente nel feed prodotti AdTribes`	Un filtro di interruzione che ti consente di sovrascrivere il rilevamento del plugin di un coupon di spedizione gratuita attivo, utilizzato durante la valutazione delle regole di spedizione gratuita. Restituisci `true` o `false` per sovrascrivere, o `null` per consentire al plugin di eseguire il proprio controllo.

Prezzi, valuta e formattazione

Aggancio	Dettaglio
`Valuta dati prodotto AdTribes`	Filtra il codice valuta utilizzato durante la creazione dei dati del feed di un prodotto.
`Valuta feed prodotti AdTribes`	Filtra il codice valuta utilizzato per risolvere i segnaposto `{{CURRENCY}}` nella scheda Mappatura campi.
`Dati localizzazione prezzi Product Feed Pro`	Filtra i dati del feed di un prodotto dopo che i suoi campi prezzo sono stati localizzati per la visualizzazione.
`adt_product_feed_localize_price_args`	Filtra gli argomenti passati alla formattazione del prezzo di WooCommerce quando si localizza un prezzo per l'output del feed.
`adt_pfp_format_date`	Filtra la stringa data formattata finale utilizzata nell'output del feed, dopo che qualsiasi formattazione della data specifica del canale è già stata eseguita.
`adt_format_refresh_interval_manage_feeds_table`	Filtra le etichette dell'intervallo di aggiornamento (come "Orario") mostrate nella tabella Gestisci feed.
`adt_product_feed_refresh_interval_labels`	Filtra lo stesso tipo di etichette dell'intervallo di aggiornamento, utilizzate da una diversa parte dell'interfaccia utente di amministrazione.
`adt_product_feed_refresh_interval_options`	Filtra l'elenco delle scelte dell'intervallo di aggiornamento offerte nel menu a discesa della scheda Generale.

Categorie, attributi e mappatura dei campi

Aggancio	Dettaglio
`adt_pfp_get_categories_dropdown_args`	Filtra gli argomenti `get_terms()` utilizzati per creare il menu a discesa delle categorie di prodotti nel costruttore di Filtri e Regole.
`adt_pfp_get_categories_dropdown`	Filtra l'elenco dei termini di categoria restituiti per lo stesso menu a discesa, dopo che la query è stata eseguita.
`adt_product_feed_attributes`	Filtra l'elenco principale degli attributi standard disponibili per la mappatura dei campi.
`adt_product_feed_dynamic_attributes`	Filtra l'elenco degli attributi basati su tassonomie personalizzate offerti nell'interfaccia utente di mappatura dei campi.
`adt_product_feed_custom_attributes`	Filtra l'elenco degli attributi di prodotto personalizzati (non tassonomici) offerti per la mappatura dei campi, memorizzati nella cache per 24 ore.
`adt_product_feed_field_mapping_prefix_replace`	Filtra la mappa di sostituzione dei segnaposto (come `{{CURRENCY}}`) utilizzata per risolvere i token nel valore Prefisso di una riga di mappatura dei campi.
`adt_product_feed_field_mapping_suffix_replace`	Filtra la stessa tipologia di mappa di sostituzione per il valore Suffisso di una riga di mappatura di campo.

Ordini e vendite lookback

Aggancio	Dettaglio
`adt_total_product_orders_lookback_today`	Filtra la data di riferimento "oggi" utilizzata quando si calcola la finestra di lookback degli ordini per l'attributo Ordini totali dei prodotti.
`adt_total_product_orders_lookback_today_limit`	Filtra la data limite più remota utilizzata per interrogare quali ordini contano per quel lookback.
`adt_total_product_orders_lookback_allowed_products`	Filtra l'elenco finale degli ID di prodotti e varianti considerati "ordinati di recente" per quella funzionalità.
`adt_variation_total_sales_enable_cache`	Filtra se il plugin memorizza nella cache il conteggio totale delle vendite di una variante.
`adt_variation_total_sales_cache_expiration`	Filtra per quanto tempo, in secondi, viene mantenuto il valore delle vendite totali memorizzato nella cache.
`adt_invalidate_variation_sales_cache_ids`	Filtra quali ID di varianti hanno il loro valore di vendite totali memorizzato nella cache cancellato quando lo stato di un ordine cambia.

Pagine di amministrazione, impostazioni e avvisi

Aggancio	Dettaglio
`adt_pfp_admin_capability`	Filtra la capacità di WordPress richiesta per accedere a ogni pagina di amministrazione di Product Feed Pro (l'impostazione predefinita è `manage_options`). Applicata in modo coerente a ogni classe di pagina di amministrazione, quindi modificarla in un punto cambia l'accesso ovunque.
`adt_manage_product_feed_allowed_roles`	Filtra un elenco aggiuntivo di ruoli utente, oltre al controllo delle capacità sopra, autorizzati a gestire i feed.
`adt_license_page_tabs`	Filtra le schede mostrate nella pagina di amministrazione Licenza. Product Feed Pro stesso non aggiunge schede, quindi Elite e altri add-on registrano qui le loro schede di licenza.
`adt_pfp_settings_page_tabs`	Filtra l'elenco delle schede nella pagina di amministrazione Impostazioni.
`adt_general_settings_args`	Filtra le definizioni dei campi visualizzate nella scheda Generale della pagina Impostazioni.
`adt_settings_other_settings_args`	Filtra le definizioni dei campi per la scheda "Altre impostazioni" della pagina Impostazioni.
`adt_admin_plugin_page_title`	Filtra il titolo della pagina di amministrazione principale "Gestisci feed".
`adt_admin_plugin_menu_title`	Filtra il testo dell'etichetta della voce di menu principale dell'amministratore del plugin (visualizzata come “Product Feed” nella barra laterale di WordPress).
`adt_pfp_feed_polling_interval`	Filtra la frequenza, in millisecondi, con cui la pagina Gestisci feed interroga il server per gli aggiornamenti dello stato di generazione del feed.
`adt_manage_feeds_row_actions`	Filtra i link di azione della riga (Aggiorna, Annulla, Elimina, ecc.) mostrati per ogni feed nella tabella Gestisci feed.
`adt_edit_feed_get_tabs`	Filtra l'insieme di schede mostrate nella schermata Modifica feed.
`adt_update_temp_product_feed`	Filtra la configurazione temporanea e non salvata del feed mentre un utente procede attraverso la procedura guidata di modifica del feed prima che il feed venga finalizzato.
`adt_edit_feed_general_tab_props`	Filtra i valori delle proprietà del feed che verranno salvati quando viene inviata la scheda Generale, poco prima del salvataggio del feed.
`adt_edit_feed_filters_rules_tab_props`	Filtra i valori delle proprietà del feed che verranno salvati quando viene inviata la scheda legacy combinata Filtri e Regole.
`adt_edit_feed_filters_tab_props`	Filtra i valori delle proprietà del feed che verranno salvati quando viene inviata la scheda Filtri.
`adt_edit_feed_rules_tab_props`	Filtra i valori delle proprietà del feed che verranno salvati quando viene inviata la scheda Regole.
`adt_edit_feed_field_mapping_tab_props`	Filtra i valori delle proprietà del feed che verranno salvati quando viene inviata la scheda Mappatura campi.
`adt_edit_feed_category_mapping_tab_props`	Filtra i valori delle proprietà del feed che verranno salvati quando viene inviata la scheda Mappatura categorie.
`adt_edit_feed_conversion_analytics_tab_props`	Filtra i valori delle proprietà del feed che verranno salvati quando viene inviata la scheda Conversioni e Analisi.
`adt_pfp_autoloaded_ajax_settings`	Filtra quali impostazioni, quando salvate tramite l'endpoint AJAX delle impostazioni del plugin, vengono memorizzate con autoload abilitato.
`adt_pfp_allowed_ajax_settings`	Filtra la lista consentita dei nomi delle opzioni che l'endpoint AJAX è autorizzato ad aggiornare, in modo che i plugin complementari possano estenderla con le proprie opzioni con prefisso `adt_`.
`adt_pfp_regenerate_action_schedulers_count`	Filtra il conteggio in esecuzione dei feed rigenerati durante la routine "rigenera scheduler" dell'amministratore, consentendo ai componenti aggiuntivi di aggiungere le proprie azioni pianificate al totale.
`adt_pfp_cron_notices_data`	Filtra l'elenco delle definizioni di avvisi basati su cron, consentendo a Elite e ad altri componenti aggiuntivi di registrare i propri avvisi di amministrazione.
`adt_pfp_show_notice`	Filtra se un determinato avviso di amministrazione debba essere visualizzato, in base alla sua chiave, contesto e dati.
`adt_pfp_get_all_admin_notices`	Filtra l'elenco finale degli avvisi di amministrazione restituiti all'interfaccia utente di amministrazione.
`adt_pfp_show_get_elite_notice`	Filtra se l'avviso di "Ottieni Elite" (upsell) debba essere visualizzato.
`adt_pfp_show_notice_bar_lite`	Filtra se la barra degli avvisi della versione gratuita debba essere visualizzata nelle pagine di amministrazione del plugin.
`pfp_notice_bar_lite_upgrade_link`	Filtra l'URL "Aggiorna a Elite" mostrato in quella barra degli avvisi. A differenza della maggior parte degli hook in questo plugin, questo non utilizza il prefisso `adt_`.
`adt_pfp_show_logo_upgrade_button`	Filtra se il pulsante "Aggiorna a Elite" del logo debba essere visualizzato nell'interfaccia utente di amministrazione.
`adt_is_plugin_page`	Filtra se la schermata di amministrazione corrente sia considerata una pagina di Product Feed Pro o Elite, utilizzata per controllare il caricamento delle risorse specifiche del plugin.
`postmeta_form_limit`	Filtra il limite di righe sulla query del plugin che esclude le chiavi meta interne `adt_` dal menu a discesa "Aggiungi campo personalizzato" dell'editor classico. Il plugin riutilizza intenzionalmente questo esatto nome del filtro dal core di WordPress in modo che i callback esistenti che già puntano a `postmeta_form_limit` funzionino allo stesso modo qui.
`adt_kses_allowed_tags`	Filtra l'elenco dei tag HTML consentiti passati al JavaScript di amministrazione del plugin, utilizzato per la sanificazione lato client.
`adt_kses_allowed_attrs`	Filtra l'elenco degli attributi HTML consentiti passati insieme a `adt_kses_allowed_tags` al JavaScript di amministrazione del plugin.
`adt_show_pfp_{menu_slug}_page`	Un filtro dinamico, uno per pagina di amministrazione, chiamato in base allo slug del menu di quella pagina. Restituire `false` nasconde quella specifica pagina di amministrazione.
`adt_allowed_install_plugins`	Filtra l'elenco dei plugin correlati consentiti per l'installazione tramite l'installatore "one-click" del plugin.
`adt_pfp_setup_checklist_sister_plugins`	Filtra l'elenco dei plugin correlati suggeriti nella checklist di configurazione dell'onboarding.
`adt_pfp_setup_checklist_eligible`	Filtra se il sito corrente è idoneo a visualizzare la checklist di configurazione (solo le nuove installazioni sono idonee per impostazione predefinita).
`adt_pfp_show_setup_checklist`	Filtra se la checklist di configurazione viene visualizzata o meno.
`adt_pfp_setup_checklist_steps`	Filtra l'array dei passaggi della checklist di onboarding mostrati nella pagina Gestisci feed.

Sanificazione e output HTML

Aggancio	Dettaglio
`adt_product_feed_allowed_html_tags`	Filtra quali tag HTML sopravvivono alla sanificazione per i canali di feed che supportano la formattazione HTML limitata, come Google Merchant Center.
`adt_product_feed_pure_plain_text_content`	Filtra il contenuto completamente convertito in testo semplice utilizzato per i canali che richiedono testo semplice senza HTML, come Pinterest.
`adt_product_feed_legacy_project_hash_keyspace`	Filtra il set di caratteri utilizzato per generare l'hash del progetto in stile legacy di un feed.

API Abilities e tracciamento

Product Feed Pro registra una serie di azioni con l'API Abilities di WordPress, uno standard emergente per esporre le funzionalità dei plugin agli agenti AI e agli strumenti di automazione.

Aggancio	Dettaglio
`abilita_pfp_adt`	Filtra se il plugin si registra o meno con l'API Abilities.
`stato_tracciamento_abilita_pfp_adt`	Filtra l'array di stato del tracciamento e dell'integrazione restituito dall'abilità "get tracking status", consentendo a Elite di sovrascrivere voci non di proprietà di questo plugin di base, come lo stato effettivo della Conversions API di Facebook.

Asset e tipo di post

Aggancio	Dettaglio
`argomenti_cpt_product_feed_adt`	Filtra gli argomenti di registrazione per il tipo di post personalizzato interno del plugin `adt_feed`.
`dati_product_feed_adt`	Filtra l'array di dati predefinito creato per ogni nuovo oggetto feed, consentendo ad altro codice di registrare proprietà predefinite aggiuntive.
`prodotti_max_cronologia_product_feed_adt`	Filtra quanti snapshot della cronologia del conteggio dei prodotti vengono conservati per feed.
`abilita_controllo_integrita_sottorisorsa_pfp_adt`	Filtra se il plugin aggiunge attributi di integrità delle sottorisorse ai propri tag script e style creati in produzione.
`id_post_pixel_facebook_adt`	Filtra l'ID del post utilizzato per risolvere il prodotto corrente per il tracciamento degli eventi di Facebook Pixel, utile quando il contesto globale del post non corrisponde al prodotto effettivo visualizzato.
`script_aggiungi_al_carrello_enqueue_pfp_adt`	Filtra se lo script di tracciamento dei clic aggiungi al carrello del plugin viene caricato nella pagina corrente.

Esempi comuni di personalizzazione

Questi esempi utilizzano firme di hook reali verificate rispetto al codice del plugin corrente. Aggiungile a un plugin personalizzato o al file functions.php del tuo tema.

Aggiungi una proprietà del tuo feed a Esporta/Importa

adt_pfp_export_feed_data_properties riceve l'elenco delle chiavi di proprietà di Product_Feed che lo strumento Esporta/Importa legge, più il feed che viene esportato:

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;
}

Qualsiasi proprietà aggiunta dal tuo codice che l'oggetto feed non possiede effettivamente viene ignorata in modo sicuro, quindi è sicuro aggiungerla anche per le proprietà che esistono solo quando il tuo add-on è attivo.

Aggiungi una riga di impostazioni alla scheda Generale

adt_general_feed_settings_after_shipping_countries viene attivato subito dopo la riga "Includi tutti i paesi di spedizione" nella scheda Generale e riceve il feed che viene modificato:

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>';
}

Salva il valore del nuovo campo dal filtro adt_edit_feed_general_tab_props, che viene eseguito quando il modulo della scheda Generale viene inviato, in modo che la tua impostazione venga effettivamente scritta nel feed.

Registra e valuta una condizione di filtro personalizzata

Aggiungere una condizione personalizzata funzionante al costruttore di Filtri e Regole richiede due hook insieme: uno per aggiungerla al menu a discesa e uno per valutarla quando un feed viene eseguito.

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 ) );
}

Registrare la condizione senza gestirla anche in adt_pfp_evaluate_filters_rules_condition la lascia inattiva quando un feed viene eseguito, poiché nulla indica al plugin come controllarla.

Disattiva il ridimensionamento batch adattivo per un feed

adt_product_feed_adaptive_batch_enabled riceve l'impostazione predefinita corrente e l'ID del feed:

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;
}

Sostituisci 123 con l'ID del tuo feed (visibile nell'URL di modifica del feed) in modo che ciò influenzi solo quel singolo feed e tutti gli altri continuino a utilizzare il ridimensionamento adattivo.

Domande frequenti

Ho bisogno di leggere il codice sorgente del plugin per usare questi hook?

No. Hai solo bisogno del nome dell'hook, di quando viene attivato e quali argomenti passa, tutto elencato sopra.

Questi nomi di hook cambieranno in un aggiornamento futuro?

I nomi degli hook fanno parte dell'API pubblica del plugin e AdTribes evita di rinominarli senza preavviso. Tuttavia, testa qualsiasi codice personalizzato su un sito di staging dopo aver aggiornato il plugin.

Dove aggiungo questo codice?

Aggiungilo a un plugin personalizzato (specifico del sito) o al file functions.php del tuo tema attivo se non stai usando un tema child. Non modificare direttamente i file di Product Feed Pro, poiché qualsiasi modifica lì andrà persa al prossimo aggiornamento del plugin.

Serve ulteriore aiuto?

Se utilizzi Product Feed Elite o un altro plugin premium di AdTribes e hai bisogno di aiuto con una personalizzazione specifica, apri un ticket di supporto e il team potrà indicarti l'hook giusto per il tuo caso d'uso.

Se stai utilizzando il plugin gratuito Product Feed Pro, poni la tua domanda sul forum di supporto di WordPress.org.

Questo articolo è stato utile?

CARATTERISTICHE

PER PIATTAFORMA

RISORSE