Product Feed Pro activa un gran conjunto de ganchos de acción y filtro de WordPress durante la creación del feed, la generación del feed y las pantallas de administración. Úsalos para agregar tus propios campos al editor de feeds, cambiar qué datos van en un feed o extender la interfaz de usuario de administración del plugin sin editar los archivos del plugin directamente.
Además, Product Feed Elite y otros complementos de AdTribes dependen de muchos de los mismos ganchos para extender Product Feed Pro. Cuando un gancho existe específicamente para que un complemento pueda conectarse al comportamiento principal, se indica a continuación.
Cómo encajan los ganchos en el pipeline del feed
Una ejecución de generación de feed tiene tres etapas: el plugin resuelve la configuración del feed y comienza un lote de productos, itera sobre los productos y construye la fila de datos de cada uno, luego escribe las filas terminadas en el archivo de feed y finaliza. Los ganchos en Generación de feed y procesamiento por lotes y la mayoría de los filtros de Datos del producto y salida del feed se activan durante la etapa intermedia, una vez por producto o una vez por lote. Los ganchos en Asistente de edición de feed y Páginas de administración, configuraciones y avisos solo se activan cuando alguien está usando la administración de WordPress (creando, editando o administrando un feed), no durante una actualización programada del feed. Ten esto en cuenta al elegir un gancho: un filtro que cambia los datos de un producto solo afecta a las futuras generaciones de feeds, mientras que una acción vinculada a la pantalla de edición de feed solo se ejecuta cuando una persona está trabajando activamente en esa pantalla.
Acciones
Las acciones son ganchos que WordPress ejecuta en puntos específicos durante la ejecución, o cuando ocurren eventos específicos.
Páginas de administración, menús y avisos
| Gancho | Detalle |
|---|---|
adt_pfp_help_menu_items | Se activa al final del menú desplegable Ayuda en el encabezado de administración del plugin, después de los enlaces de Recursos integrados. Permite a Elite y otros complementos agregar sus propios elementos de menú de Ayuda. Debido a que el encabezado se renderiza en cada página de administración de Product Feed, tu callback necesita delimitar su propia salida a las páginas donde debería aparecer. |
adt_license_page_enqueue_scripts | Se activa al final de la carga de scripts de la página de Licencia, permitiendo a los complementos cargar sus propios scripts o estilos en esa pantalla. |
adt_license_page_content | Se activa dentro del área de contenido de la pestaña de la página de Licencia. Recibe el ID de la pestaña activa y la lista completa de pestañas registradas, para que cada complemento pueda renderizar su propio contenido de pestaña solo cuando su pestaña esté activa. |
adt_pfp_settings_page_tab_content | Se activa después de que se renderiza el contenido de la pestaña de la página de Configuración integrada, permitiendo que otro código agregue contenido para la pestaña activa, incluida una pestaña personalizada no integrada en Product Feed Pro. |
adt_pfp_settings_page_export_import_tab_content | Se dispara al final de la pestaña Configuración → Exportar/Importar, después de la opción integrada “sobrescribir feeds existentes”, para complementos que deseen agregar sus propios controles de exportación/importación. |
adt_edit_feed_tab_content | Se dispara después de que se renderiza la plantilla de contenido de la pestaña Editar feed integrada, permitiendo que otro código agregue contenido para la pestaña activa. |
adt_pfp_manage_feeds_before_title | Se dispara dentro del contenedor de la página Administrar feeds, encima del título de la página. |
adt_pfp_manage_feeds_after_title | Se dispara inmediatamente junto al título de la página “Administrar feeds”, para insertar contenido al lado del encabezado. |
adt_manage_feeds_table_row_actions | Se dispara dentro de la celda Acciones de cada fila en la tabla Administrar feeds. Recibe el objeto del feed para esa fila, para que los complementos puedan agregar sus propios enlaces de acción por feed. |
adt_pfp_after_display_admin_notice_generic | Se dispara inmediatamente después de que se renderiza un aviso genérico de Product Feed, permitiéndote agregar marcado adicional después de él. |
adt_pfp_notice_updated | Se dispara después de que cambia el valor almacenado de un aviso de administrador, por ejemplo, cuando un usuario lo descarta o pospone. |
adt_pfp_before_dismiss_admin_notice | Se dispara al inicio del manejador AJAX “descartar aviso de administrador”, antes de que se actualice el valor almacenado del aviso. |
adt_after_register_adt_product_feed_post_type | Se dispara justo después de que el plugin registra su tipo de publicación personalizado interno adt_feed, para que otro código pueda depender de forma segura de que el tipo de publicación ya esté disponible. |
adt_after_migrate_to_custom_post_type | Se dispara después de que finaliza la migración única de datos de feeds heredados al tipo de publicación personalizado adt_feed, activada desde la página de Configuración. |
adt_after_install_activate_plugin | Se dispara después de que el manejador AJAX “instalar y activar” de la lista de verificación de configuración intenta descargar y activar un plugin hermano. Recibe el slug del plugin solicitado y el resultado de la instalación. |
Ciclo de vida del feed: crear, clonar, eliminar y cancelar
| Gancho | Detalle |
|---|---|
adt_create_product_feed_before_save | Se dispara justo antes de que se guarde un feed recién creado, cuando un feed se crea a través del flujo de creación de feeds heredado. Esta es tu última oportunidad para cambiar el objeto del feed antes de que se escriba en la base de datos. |
adt_clone_product_feed_before_save | Se dispara justo antes de que se guarde un feed clonado, en todos los lugares donde se puede duplicar un feed (la acción de clonación única, la acción de duplicación masiva, WP-CLI y la API de Habilidades). Recibe la clonación en memoria y el feed original del que se clonó. |
adt_after_clone_product_feed | Se dispara justo después de que se ha guardado un feed clonado y se ha registrado su programación de actualización, a través de los mismos puntos de entrada de clonación que adt_clone_product_feed_before_save. |
adt_before_delete_product_feed | Se dispara inmediatamente antes de que se elimine un feed, antes de que se destruyan sus datos. Se dispara de la misma manera desde la interfaz de administración, WP-CLI y la API de Habilidades. |
adt_after_delete_product_feed | Se dispara inmediatamente después de que se ha eliminado un feed, desde los mismos puntos de entrada que adt_before_delete_product_feed. |
adt_before_cancel_product_feed | Se dispara inmediatamente antes de que se restablezca el estado de ejecución de un feed en curso y su estado cambie a Detenido. |
adt_after_cancel_product_feed | Se dispara justo después de que se haya cancelado el procesamiento de un feed, se haya guardado y se haya puesto en cola su tarea de actualización de estadísticas. |
Asistente para editar feed: procesamiento de pestañas
Cada pestaña de la pantalla Editar feed dispara un par de ganchos cuando se envía su formulario: un filtro que puedes usar para cambiar lo que se guarda y una acción que se dispara justo después de que se guarda. Todos ellos también se disparan desde la acción equivalente de la API de Habilidades donde exista.
| Gancho | Detalle |
|---|---|
adt_after_process_general_tab_form | Se dispara después de guardar la configuración de la pestaña General. Recibe el feed guardado, las propiedades que se aplicaron y una copia del feed tal como estaba antes del cambio. |
adt_after_process_filters_rules_tab_form | Se dispara después de que la pestaña combinada heredada Filtros y Reglas se guarde (solo relevante en sitios que todavía usan la configuración adt_use_legacy_filters_and_rules). |
adt_after_process_filters_tab_form | Se dispara después de que se guarde la pestaña Filtros. |
adt_after_process_rules_tab_form | Se dispara después de que se guarde la pestaña Reglas. |
adt_after_process_field_mapping_tab_form | Se dispara después de que se guarde la pestaña Mapeo de campos. |
adt_after_process_category_mapping_tab_form | Se dispara después de que se guarde la pestaña Mapeo de categorías. |
adt_after_process_conversion_analytics_tab_form | Se dispara después de guardar la configuración UTM de la pestaña Conversión y Analítica. |
adt_process_tab_form | Se dispara como respaldo cuando la pestaña enviada no coincide con ninguna de las pestañas integradas de Product Feed Pro, lo que permite a Elite u otros complementos manejar el procesamiento de formularios para sus propias pestañas personalizadas. |
Puntos de inyección de plantilla del asistente para editar feed
| Gancho | Detalle |
|---|---|
adt_antes_de_la_página_administrar_product_feed | Se dispara cerca de la parte superior de cada pestaña en el asistente Editar feed, antes de que se renderice el contenido de esa pestaña. Recibe un número $step que indica qué pestaña está activa actualmente (0 para General, 1 para Mapeo de categorías, 4 para Filtros y Reglas, 5 para Conversión y Analítica, 7 para Mapeo de campos), para que tu callback pueda dirigirse a una pestaña específica. |
adt_configuración_general_del_feed_antes_del_campo_país | Se dispara en la pestaña General, justo antes de la fila del campo País. |
adt_configuración_general_del_feed_después_de_los_países_de_envío | Se dispara en la pestaña General, inmediatamente después de la fila “Incluir todos los países de envío”. Esto es nuevo en Product Feed Pro 13.5.7. Es cómo Product Feed Elite añade su interruptor “Mostrar solo el método de envío más barato por país”, lo que lo convierte en un lugar probado para añadir tu propia fila a la pestaña General. |
adt_configuración_general_del_feed_después_del_intervalo_de_actualización | Se dispara en la pestaña General, justo después de la fila del intervalo de actualización. |
Generación de feeds y procesamiento por lotes
| Gancho | Detalle |
|---|---|
woosea_antes_de_obtener_productos | Se dispara una vez por lote de generación de feeds, justo después de que se resuelvan los atributos, reglas y filtros del feed, y justo antes de que el plugin comience a consultar productos. |
adt_antes_de_crear_el_feed_xml_de_yandex | Se dispara inmediatamente antes de que el plugin construya la estructura XML raíz para un feed en formato Yandex. |
adt_antes_del_procesamiento_por_lotes_de_product_feed | Se dispara justo antes de que se procese cada lote de productos durante la generación del feed. Recibe el ID del feed, el desplazamiento actual y el tamaño del lote que se va a ejecutar. |
adt_después_de_la_generación_de_product_feed | Se dispara después de que finaliza una ejecución completa de generación de feeds y el archivo de feed final está en su lugar. Un buen hook para tareas posteriores a la generación, como notificaciones o purga de caché. |
Filtros
Los filtros son hooks que modifican datos antes de que se utilicen, ya sea un valor que se muestra en el administrador, una consulta o datos que se escriben en el archivo del feed.
Motor de filtros y reglas
Las pestañas de Filtros y Reglas de Product Feed Pro permiten al propietario de una tienda incluir, excluir o transformar productos basándose en condiciones. Estos filtros extienden ese motor.
| Gancho | Detalle |
|---|---|
adt_pfp_obtener_condiciones_de_reglas_de_filtros | Filtra la lista de condiciones de comparación disponibles al crear un filtro o regla (por ejemplo, “Contiene”, “Entre”), permitiéndote añadir tus propios tipos de condición al desplegable. |
adt_pfp_evaluar_condición_de_reglas_de_filtros | Te permite resolver un tipo de condición personalizado que la lista de condiciones del propio plugin no maneja, cuando un filtro o regla evalúa un producto. Devuelve true o false para resolverlo, o pasa el null entrante para recurrir al valor predeterminado del plugin (las condiciones no manejadas pasan por defecto). Úsalo junto con adt_pfp_get_filters_rules_conditions. Registrar una condición en el desplegable sin manejarla también aquí hace que la condición no haga nada cuando se ejecuta un feed. |
adt_pfp_obtener_atributos_de_reglas_de_filtros | Filtra la lista agrupada de atributos ofrecidos en los desplegables del constructor de Filtros y Reglas. Recibe la lista de atributos, el canal del feed, si estás creando un filtro o una regla, y el feed en sí (null para un feed que aún no se ha guardado). |
adt_pfp_obtener_acciones_de_reglas | Filtra la lista de acciones disponibles en el desplegable “entonces” de una Regla (como “Establecer valor” o “Combinar campos”), permitiéndote registrar tus propias acciones de regla. |
adt_pfp_aplicar_acciones_de_reglas | Filtra los datos del feed de un producto después de que se hayan aplicado las acciones configuradas de una regla. |
adt_pfp_procesar_acción_de_reglas | Filtra los datos del feed de un producto después de que se procesa una acción de regla individual, dentro del bucle que ejecuta cada acción por turno. |
adt_pfp_filtrar_datos_de_product_feed | Filtra los datos finales de un producto después de que se hayan ejecutado los filtros del feed. Esto también se activa desde el motor de filtros heredado y, dos veces, desde el generador de feeds de reseñas de productos de Google. |
adt_pfp_posible_omitir_filtro | Filtra si una regla de filtro heredada específica debe omitirse por completo, en sitios que todavía utilizan el motor de filtros heredado. |
adt_pfp_producto_de_feed_filtrado_pasado | Filtra si un producto ha superado todas las reglas de filtro heredadas del feed en general. |
Datos del producto y salida del feed
| Gancho | Detalle |
|---|---|
adt_obtener_datos_del_producto | Filtra la matriz de datos completa de un solo producto, justo antes de que se pase al motor de filtros y reglas y luego al archivo del feed. Este es el gancho principal para cambiar cualquier cosa sobre cómo aparece un producto en un feed. |
adt_feed_obtener_atributos | Filtra la lista de mapeo de atributos configurada del feed, tanto al inicio de la generación del feed como de nuevo por producto durante el cálculo del valor. |
adt_product_feed_obtener_argumentos_de_consulta_de_productos | Filtra los argumentos completos de WP_Query utilizados para obtener el lote de productos para la generación del feed. |
adt_product_feed_obtener_id_de_producto | Filtra el ID del producto que se está procesando para el elemento actual en el bucle, justo antes de que el plugin cargue el objeto del producto. |
adt_product_feed_filtrar_visibilidad_del_catálogo | Filtra la lista de valores de visibilidad del catálogo que deberían excluir un producto del feed. |
adt_datos_del_producto_formato_de_disponibilidad | Filtra el valor final de disponibilidad (como "en stock" o "sin stock") para un producto, después de que se haya ejecutado el mapeo específico del canal del propio plugin. |
adt_product_feed_datos_precio_redondeado_número_de_decimales | Filtra el número de decimales utilizados cuando el plugin calcula las variantes de precio redondeado para un producto. |
adt_product_feed_datos_precio_redondeado_precisiones | Filtra la precisión de redondeo que se pasa a round() de PHP para esas variantes de precio redondeado. |
adt_product_feed_datos_precio_redondeado_modo | Filtra la constante de modo de redondeo de PHP (por ejemplo, PHP_ROUND_HALF_UP) utilizada para las variantes de precio redondeado. |
adt_product_feed_moneda_de_la_cuota | Filtra el código de moneda utilizado al generar el texto de las cuotas "compra ahora, paga después" de un producto. |
adt_merkandi_niveles_de_precios | Filtra una lista de niveles de precios basados en la cantidad para un producto con formato Merkandi, para integraciones de venta al por mayor o precios por cantidad. Cuando esto devuelve una matriz no vacía, el plugin muestra un bloque de precios en lugar de un precio fijo. |
adt_pfp_feed_de_compras_de_google_enlace_de_canal | Filtra el enlace del sitio escrito en la cabecera del archivo del feed con formato Google Shopping. |
adt_pfp_enlace_de_canal_del_feed | Filtra el elemento de enlace a nivel de canal para los formatos de feed Yandex, Zap.co.il, Salidzini.lv y Pinterest RSS Board. |
Cabecera CSV de Product Feed Pro | Filtra la cadena de la fila de encabezado justo antes de que se escriba como la primera línea de un feed en formato CSV o TXT. |
Datos de fila CSV de Product Feed Pro | Filtra la matriz de valores que componen una sola fila CSV o TXT, justo antes de que se escriba en el archivo del feed. |
Producto JSONL de Product Feed Pro | Filtra los datos de un solo producto antes de que se agreguen al lote, solo para feeds en formato JSONL y JSONL.GZ. |
Productos de vista previa de Product Feed Pro | Filtra el número objetivo de productos a incluir cuando se genera un feed en modo de vista previa (el valor predeterminado es 5). |
Tamaño de lote de vista previa de Product Feed Pro | Filtra el tamaño del lote de consulta utilizado al consultar repetidamente productos en modo de vista previa hasta alcanzar el recuento objetivo. |
Máx. consultas de vista previa de Product Feed Pro | Filtra el número máximo de consultas por lotes que el modo de vista previa ejecuta antes de rendirse. |
Matriz de códigos UTM de Product Feed Pro | Filtra la matriz de parámetros UTM de Google Analytics antes de que se ensamblen en una cadena de consulta y se anexen al enlace del feed de un producto. |
Añadir código UTM a Product Feed Pro | Filtra la cadena de consulta UTM final ensamblada, justo antes de que se anexe al enlace del feed de un producto. |
Tamaño de lote adaptativo
Novedad en Product Feed Pro 13.5.7. En lugar de un número fijo de productos por lote, el plugin ahora puede dimensionar cada lote automáticamente según el tiempo que tardó el lote anterior y la memoria que utilizó. Estos filtros te dan control sobre ese comportamiento.
| Gancho | Detalle |
|---|---|
Habilitado el lote adaptativo de Product Feed Pro | Filtra si el tamaño de lote adaptativo se utiliza en absoluto para un feed (el valor predeterminado está habilitado, a menos que el usuario haya fijado manualmente un tamaño de lote en la configuración del feed). Devuelve false para revertir ese feed al comportamiento anterior de tamaño fijo sin cambiar ninguna configuración. Este es el filtro al que recurrir primero al diagnosticar si el dimensionamiento adaptativo está involucrado en un problema de generación de feed. |
Tamaño del lote de Product Feed Pro | Filtra el tamaño inicial del lote para un feed, antes de que el dimensionamiento adaptativo se active para lotes posteriores. |
Presupuesto de tiempo del lote de Product Feed Pro | Filtra el presupuesto de tiempo por lote, en segundos, que el dimensionamiento adaptativo intenta no superar. |
Límite de memoria (bytes) de Product Feed Pro | Filtra el límite de memoria, en bytes, utilizado por el protector de memoria de dimensionamiento adaptativo. Devolver 0 deshabilita el protector de memoria. |
Tamaño del siguiente lote adaptativo de Product Feed Pro | Filtra el tamaño que el plugin calculó para el siguiente lote, dándote la última palabra sobre el valor adaptado. |
Umbral de advertencia de memoria de Product Feed Pro | Filtra el umbral de memoria, en bytes, que activa una advertencia de memoria baja en los registros durante el procesamiento por lotes (solo se activa cuando el registro está habilitado). |
Exportar e importar
| Gancho | Detalle |
|---|---|
Propiedades de datos de exportación de Product Feed Pro | Filtra la lista de claves de propiedades del feed incluidas cuando se exporta un feed a través de la herramienta Exportar/Importar. Novedad en Product Feed Pro 13.5.7, por lo que un complemento puede registrar sus propias propiedades de feed y hacer que pasen por exportación e importación. Cualquier propiedad que un feed no tenga realmente se omite de forma segura. |
Importar fuentes de AdTribes | Activa una acción, no un filtro, cuando un usuario hace clic en Importar Feeds en la herramienta Exportar/Importar. Product Feed Pro en sí no incluye lógica de importación, por lo que Elite y otros complementos se enganchan aquí para realizar la importación real. |
Actualizar antes de guardar la fuente versión 13.3.5 de Product Feed Pro | Filtra un objeto de feed durante la rutina de actualización única que migró los feeds heredados basados en cron al tipo de publicación de feed actual. Solo relevante si estás personalizando esa ruta de migración histórica. |
Datos de envío
| Gancho | Detalle |
|---|---|
Moneda del coste de envío de Product Feed Pro | Filtra el código de moneda utilizado al calcular el costo de envío para un feed. |
Precio del producto de envío de Product Feed Pro | Filtra el precio del producto utilizado como base para los cálculos de tarifas de envío. |
Datos de envío de Product Feed Pro | Filtra la matriz completa de datos de envío para un producto, la salida final del pipeline de datos de envío. |
Países de envío de Product Feed Pro | Filtra la lista resuelta de países para las zonas de envío configuradas como "Todas partes". |
Paquete de envío de Product Feed Pro | Filtra el paquete de envío sintético construido internamente antes de que se pase al cálculo de tarifas de WooCommerce. |
Matriz de envío de Product Feed Pro | Filtra una entrada de método de envío individual antes de que se agregue a los datos de envío de un producto. Se activa una vez por tarifa, tanto para métodos de envío regulares como para recogida local. |
Aplicar impuesto de envío | Filtra si se aplica el impuesto además del costo de envío calculado. |
Convertir coste de envío de Product Feed Pro | Filtra el valor bruto del costo de envío antes de que se formatee para el feed. |
Argumentos de localización de precio de coste de envío de Product Feed Pro | Filtra los argumentos utilizados al formatear el costo de envío en su cadena de visualización final. |
Tiene cupón de envío gratuito de Product Feed Pro | Un filtro de cortocircuito que le permite anular la detección propia del plugin de un cupón de envío gratuito activo, utilizado al evaluar las reglas de Envío Gratuito. Devuelve true o false para anular, o null para permitir que el plugin ejecute su propia verificación. |
Precios, moneda y formato
| Gancho | Detalle |
|---|---|
Moneda del producto de AdTribes | Filtra el código de moneda utilizado al generar los datos del feed de un producto. |
Moneda de Product Feed Pro | Filtra el código de moneda utilizado para resolver los marcadores {{CURRENCY}} en la pestaña Mapeo de campos. |
Datos de localización de precios de Product Feed Pro | Filtra los datos del feed de un producto después de que sus campos de precio se hayan localizado para su visualización. |
adt_product_feed_localize_price_args | Filtra los argumentos pasados al formato de precios de WooCommerce al localizar un precio para la salida del feed. |
adt_pfp_format_date | Filtra la cadena de fecha formateada final utilizada en la salida del feed, después de que ya se haya aplicado el formato de fecha específico del canal. |
adt_format_refresh_interval_manage_feeds_table | Filtra las etiquetas del intervalo de actualización (como "Cada hora") que se muestran en la tabla Administrar feeds. |
adt_product_feed_refresh_interval_labels | Filtra el mismo tipo de etiquetas de intervalo de actualización, utilizadas por una parte diferente de la interfaz de administración. |
adt_product_feed_refresh_interval_options | Filtra la lista de opciones de intervalo de actualización que se ofrecen en el menú desplegable de la pestaña General. |
Categorías, atributos y mapeo de campos
| Gancho | Detalle |
|---|---|
adt_pfp_get_categories_dropdown_args | Filtra los argumentos de get_terms() utilizados para crear el menú desplegable de categorías de productos en el generador de Filtros y Reglas. |
adt_pfp_get_categories_dropdown | Filtra la lista de términos de categoría devueltos para ese mismo menú desplegable, después de que se ejecute la consulta. |
adt_product_feed_attributes | Filtra la lista maestra de atributos estándar disponibles para el mapeo de campos. |
adt_product_feed_dynamic_attributes | Filtra la lista de atributos basados en taxonomías personalizadas que se ofrecen en la interfaz de mapeo de campos. |
adt_product_feed_custom_attributes | Filtra la lista de atributos de producto personalizados (no de taxonomía) que se ofrecen para el mapeo de campos, almacenados en caché durante 24 horas. |
adt_product_feed_field_mapping_prefix_replace | Filtra el mapa de reemplazo de marcadores (como {{CURRENCY}}) utilizado para resolver tokens en el valor de prefijo de una fila de mapeo de campos. |
adt_product_feed_field_mapping_suffix_replace | Filtra el mismo tipo de mapa de reemplazo para el valor Sufijo de una fila de mapeo de campo. |
Pedidos y ventas retroactivos
| Gancho | Detalle |
|---|---|
adt_total_product_orders_lookback_today | Filtra la fecha de referencia "hoy" utilizada al calcular la ventana retroactiva de pedidos para el atributo Pedidos totales de productos. |
adt_total_product_orders_lookback_today_limit | Filtra la fecha límite más temprana utilizada para consultar qué pedidos cuentan para esa retrospectiva. |
adt_total_product_orders_lookback_allowed_products | Filtra la lista final de IDs de productos y variaciones considerados "pedidos recientemente" para esa función. |
adt_variation_total_sales_enable_cache | Filtra si el plugin almacena en caché el recuento total de ventas de una variación. |
adt_variation_total_sales_cache_expiration | Filtra cuánto tiempo, en segundos, se mantiene el valor de ventas totales en caché. |
adt_invalidate_variation_sales_cache_ids | Filtra qué IDs de variación tienen su valor de ventas totales en caché borrado cuando cambia el estado de un pedido. |
Páginas de administración, configuraciones y avisos
| Gancho | Detalle |
|---|---|
adt_pfp_admin_capability | Filtra la capacidad de WordPress requerida para acceder a cada página de administración de Product Feed Pro (por defecto es manage_options). Se aplica de manera consistente en cada clase de página de administración, por lo que cambiarlo en un lugar cambia el acceso en todas partes. |
adt_manage_product_feed_allowed_roles | Filtra una lista adicional de roles de usuario, además de la verificación de capacidad anterior, permitidos para administrar feeds. |
adt_license_page_tabs | Filtra las pestañas que se muestran en la página de administración de Licencia. Product Feed Pro en sí no agrega pestañas, por lo que Elite y otros complementos registran sus pestañas de licencia aquí. |
adt_pfp_settings_page_tabs | Filtra la lista de pestañas en la página de administración de Configuración. |
adt_general_settings_args | Filtra las definiciones de campos que se renderizan en la pestaña General de la página de Configuración. |
adt_settings_other_settings_args | Filtra las definiciones de campos para la pestaña "Otras configuraciones" de la página de Configuración. |
adt_admin_plugin_page_title | Filtra el título de la página de administración de nivel superior "Administrar feeds". |
adt_admin_plugin_menu_title | Filtra el texto de la etiqueta del elemento del menú de administración de nivel superior del plugin (mostrado como “Product Feed” en la barra lateral de WordPress). |
adt_pfp_feed_polling_interval | Filtra la frecuencia, en milisegundos, con la que la página Administrar Feeds consulta al servidor para obtener actualizaciones del estado de generación de los feeds. |
adt_manage_feeds_row_actions | Filtra los enlaces de acción de fila (Actualizar, Cancelar, Eliminar, etc.) que se muestran para cada feed en la tabla Administrar Feeds. |
adt_edit_feed_get_tabs | Filtra el conjunto de pestañas que se muestran en la pantalla Editar Feed. |
adt_update_temp_product_feed | Filtra la configuración temporal no guardada del feed mientras un usuario avanza por el asistente de Edición de Feed antes de que se finalice el feed. |
adt_edit_feed_general_tab_props | Filtra los valores de las propiedades del feed que se van a guardar cuando se envía la pestaña General, justo antes de que se guarde el feed. |
adt_edit_feed_filters_rules_tab_props | Filtra los valores de las propiedades del feed que se van a guardar cuando se envía la pestaña combinada heredada de Filtros y Reglas. |
adt_edit_feed_filters_tab_props | Filtra los valores de las propiedades del feed que se van a guardar cuando se envía la pestaña Filtros. |
adt_edit_feed_rules_tab_props | Filtra los valores de las propiedades del feed que se van a guardar cuando se envía la pestaña Reglas. |
adt_edit_feed_field_mapping_tab_props | Filtra los valores de las propiedades del feed que se van a guardar cuando se envía la pestaña Mapeo de Campos. |
adt_edit_feed_category_mapping_tab_props | Filtra los valores de las propiedades del feed que se van a guardar cuando se envía la pestaña Mapeo de Categorías. |
adt_edit_feed_conversion_analytics_tab_props | Filtra los valores de las propiedades del feed que se van a guardar cuando se envía la pestaña Conversión y Analíticas. |
adt_pfp_autoloaded_ajax_settings | Filtra qué configuraciones, cuando se guardan a través del punto final de configuración AJAX del plugin, se almacenan con autoload habilitado. |
adt_pfp_allowed_ajax_settings | Filtra la lista de permitidos de nombres de opciones que el punto final AJAX tiene permiso para actualizar, de modo que los plugins complementarios puedan extenderla con sus propias opciones con prefijo adt_. |
adt_pfp_regenerate_action_schedulers_count | Filtra el recuento en ejecución de feeds regenerados durante la rutina del administrador "regenerar planificadores", lo que permite a los complementos agregar sus propias acciones planificadas al total. |
adt_pfp_cron_notices_data | Filtra la lista de definiciones de avisos impulsados por cron, permitiendo que Elite y otros complementos registren sus propios avisos de administrador. |
adt_pfp_show_notice | Filtra si se debe mostrar un aviso de administrador específico, según su clave, contexto y datos. |
adt_pfp_get_all_admin_notices | Filtra la lista final de avisos de administrador devuelta a la interfaz de usuario del administrador. |
adt_pfp_show_get_elite_notice | Filtra si se muestra el aviso de venta adicional "Get Elite". |
adt_pfp_show_notice_bar_lite | Filtra si la barra de avisos de la versión gratuita se muestra en las páginas de administración del plugin. |
pfp_notice_bar_lite_upgrade_link | Filtra la URL "Upgrade to Elite" que se muestra en esa barra de avisos. A diferencia de la mayoría de los hooks en este plugin, este no utiliza el prefijo adt_. |
adt_pfp_show_logo_upgrade_button | Filtra si el botón "Upgrade to Elite" del logo se muestra en la interfaz de usuario del administrador. |
adt_is_plugin_page | Filtra si la pantalla de administración actual cuenta como una página de Product Feed Pro o Elite, utilizada para controlar la carga de activos específicos del plugin. |
postmeta_form_limit | Filtra el límite de filas en la consulta propia del plugin que excluye las claves meta internas adt_ del desplegable "Add Custom Field" del editor clásico. El plugin reutiliza intencionadamente este nombre de filtro exacto del núcleo de WordPress para que las devoluciones de llamada existentes que ya se dirigen a postmeta_form_limit funcionen de la misma manera aquí. |
adt_kses_allowed_tags | Filtra la lista de etiquetas HTML permitidas pasadas al JavaScript de administración del plugin, utilizado para la sanitización del lado del cliente. |
adt_kses_allowed_attrs | Filtra la lista de atributos HTML permitidos pasados junto con adt_kses_allowed_tags al JavaScript de administración del plugin. |
adt_show_pfp_{menu_slug}_page | Un filtro dinámico, uno por página de administración, con el nombre del slug del menú de esa página. Devolver false oculta esa página de administración específica. |
adt_allowed_install_plugins | Filtra la lista de plugins hermanos permitidos para ser instalados a través del instalador de un clic del plugin. |
adt_pfp_setup_checklist_sister_plugins | Filtra la lista de plugins hermanos sugeridos en la lista de verificación de configuración de incorporación. |
adt_pfp_setup_checklist_eligible | Filtra si el sitio actual es elegible para ver la lista de verificación de configuración (solo las instalaciones nuevas son elegibles por defecto). |
adt_pfp_show_setup_checklist | Filtra si la lista de configuración se muestra o no. |
adt_pfp_setup_checklist_steps | Filtra la matriz de pasos de la lista de configuración que se muestran en la página Administrar fuentes. |
Sanitización y salida HTML
| Gancho | Detalle |
|---|---|
adt_product_feed_allowed_html_tags | Filtra qué etiquetas HTML sobreviven a la sanitización para canales de fuentes que admiten formato HTML limitado, como Google Merchant Center. |
adt_product_feed_pure_plain_text_content | Filtra el contenido completamente convertido a texto plano utilizado para canales que requieren texto plano sin HTML, como Pinterest. |
adt_product_feed_legacy_project_hash_keyspace | Filtra el conjunto de caracteres utilizado para generar el hash de proyecto de estilo heredado de una fuente. |
API de habilidades y seguimiento
Product Feed Pro registra un conjunto de acciones con la API de habilidades de WordPress, un estándar emergente para exponer la funcionalidad del plugin a agentes de IA y herramientas de automatización.
| Gancho | Detalle |
|---|---|
adt_pfp_enable_abilities | Filtra si el plugin se registra o no en la API de habilidades. |
adt_pfp_ability_tracking_status | Filtra la matriz de estado de seguimiento e integración devuelta por la habilidad "obtener estado de seguimiento", lo que permite a Elite anular entradas que este plugin base no posee, como el estado real de la API de conversiones de Facebook. |
Recursos y tipo de publicación
| Gancho | Detalle |
|---|---|
adt_product_feed_cpt_args | Filtra los argumentos de registro para el tipo de publicación interna adt_feed del plugin. |
adt_product_feed_data | Filtra la matriz de datos predeterminada creada para cada objeto de fuente nuevo, lo que permite que otro código registre propiedades predeterminadas adicionales. |
adt_product_feed_max_history_products | Filtra cuántas instantáneas históricas del recuento de productos se conservan por fuente. |
adt_pfp_enable_subresource_integrity_check | Filtra si el plugin agrega atributos de integridad de subrecurso a sus propias etiquetas de script y estilo creadas en producción. |
adt_facebook_pixel_post_id | Filtra el ID de publicación utilizado para resolver el producto actual para el seguimiento de eventos de Facebook Pixel, útil cuando el contexto global de la publicación no coincide con el producto real que se está viendo. |
adt_pfp_enqueue_add_cart_script | Filtra si el script de seguimiento de clics de "agregar al carrito" del plugin se carga en la página actual. |
Ejemplos de personalización comunes
Estos ejemplos usan firmas de gancho reales verificadas contra el código actual del plugin. Agrégalas a un plugin personalizado o al functions.php de tu tema.
Añadir tu propia propiedad de feed a Exportar/Importar
adt_pfp_export_feed_data_properties recibe la lista de claves de propiedad de Product_Feed que la herramienta Exportar/Importar lee, además del feed que se está exportando:
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;
}
Cualquier propiedad que tu código añada y que el objeto del feed no tenga realmente se omite de forma segura, por lo que es seguro añadirla incluso para propiedades que solo existen cuando tu propio complemento está activo.
Añadir una fila de configuración a la pestaña General
adt_general_feed_settings_after_shipping_countries se dispara justo después de la fila “Incluir todos los países de envío” en la pestaña General, y recibe el feed que se está editando:
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>';
}
Guarda el valor del nuevo campo del filtro adt_edit_feed_general_tab_props, que se ejecuta cuando se envía el formulario de la pestaña General, para que tu configuración se escriba realmente en el feed.
Registrar y evaluar una condición de filtro personalizada
Añadir una condición personalizada funcional al constructor de Filtros y Reglas requiere dos ganchos juntos: uno para añadirla al desplegable y otro para evaluarla cuando se ejecuta un feed.
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 ) );
}
Registrar la condición sin manejarla también en adt_pfp_evaluate_filters_rules_condition hace que no haga nada cuando se ejecuta un feed, ya que nada le dice al plugin cómo comprobarla.
Desactivar el tamaño de lote adaptativo para un feed
adt_product_feed_adaptive_batch_enabled recibe el valor predeterminado actual y el 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;
}
Reemplaza 123 con el ID de tu feed (visible en la URL de edición del feed) para que esto solo afecte a ese feed y los demás sigan usando el tamaño adaptativo.
Preguntas frecuentes
¿Necesito leer el código fuente del plugin para usar estos ganchos?
No. Solo necesitas el nombre del gancho, cuándo se dispara y qué argumentos pasa, todo ello listado arriba.
¿Cambiarán estos nombres de gancho en una futura actualización?
Los nombres de los ganchos son parte de la API pública del plugin, y AdTribes evita renombrarlos sin previo aviso. Aun así, prueba cualquier código personalizado en un sitio de staging después de actualizar el plugin.
¿Dónde añado este código?
Añádelo a un plugin personalizado (específico del sitio), o al
functions.php de tu tema activo si no estás usando un tema hijo. No edites los archivos de Product Feed Pro directamente, ya que cualquier cambio allí se pierde en la próxima actualización del plugin.¿Necesitas más ayuda?
Si estás en Product Feed Elite u otro plugin premium de AdTribes y necesitas ayuda con una personalización específica, abre un ticket de soporte y el equipo podrá indicarte el gancho adecuado para tu caso de uso.
Si estás usando el plugin gratuito Product Feed Pro, haz tu pregunta en el foro de soporte de WordPress.org.
