انتقل إلى المحتوى الرئيسي

تحرير الحدث

تحرير الحدث يتكون من ثلاث علامات تبويب:

  • الشروط
  • السمات
  • الإعدادات

الشروط

تحتوي علامة التبويب "الشروط" على حقول إدخال لتحرير الحدث. هذه هي البيانات الأساسية للحدث: الاسم و

المؤشر
، بالإضافة إلى شروط التفعيل.

الوحدات

في الشروط، يجب اختيار وحدة يتم من خلالها تحديد شرط إرسال الحدث. الوحدات المتاحة هي:

  • catalog
  • forms
  • orders
  • users

الشروط لوحدة catalog

بالنسبة لوحدة catalog، يمكنك في حقل type اختيار التصفية حسب الحالات، ثم اختيار حالة معينة — وبهذا ستشترك في حدث تغيير حالة عناصر الكتالوج.
بدلاً من ذلك، يمكنك الاشتراك في حدث حسب مجموعات السمات واختيار سمة معينة.

الشروط لوحدة forms

بالنسبة لوحدة forms، يجب اختيار نوع النموذج الذي سيتم إضافة الحدث إليه. الخيارات المتاحة هي:

  • التسجيل
    يتم إنشاء الحدث عند تسجيل مستخدم جديد عبر واجهة برمجة التطبيقات أو في نظام إدارة المحتوى.
  • إرسال الرمز
    يتم إنشاء الحدث عند توليد رمز تأكيد جديد للمستخدم (بما في ذلك التسجيل).
  • تغيير كلمة المرور
    يتم إنشاء الحدث عند تغيير كلمة المرور من قبل المستخدم.
  • إرسال بيانات النموذج
    يتم إنشاء الحدث عند إرسال بيانات النموذج المحدد عبر واجهة برمجة التطبيقات.

بالنسبة لـ إرسال بيانات النموذج، يجب اختيار نموذج (من النماذج ذات النوع "تقديم البيانات") وسمة قمت بإضافتها للبريد الإلكتروني (لا تنطبق هذه الاشتراك على السمات الأخرى). عند إرسال النموذج، يتم إرسال البيانات إلى البريد الإلكتروني المحدد في هذه السمة.
لمزيد من المعلومات حول النماذج — في الفصل النماذج.

تتضمن جميع الأحداث من وحدة forms معلومات عن المستخدم. تحتوي أحداث التسجيل وإرسال الرمز أيضًا على رمز التأكيد.

الشروط لوحدة orders

بالنسبة لوحدة orders، يجب اختيار مستودع الطلبات المحدد والحالة التي سيتم ربط الحدث بتغييرها.

الشروط لوحدة users

بالنسبة لوحدة users، يجب اختيار التصفية حسب مجموعات السمات وتحديد سمة معينة سيتم ربط الحدث بتغييرها.

عند إعداد التوزيع، يمكنك استخدام شروط خاصة:

  • today — يتحقق مما إذا كانت التاريخ الحالي يتطابق مع التاريخ في سمة المستخدم من النوع date أو dateTime.
  • now — يتحقق مما إذا كان الوقت الحالي (الساعات والدقائق) يتطابق مع القيمة في السمة من النوع time أو dateTime.

طريقة الإرسال

لجميع الوحدات، باستثناء forms، تتوفر ثلاث طرق لإرسال الإشعار:

  1. إشعار دفع — عبر إشعارات الدفع
  2. البريد الإلكتروني — إرسال عبر البريد الإلكتروني
  3. Socket IO — عبر WebSockets (مناسب للاشتراك في الأحداث في الوقت الحقيقي، مثل تغيير السعر). لمزيد من التفاصيل، انظر وثائق Socket.IO.

لمن يتم الإرسال

بالنسبة لوحدة catalog، يمكنك اختيار مستلمي الإشعار:

  • لجميع مستخدمي
    موقعك
    ،
  • أو مجموعة معينة من المستخدمين.

كم مرة يتم الإرسال

بالنسبة للأحداث من وحدات catalog وusers، يمكنك اختيار تكرار الإرسال:

  • مرة واحدة عند حدوث الحدث،
  • كل مرة عند تكرار التفعيل.

السمات

تحتوي علامة التبويب "السمات" على قائمة منسدلة لاختيار مجموعة السمات.

بعد اختيار مجموعة السمات، يجب ملء القيم. على سبيل المثال:

  • event_send_date (نوع التاريخ والوقت)
  • event_desc (نوع نص)

يمكن استخدام هذه السمات في علامة التبويب الإعدادات لإنشاء قالب الرسالة. وهي متاحة بمفتاح event:

{{ event.attribute_marker }}

السمة timeInterval لجدولة التوزيعات**
إذا كانت مجموعة السمات المختارة تحتوي على سمة من النوع timeInterval، فإنها تصبح متاحة للاختيار في إعدادات جدولة التوزيع (وضع التوزيع).
عند اختيار مثل هذه السمة، سيتم إرسال التوزيع فقط في الأيام المحددة في الفاصل الزمني (على سبيل المثال، فقط أيام الاثنين والجمعة).

الإعدادات

تحتوي علامة التبويب "الإعدادات" على حقلين نصيين لإنشاء قالب الرسالة التي سيتلقاها مستخدمو

موقعك
.

المتغيرات المتاحة

تحت حقول الإدخال، يتم عرض قائمة بالمتغيرات المتاحة للإدراج في القالب (مثل {{ email }}، {{ user.attribute_marker }} وغيرها).

التوزيع على المستخدمين (وضع التوزيع)

تتيح الوظيفة إعداد توزيعات بريد إلكتروني دورية للمستخدمين الذين يتوافقون مع الشروط المحددة. على عكس الأحداث القياسية، يتم تفعيل التوزيع ليس عند تغيير البيانات، ولكن حسب الجدول الزمني، عند استيفاء الشروط.

إعداد التوزيع

  1. إنشاء الحدث

    • نوع الحدث: المستخدمون
    • وضع العمل: التوزيع (التوزيع)
  2. إعداد الجدول الزمني

    • الوقت: نقطة البداية (على سبيل المثال، الاثنين 10:00)
    • التكرار:
      • يوميًا
      • أسبوعيًا
      • شهريًا
      • فاصل زمني مخصص
      • من السمة timeInterval — إذا كانت هناك سمة من هذا النوع في مجموعة السمات، يمكنك اختيارها، وسيتم إرسال التوزيع فقط في الأيام المحددة من الأسبوع.
  3. شروط اختيار المستخدمين

    • أمثلة:
      • تاريخ التسجيل > 2024-01-01
      • الاشتراك في التوزيع = true
      • today: التاريخ الحالي = قيمة السمة date/dateTime لدى المستخدم
      • now: الوقت الحالي (ساعة:دقيقة) = قيمة السمة time/dateTime لدى المستخدم

مثال على العمل

  • الإعداد:

    • الوقت: كل يوم اثنين في 10:00
    • التكرار: من السمة timeInterval (اختار المستخدم "الاثنين، الأربعاء، الجمعة")
    • الشروط:
      • الاشتراك = true
      • today: user.birthday_date = اليوم
  • النتيجة:
    كل يوم اثنين في 10:00، يقوم النظام:

    1. بالبحث عن المستخدمين الذين لديهم اشتراك نشط والذين يحتفلون بعيد ميلادهم اليوم
    2. يتحقق مما إذا كان اليوم الحالي (الاثنين) ضمن timeInterval الخاص بهم
    3. يرسل لهم تهنئة شخصية

أمثلة على إعداد الأحداث

فيما يلي أمثلة على إعداد الأحداث لكل من الوحدات الست المتاحة.

الكتالوج

النماذج

الخصومات

الطلبات

المدفوعات

المستخدمون