الإجراءات والمرشحات

يكشف PrimoCRM عن إجراءات ووردبريس (أحداث يمكنك التفاعل معها) والمرشحات (القيم والسجلات التي يمكنك تعديلها). تستخدم جميع الخطافات البادئة primocrm_.

خطافات الإجراءات (الأحداث)

تفاعل مع هذه باستخدام add_action.

دورة حياة جهة الاتصال

الخطاف	الوسائط	يُطلق عند
`primocrm_contact_created`	`$contact_id`	إنشاء جهة اتصال
`primocrm_contact_updated`	`$contact_id, $changed_keys`	تحديث جهة اتصال (`$changed_keys` هي أسماء الحقول التي تم تغييرها)
`primocrm_contact_status_changed`	`$contact_id, $new_status, $old_status`	تغير حالة جهة الاتصال
`primocrm_contact_unsubscribed`	`$contact_id`	إلغاء اشتراك جهة اتصال
`primocrm_contact_tag_added`	`$contact_id, $tag_id`	تطبيق وسوم
`primocrm_contact_tag_removed`	`$contact_id, $tag_id`	إزالة وسوم
`primocrm_contact_list_added`	`$contact_id, $list_id`	الإضافة إلى قائمة
`primocrm_contact_list_removed`	`$contact_id, $list_id`	الإزالة من قائمة

التفاعل والنماذج

الخطاف	الوسائط	يُطلق عند
`primocrm_form_submitted`	`$form_id, $entry_id, $contact_id, $data`	معالجة نموذج PrimoCRM
`primocrm_email_opened`	`$contact_id, $campaign_id`	تتبع فتح البريد الإلكتروني
`primocrm_email_link_clicked`	`$contact_id, $campaign_id, $url`	النقر على رابط متتبع

النظام

الخطاف	الوسائط	يُطلق عند
`primocrm_loaded`	لا يوجد	داخل تسجيل مسار REST. مصافحة كتالوج وليست خطاف تمهيد موثوق
`primocrm_pro_downgraded`		فقدان ترخيص الإصدار الاحترافي أو انتهائه
`primocrm_pro_resumed`		استعادة ترخيص الإصدار الاحترافي
`primocrm_ab_evaluate_winners`		نبضة الكرون التي تقيم الفائزين في اختبار أ/ب

مثال:

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

خطافات المرشحات (السجلات)

تجمع هذه العناصر القابلة للتوسيع. الوصفات الكاملة موجودة في توسيع PrimoCRM.

المرشح	القيمة	الغرض
`primocrm_automation_triggers`	مصفوفة	تسجيل أو تعديل مشغلات الأتمتة
`primocrm_automation_actions`	مصفوفة	تسجيل أو تعديل إجراءات الأتمتة
`primocrm_condition_options`	مصفوفة (`fields`, `operators`)	إضافة حقول ومعاملات منشئ الشروط
`primocrm_form_field_types`	مصفوفة (النوع إلى الفئة)	تسجيل أنواع حقول نماذج مخصصة
`primocrm_migration_sources`	مصفوفة (المفتاح إلى المصدر)	تسجيل مزودي مصادر النقل
`primocrm_smtp_send`	`$result, $provider, $atts, $settings`	توفير مرسل بريد إلكتروني (كيفية ارتباط مزودي خدمة البريد الإلكتروني)
`primocrm_ab_manager`	كائن	توفير تنفيذ مدير اختبار أ/ب

خطافات المرشحات (البوابة)

المرشح	القيمة	الغرض
`primocrm_free_triggers`	مصفوفة من المفاتيح	المشغلات المجانية (مع إغلاق تلقائي للباقي)
`primocrm_free_actions`	مصفوفة من المفاتيح	الإجراءات المجانية
`primocrm_free_limits`	مصفوفة	حدود عدد الخطة المجانية لكل مورد
`primocrm_upgrade_url`	سلسلة نصية	عنوان URL الذي ترتبط به مطالبات الترقية

خطافات المرشحات (السلوك والضبط)

المرشح	القيمة	الغرض
`primocrm_send_batch_size`	عدد صحيح	عدد رسائل البريد الإلكتروني لكل دفعة عامل حملة
`primocrm_send_rate_per_hour`	عدد صحيح	معدل إرسال الحملة
`primocrm_automation_batch_limit`	عدد صحيح	عدد الصفوف لكل دفعة عامل أتمتة
`primocrm_email_body_retention_days`	عدد صحيح	مدة الاحتفاظ بمحتويات البريد الإلكتروني المعروضة
`primocrm_async_automation_delivery`	منطقي	تبديل التسليم غير المتزامن لرسائل الأتمتة
`primocrm_auto_create_contact_status`	`$status, $source`	حالة جهات الاتصال التي يتم إنشاؤها تلقائياً بواسطة المشغلات أو مزامنة المستخدم
`primocrm_trust_proxy_headers`	منطقي	ما إذا كان يجب وثوق رؤوس الوكيل لعنوان IP الخاص بالمرسل في النماذج

حدود العلامة التجارية ذات العلامة البيضاء

المرشح	القيمة	الغرض
`primocrm_brand_name`	سلسلة نصية	اسم العلامة التجارية المعروض في لوحة التحكم
`primocrm_brand_menu_icon`	سلسلة نصية	أيقونة قائمة لوحة التحكم
`primocrm_brand`	مصفوفة	محدد العلامة التجارية المترجم للتطبيق

خطافات جافا سكريبت (wp.hooks)

يوفر تطبيق لوحة التحكم مرشحين لجافا سكريبت عبر wp.hooks لكي تتمكن الإضافات من حقن واجهة المستخدم. تُرجع هذه المحددات ردود نداء التثبيت وليست عناصر React، لأن التطبيق والإضافات قد تشغل إصدارات React مختلفة.

المرشح	الغرض
`primocrm.settings.tabs`	إضافة تبويب إلى شاشة الإعدادات
`primocrm.campaigns.rowActions`	إضافة إجراء إلى صف الحملة