Esta página documenta todos los ganchos de acción de WordPress, los puntos finales AJAX y las programaciones cron personalizadas registradas por el plugin. Úsala como referencia cuando depures, amplíes o integres el comportamiento del plugin.
Ganchos de acción de WordPress
El complemento se conecta a las siguientes acciones de WordPress y WooCommerce para activar operaciones de sincronización y renderizar elementos de la interfaz de usuario.
Ganchos de sincronización de contactos
Estos ganchos se activan cuando el módulo Contact Sync está habilitado y la sincronización automática al registrarse está activada.
Gancho
Prioridad
Descripción
woocommerce_created_customer
10
Sincroniza un cliente de WooCommerce recién registrado con Mautic.
user_register
10
Sincroniza un usuario de WordPress recién registrado con Mautic.
profile_update
10
Sincroniza los datos actualizados del perfil de usuario con Mautic.
Ganchos de consentimiento de registro
Estos ganchos se activan cuando la función de casilla de consentimiento está habilitada en la configuración de Contact Sync.
Gancho
Prioridad
Descripción
woocommerce_register_form
10
Muestra la casilla de consentimiento de marketing en el formulario de registro de WooCommerce.
register_form
10
Muestra la casilla de consentimiento de marketing en el formulario de registro de WordPress.
woocommerce_created_customer
5
Guarda el valor de la casilla de consentimiento en la meta del usuario cuando un cliente de WooCommerce se registra.
user_register
5
Guarda el valor de la casilla de consentimiento en la meta del usuario cuando un usuario de WordPress se registra.
Ganchos de sincronización de pedidos
Estos ganchos se activan cuando el módulo Order Sync está habilitado.
Gancho
Prioridad
Descripción
woocommerce_order_status_changed
99
Activa la sincronización de datos de pedidos con Mautic cuando cambia el estado de un pedido. Envía datos de contacto, JSON del pedido, etiquetas, valor de por vida, notas opcionales y activadores de correo electrónico opcionales.
woocommerce_subscription_status_updated
100
Gestiona las actualizaciones de estado de WooCommerce Subscriptions (requiere el complemento WooCommerce Subscriptions).
Ganchos para carritos abandonados
Estos ganchos se activan cuando se habilita el módulo Carrito abandonado.
Gancho
Prioridad
Descripción
wp_enqueue_scripts
10
Añade a la cola el JavaScript y el CSS de captura de carritos abandonados en la página de pago.
woocommerce_after_checkout_billing_form
10
Muestra la casilla de consentimiento del RGPD en la página de pago (cuando el RGPD está habilitado y la captura silenciosa está desactivada).
template_redirect
10
Maneja las URL de recuperación de carritos (?mautic_woo_recover=TOKEN). Restaura el contenido del carrito y redirige a la página de pago.
woocommerce_checkout_order_processed
10
Marca los carritos abandonados como recuperados cuando se realiza un pedido con una dirección de correo electrónico coincidente.
Ganchos de autenticación
Gancho
Prioridad
Descripción
admin_init
10
Gestiona la devolución de llamada OAuth2 cuando Mautic redirige con un código de autorización.
Ganchos de administración y interfaz de usuario
Gancho
Prioridad
Descripción
admin_menu
10
Registra la página de configuración en WooCommerce y el menú de administración de Mautic WooCommerce de nivel superior.
admin_enqueue_scripts
10
Añade CSS y JavaScript de administración a las páginas de configuración del complemento.
admin_notices
10
Muestra avisos administrativos para comprobaciones de requisitos (versión de PHP, WooCommerce ausente) y avisos transitorios.
Ganchos de activos frontend
Gancho
Prioridad
Descripción
wp_enqueue_scripts
10
Registra el formulario de suscripción JavaScript y CSS (se carga solo cuando se utiliza el código corto).
wp_enqueue_scripts
10
Pone en cola el JavaScript de captura de formularios en todas las páginas frontend (cuando la captura de formularios está habilitada).
Filtro Cron
Filtro
Descripción
cron_schedules
Registra un personalizado fifteen_minutes Intervalo cron (900 segundos) utilizado por el procesador de carritos abandonados.
Puntos finales AJAX
Todos los puntos finales AJAX se registran a través del complemento. Ajax clase. Cada punto final requiere un nonce válido (mautic_woo_nonce) aprobada como la nonce Parámetro POST. Los puntos finales exclusivos para administradores también requieren el parámetro manage_woocommerce capacidad. Las respuestas se devuelven como JSON a través de wp_send_json_success() o wp_send_json_error().
Conexión
Nombre de la acción
Acceso
Descripción
mautic_woo_test_connection
Solo para administradores
Prueba la conexión con la instancia de Mautic configurada recuperando un único contacto. Devuelve el estado de éxito y el recuento total de contactos.
Campos de Mautic
Nombre de la acción
Acceso
Descripción
mautic_woo_check_fields
Solo para administradores
Comprueba si existen campos personalizados en Mautic. Devuelve un mapa de estado de los alias de campo (mautic_woo_order_data, mautic_woo_cart_data, mautic_woo_recovery_url, mautic_woo_total_spent, mautic_woo_order_count, mautic_woo_coupon_code) con valores booleanos.
mautic_woo_create_fields
Solo para administradores
Crea todos los campos personalizados necesarios en Mautic que aún no existen. Devuelve el recuento de campos creados y cualquier error.
Sincronización masiva
Nombre de la acción
Acceso
Descripción
mautic_woo_start_bulk_sync
Solo para administradores
Inicia una sincronización masiva de todos los usuarios de WooCommerce con Mautic. Inicializa el estado transitorio de la sincronización y devuelve el recuento total de usuarios.
mautic_woo_bulk_sync_status
Solo para administradores
Devuelve el progreso actual de la sincronización masiva (total, sincronizado, errores, estado). Si la sincronización está en curso, también procesa el siguiente lote de 5 usuarios antes de devolver el progreso actualizado.
mautic_woo_cancel_bulk_sync
Solo para administradores
Cancela una sincronización masiva en curso y desprograma cualquier lote cron pendiente.
mautic_woo_preview_bulk_sync
Solo para administradores
Devuelve una vista previa de los datos asignados para los primeros 10 usuarios sin sincronizarlos realmente.
Formulario de suscripción
Nombre de la acción
Acceso
Descripción
mautic_woo_subscribe
Público (nopriv)
Gestiona los envíos de formularios de suscripción. Acepta email y opcional tag Parámetros POST. Crea o actualiza un contacto en Mautic con la dirección de correo electrónico y aplica la etiqueta especificada junto con la etiqueta predeterminada de la configuración. Este punto final está disponible tanto para usuarios registrados como para usuarios no registrados.
Carrito abandonado
Nombre de la acción
Acceso
Descripción
mautic_woo_capture_cart
Público (nopriv)
Captura los datos del carrito desde la página de pago a través de AJAX. Guarda o actualiza el contenido del carrito, el correo electrónico, el ID de sesión y el estado de consentimiento del RGPD en la tabla de la base de datos de carritos abandonados. Este punto final está disponible tanto para usuarios registrados como para usuarios no registrados.
Herramientas
Nombre de la acción
Acceso
Descripción
mautic_woo_migrate_wootic
Solo para administradores
Migra la configuración del complemento Wootic heredado. Lee el antiguo mautic_woocommerce_settings_* opciones y las asigna al nuevo formato de configuración unificado. Devuelve el recuento de configuraciones migradas.
mautic_woo_cleanup_legacy
Solo para administradores
Elimina todas las opciones de configuración heredadas de Wootic de la base de datos después de la migración. Devuelve el recuento de opciones eliminadas.
mautic_woo_clear_sync_log
Solo para administradores
Trunca la tabla de la base de datos del registro de sincronización y elimina todas las entradas.
mautic_woo_get_sync_log
Solo para administradores
Recupera entradas de registro de sincronización paginadas. Acepta page y per_page Parámetros POST (por defecto: página 1, 25 por página, máximo 100). Devuelve filas, recuento total, página actual y páginas totales.
Programaciones Cron personalizadas
El plugin registra los siguientes eventos cron de WordPress. Todos los eventos cron se borran automáticamente cuando se desactiva el plugin.
Gancho Cron
Intervalo
Descripción
mautic_woo_process_abandoned_carts
Cada 15 minutos
Busca los carritos que han estado inactivos más allá del tiempo de espera configurado, los marca como abandonados y los sincroniza con Mautic. Aplica la etiqueta de carrito abandonado, envía los datos del carrito en formato JSON, establece la URL de recuperación, genera opcionalmente un código de cupón y añade el contacto a un segmento de Mautic si está configurado.
mautic_woo_cleanup_old_carts
Diario
Elimina de la base de datos los registros de carritos abandonados con más de 90 días de antigüedad. También limpia los cupones de recuperación caducados cuando la generación de cupones está habilitada.
mautic_woo_bulk_sync_batch
Bajo demanda
Procesa lotes de usuarios durante una operación de sincronización masiva. Este evento se programa dinámicamente cuando se inicia una sincronización masiva y se desprograma cuando la sincronización finaliza o se cancela.
URL de recuperación
El complemento registra un parámetro de consulta personalizado para la recuperación del carrito. Cuando un visitante carga cualquier página con el mautic_woo_recover parámetro de consulta, el complemento intercepta la solicitud en el template_redirect gancho, restaura el contenido del carrito, aplica opcionalmente un cupón de recuperación y redirige al visitante a la página de pago.
