Acciones y Filtros

PrimoCRM expone acciones de WordPress (eventos a los que puedes reaccionar) y filtros (valores y registros que puedes modificar). Todos los ganchos usan el prefijo primocrm_.

Ganchos de acción (eventos)

Reacciona a estos con add_action.

Ciclo de vida del contacto

Gancho	Argumentos	Se ejecuta cuando
`primocrm_contact_created`	`$contact_id`	Se crea un contacto
`primocrm_contact_updated`	`$contact_id, $changed_keys`	Se actualiza un contacto (`$changed_keys` son los nombres de los campos modificados)
`primocrm_contact_status_changed`	`$contact_id, $new_status, $old_status`	Cambia el estado de un contacto
`primocrm_contact_unsubscribed`	`$contact_id`	Un contacto cancela su suscripción
`primocrm_contact_tag_added`	`$contact_id, $tag_id`	Se aplica una etiqueta
`primocrm_contact_tag_removed`	`$contact_id, $tag_id`	Se elimina una etiqueta
`primocrm_contact_list_added`	`$contact_id, $list_id`	Se añade a una lista
`primocrm_contact_list_removed`	`$contact_id, $list_id`	Se elimina de una lista

Interacción y formularios

Gancho	Argumentos	Se ejecuta cuando
`primocrm_form_submitted`	`$form_id, $entry_id, $contact_id, $data`	Se procesa un formulario de PrimoCRM
`primocrm_email_opened`	`$contact_id, $campaign_id`	Se registra la apertura de un correo electrónico
`primocrm_email_link_clicked`	`$contact_id, $campaign_id, $url`	Se hace clic en un enlace rastreado

Sistema

Gancho	Argumentos	Se ejecuta cuando
`primocrm_loaded`	ninguno	Durante el registro de rutas REST. Un intercambio del catálogo, no un gancho de arranque fiable
`primocrm_pro_downgraded`		Se pierde o caduca una licencia Pro
`primocrm_pro_resumed`		Se restaura una licencia Pro
`primocrm_ab_evaluate_winners`		El cron que evalúa a los ganadores de A/B

Ejemplo:

add_action( 'primocrm_contact_created', function ( $contact_id ) {
    error_log( "New PrimoCRM contact: {$contact_id}" );
} );

add_action( 'primocrm_email_link_clicked', function ( $contact_id, $campaign_id, $url ) {
    // Score the contact, notify a channel, etc.
}, 10, 3 );

Ganchos de filtro (registros)

Estos recopilan elementos extensibles. Las recetas completas se encuentran en Extending PrimoCRM.

Filtro	Valor	Propósito
`primocrm_automation_triggers`	array	Registrar o modificar activadores de automatización
`primocrm_automation_actions`	array	Registrar o modificar acciones de automatización
`primocrm_condition_options`	array (`fields`, `operators`)	Añadir campos y operadores al creador de condiciones
`primocrm_form_field_types`	array (tipo a clase)	Registrar tipos de campos de formulario personalizados
`primocrm_migration_sources`	array (clave a origen)	Registrar proveedores de origen de migración
`primocrm_smtp_send`	`$result, $provider, $atts, $settings`	Proporcionar un remitente de correo electrónico (cómo se conectan los proveedores de ESP)
`primocrm_ab_manager`	object	Proporcionar la implementación del administrador de pruebas A/B

Ganchos de filtro (limitación de acceso)

Filtro	Valor	Propósito
`primocrm_free_triggers`	array de claves	Qué activadores son gratuitos (por defecto cerrados para el resto)
`primocrm_free_actions`	array de claves	Qué acciones son gratuitas
`primocrm_free_limits`	array	Límites de recuento del plan gratuito por recurso
`primocrm_upgrade_url`	string	La URL a la que enlazan los avisos de actualización

Ganchos de filtro (comportamiento y ajuste)

Filtro	Valor	Propósito
`primocrm_send_batch_size`	int	Correos electrónicos por lote del proceso de campañas
`primocrm_send_rate_per_hour`	int	Límite de velocidad de envío de campañas
`primocrm_automation_batch_limit`	int	Filas por lote del proceso de automatización
`primocrm_email_body_retention_days`	int	Cuánto tiempo se conservan los cuerpos de los correos electrónicos generados
`primocrm_async_automation_delivery`	bool	Alternar la entrega asíncrona de correos de automatización
`primocrm_auto_create_contact_status`	`$status, $source`	Estado para los contactos creados automáticamente por activadores o sincronización de usuarios
`primocrm_trust_proxy_headers`	bool	Si se debe confiar en las cabeceras de proxy para la IP del remitente en los formularios

Puntos de personalización de marca (White-label)

Filtro	Valor	Propósito
`primocrm_brand_name`	string	El nombre de marca mostrado en el panel de administración
`primocrm_brand_menu_icon`	string	El icono del menú de administración
`primocrm_brand`	array	El descriptor de marca localizado para la aplicación

Ganchos de JavaScript (wp.hooks)

La aplicación de administración expone dos filtros de JavaScript a través de wp.hooks para que los complementos puedan inyectar interfaz de usuario. Estos devuelven descriptores con funciones de devolución de llamada de montaje, no elementos de React, porque la aplicación y los complementos pueden ejecutar diferentes versiones de React.

Filtro	Propósito
`primocrm.settings.tabs`	Añadir una pestaña a la pantalla de Ajustes
`primocrm.campaigns.rowActions`	Añadir una acción a una fila de campaña