Aktionen & Filter

PrimoCRM stellt WordPress-Aktionen (Ereignisse, auf die Sie reagieren können) und Filter (Werte und Registries, die Sie modifizieren können) bereit. Alle Hooks verwenden das Präfix primocrm_.

Action-Hooks (Ereignisse)

Reagieren Sie darauf mit add_action.

Kontakt-Lebenszyklus

Hook	Argumente	Wird ausgeführt, wenn
`primocrm_contact_created`	`$contact_id`	Ein Kontakt erstellt wird
`primocrm_contact_updated`	`$contact_id, $changed_keys`	Ein Kontakt aktualisiert wird (`$changed_keys` sind die geänderten Feldnamen)
`primocrm_contact_status_changed`	`$contact_id, $new_status, $old_status`	Der Status eines Kontakts sich ändert
`primocrm_contact_unsubscribed`	`$contact_id`	Ein Kontakt sich abmeldet
`primocrm_contact_tag_added`	`$contact_id, $tag_id`	Ein Tag zugewiesen wird
`primocrm_contact_tag_removed`	`$contact_id, $tag_id`	Ein Tag entfernt wird
`primocrm_contact_list_added`	`$contact_id, $list_id`	Zu einer Liste hinzugefügt wird
`primocrm_contact_list_removed`	`$contact_id, $list_id`	Aus einer Liste entfernt wird

Interaktion und Formulare

Hook	Argumente	Wird ausgeführt, wenn
`primocrm_form_submitted`	`$form_id, $entry_id, $contact_id, $data`	Ein PrimoCRM-Formular verarbeitet wird
`primocrm_email_opened`	`$contact_id, $campaign_id`	Das Öffnen einer E-Mail erfasst wird
`primocrm_email_link_clicked`	`$contact_id, $campaign_id, $url`	Ein erfasster Link geklickt wird

System

Hook	Argumente	Wird ausgeführt, wenn
`primocrm_loaded`	keine	Innerhalb der REST-Routen-Registrierung. Ein Katalog-Handshake, kein zuverlässiger Boot-Hook
`primocrm_pro_downgraded`		Eine Pro-Lizenz verloren geht oder abläuft
`primocrm_pro_resumed`		Eine Pro-Lizenz wiederhergestellt wird
`primocrm_ab_evaluate_winners`		Der Cron-Job, der A/B-Gewinner auswertet

Beispiel:

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

Filter-Hooks (Registries)

Diese sammeln erweiterbare Elemente. Vollständige Rezepte finden Sie unter PrimoCRM erweitern.

Filter	Wert	Zweck
`primocrm_automation_triggers`	array	Automatisierungsauslöser registrieren oder modifizieren
`primocrm_automation_actions`	array	Automatisierungsaktionen registrieren oder modifizieren
`primocrm_condition_options`	array (`fields`, `operators`)	Felder und Operatoren für den Bedingungs-Builder hinzufügen
`primocrm_form_field_types`	array (Typ zu Klasse)	Benutzerdefinierte Formularfeldtypen registrieren
`primocrm_migration_sources`	array (Schlüssel zu Quelle)	Migrationsquellen-Anbieter registrieren
`primocrm_smtp_send`	`$result, $provider, $atts, $settings`	Einen E-Mail-Sender bereitstellen (wie sich ESP-Anbieter einklinken)
`primocrm_ab_manager`	object	Die Implementierung des A/B-Test-Managers bereitstellen

Filter-Hooks (Zugangskontrolle)

Filter	Wert	Zweck
`primocrm_free_triggers`	array von Schlüsseln	Welche Auslöser kostenlos sind (für den Rest standardmäßig gesperrt)
`primocrm_free_actions`	array von Schlüsseln	Welche Aktionen kostenlos sind
`primocrm_free_limits`	array	Obergrenzen für Ressourcen im kostenlosen Tarif
`primocrm_upgrade_url`	string	Die URL, auf die Upgrade-Hinweise verlinken

Filter-Hooks (Verhalten und Optimierung)

Filter	Wert	Zweck
`primocrm_send_batch_size`	int	E-Mails pro Kampagnen-Worker-Batch
`primocrm_send_rate_per_hour`	int	Kampagnen-Versandlimit
`primocrm_automation_batch_limit`	int	Zeilen pro Automatisierungs-Worker-Batch
`primocrm_email_body_retention_days`	int	Aufbewahrungsdauer für gerenderte E-Mail-Inhalte
`primocrm_async_automation_delivery`	bool	Asynchronen Versand von Automatisierungs-E-Mails umschalten
`primocrm_auto_create_contact_status`	`$status, $source`	Status für Kontakte, die automatisch durch Auslöser oder Benutzersynchronisierung erstellt wurden
`primocrm_trust_proxy_headers`	bool	Ob Proxy-Header für die Absender-IP in Formularen vertraut werden soll

White-Label-Markenschnittstellen

Filter	Wert	Zweck
`primocrm_brand_name`	string	Der im Admin-Bereich angezeigte Markenname
`primocrm_brand_menu_icon`	string	Das Admin-Menüsymbol
`primocrm_brand`	array	Der für die App lokalisierte Markendeskriptor

JavaScript-Hooks (wp.hooks)

Die Admin-App stellt zwei JavaScript-Filter über wp.hooks bereit, damit Add-ons Benutzeroberflächen injizieren können. Diese geben Deskriptoren mit Mount-Callbacks zurück und keine React-Elemente, da die App und Add-ons unterschiedliche React-Versionen ausführen können.

Filter	Zweck
`primocrm.settings.tabs`	Einen Tab zum Einstellungsbildschirm hinzufügen
`primocrm.campaigns.rowActions`	Eine Aktion zu einer Kampagnenzeile hinzufügen