Azioni e Filtri

PrimoCRM espone azioni WordPress (eventi a cui è possibile reagire) e filtri (valori e registri che è possibile modificare). Tutti gli hook utilizzano il prefisso primocrm_.

Hook di azione (eventi)

Reagisci a questi eventi utilizzando add_action.

Ciclo di vita dei contatti

Hook	Argomenti	Si attiva quando
`primocrm_contact_created`	`$contact_id`	Viene creato un contatto
`primocrm_contact_updated`	`$contact_id, $changed_keys`	Un contatto viene aggiornato (`$changed_keys` sono i nomi dei campi modificati)
`primocrm_contact_status_changed`	`$contact_id, $new_status, $old_status`	Lo stato di un contatto cambia
`primocrm_contact_unsubscribed`	`$contact_id`	Un contatto annulla l’iscrizione
`primocrm_contact_tag_added`	`$contact_id, $tag_id`	Viene applicata un’etichetta
`primocrm_contact_tag_removed`	`$contact_id, $tag_id`	Viene rimossa un’etichetta
`primocrm_contact_list_added`	`$contact_id, $list_id`	Aggiunto a una lista
`primocrm_contact_list_removed`	`$contact_id, $list_id`	Rimosso da una lista

Coinvolgimento e moduli

Hook	Argomenti	Si attiva quando
`primocrm_form_submitted`	`$form_id, $entry_id, $contact_id, $data`	Viene elaborato un modulo di PrimoCRM
`primocrm_email_opened`	`$contact_id, $campaign_id`	Viene tracciata l’apertura di un’email
`primocrm_email_link_clicked`	`$contact_id, $campaign_id, $url`	Viene fatto clic su un link tracciato

Sistema

Hook	Argomenti	Si attiva quando
`primocrm_loaded`	nessuno	Durante la registrazione delle rotte REST. Un handshake del catalogo, non un hook di avvio affidabile
`primocrm_pro_downgraded`		Una licenza Pro viene persa o scade
`primocrm_pro_resumed`		Una licenza Pro viene ripristinata
`primocrm_ab_evaluate_winners`		Il controllo cron che valuta i vincitori dei test A/B

Esempio:

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

Hook di filtro (registri)

Questi raccolgono elementi estendibili. Ricette complete sono disponibili in Estendere PrimoCRM.

Filtro	Valore	Scopo
`primocrm_automation_triggers`	array	Registra o modifica i trigger di automazione
`primocrm_automation_actions`	array	Registra o modifica le azioni di automazione
`primocrm_condition_options`	array (`fields`, `operators`)	Aggiunge campi e operatori per la creazione di condizioni
`primocrm_form_field_types`	array (da tipo a classe)	Registra tipi di campo personalizzati per i moduli
`primocrm_migration_sources`	array (da chiave a origine)	Registra i provider di origine per la migrazione
`primocrm_smtp_send`	`$result, $provider, $atts, $settings`	Fornisce un mittente di email (modalità di integrazione dei provider ESP)
`primocrm_ab_manager`	object	Fornisce l’implementazione del gestore di test A/B

Hook di filtro (limitazioni)

Filtro	Valore	Scopo
`primocrm_free_triggers`	array di chiavi	Quali trigger sono gratuiti (chiuso per gli altri)
`primocrm_free_actions`	array di chiavi	Quali azioni sono gratuite
`primocrm_free_limits`	array	Limiti numerici del piano gratuito per risorsa
`primocrm_upgrade_url`	string	L’URL a cui puntano i prompt di aggiornamento

Hook di filtro (comportamento e ottimizzazione)

Filtro	Valore	Scopo
`primocrm_send_batch_size`	int	Email per batch del worker delle campagne
`primocrm_send_rate_per_hour`	int	Limitazione dell’invio delle campagne
`primocrm_automation_batch_limit`	int	Righe per batch del worker di automazione
`primocrm_email_body_retention_days`	int	Per quanto tempo vengono conservati i corpi delle email di cui è stato eseguito il rendering
`primocrm_async_automation_delivery`	bool	Attiva o disattiva la consegna asincrona delle email di automazione
`primocrm_auto_create_contact_status`	`$status, $source`	Stato per i contatti creati automaticamente da trigger o sincronizzazione utente
`primocrm_trust_proxy_headers`	bool	Indica se considerare attendibili gli header proxy per l’IP di chi invia i moduli

Personalizzazione dell’interfaccia (White-label)

Filtro	Valore	Scopo
`primocrm_brand_name`	string	Il nome del brand mostrato nell’amministrazione
`primocrm_brand_menu_icon`	string	L’icona del menu di amministrazione
`primocrm_brand`	array	Il descrittore del brand localizzato per l’applicazione

Hook JavaScript (wp.hooks)

L’applicazione di amministrazione espone due filtri JavaScript tramite wp.hooks per consentire ai componenti aggiuntivi di iniettare interfaccia utente. Questi restituiscono descrittori con callback di montaggio, non elementi React, poiché l’applicazione e i componenti aggiuntivi potrebbero eseguire versioni diverse di React.

Filtro	Scopo
`primocrm.settings.tabs`	Aggiunge una scheda alla schermata Impostazioni
`primocrm.campaigns.rowActions`	Aggiunge un’azione a una riga di campagna