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

المقدمة

اشترك في الإشعارات والتحديثات المتعلقة بالمنتجات.

مزيد من المعلومات حول واجهة مستخدم الوحدة https://doc.oneentry.cloud/docs/category/events

🎯 ماذا تفعل هذه الوحدة؟​

تتيح لك وحدة Events اشتراك المستخدمين في إشعارات المنتجات - مثل البريد الإلكتروني عندما يعود المنتج إلى المخزون، أو تنبيه عندما ينخفض السعر. يمكنك تكوين الأحداث في لوحة إدارة OneEntry؛ تدير SDK من هو مشترك في ماذا.

فكر في الأمر كنظام اشتراك للمنتجات - يشترك المستخدمون في منتجات معينة (أو نماذج) ويتلقون إشعارات عندما يتغير شيء ما.

🚀 البدء السريع​

قم بتهيئة الوحدة من defineOneEntry:


const { Events } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

قم بإدراج الأحداث المتاحة (عامة - لا حاجة للتفويض):

// Fetch all events configured in the admin panel.
const events = await Events.getAllEvents();

events.forEach((event) => {
  console.log(event);
});

للاشتراك في حدث منتج، يجب أن تكون مخولًا أولاً، ثم اتصل بـ subscribeByMarker(marker, productId, langCode?):

// Requires an authorized user (see AuthProvider).
const ok = await Events.subscribeByMarker("product_price_change", 12345, "en_US");
console.log(ok); // true on success

✨ المفاهيم الأساسية​

ما هو حدث المنتج؟​

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

  • المحفز - ما يحدث للمنتج (مثل "عاد إلى المخزون"، "انخفاض السعر")
  • الإشعار - ما يتلقاه المشتركون (بريد إلكتروني أو دفع)
  • المشتركون - المستخدمون الذين اختاروا تلقي تحديثات هذا المنتج
  • القالب - محتوى رسالة الإشعار (يتم تكوينه في لوحة الإدارة)

تدعم الوحدة أيضًا أحداث النماذج: الاشتراك في / إلغاء الاشتراك من الإشعارات المرتبطة بتقديم نموذج باستخدام subscribeToForm / unsubscribeFromForm.

قنوات الإشعار​

القناةالوصفالأفضل من أجل
البريد الإلكترونيإرسال رسائل بريديةتنبيهات إعادة التخزين، انخفاض الأسعار، النشرات الإخبارية
إشعار الدفعتنبيهات على الهاتف/المتصفحتنبيهات عاجلة، مبيعات فلاش

📋 ما تحتاج إلى معرفته​

يتم تكوين الأحداث في لوحة الإدارة​

يتم إعداد المحفزات والقنوات والقوالب في لوحة إدارة OneEntry. لا تقوم SDK بإنشاء الأحداث أو تشغيلها يدويًا - يتم تشغيل الأحداث تلقائيًا عند تغيير بيانات المنتج. SDK مخصص لـ إدراج الأحداث و إدارة الاشتراكات.

التفويض​

getAllEvents() هو عام. تتطلب كل طريقة اشتراك (getAllSubscriptions, subscribeByMarker, unsubscribeByMarker, subscribeToForm, unsubscribeFromForm, getFormSubscriptions) مستخدمًا مخولًا - انظر AuthProvider.

متغيرات القالب​

استخدم العناصر النائبة في قوالب الإشعارات لتضمين تفاصيل المنتج مثل الاسم والسعر والتوافر. يتم تحرير القوالب في لوحة الإدارة.

📊 جدول مرجعي سريع - الطرق الشائعة​

الطريقةماذا تفعل
getAllEvents()الحصول على جميع الأحداث المتاحة
getAllSubscriptions() 🔐الحصول على جميع اشتراكات المنتجات
subscribeByMarker() 🔐الاشتراك في حدث منتج بواسطة علامة
unsubscribeByMarker() 🔐إلغاء الاشتراك من حدث منتج بواسطة علامة
subscribeToForm() 🔐الاشتراك في حدث نموذج بواسطة علامة
unsubscribeFromForm() 🔐إلغاء الاشتراك من حدث نموذج بواسطة علامة
getFormSubscriptions() 🔐الحصول على جميع اشتراكات النماذج

🔐 تتطلب الطرق تفويض المستخدم - انظر AuthProvider. getAllEvents() يعمل بدون تفويض.

❓ الأسئلة الشائعة (FAQ)​

كيف يمكنني إنشاء أو تعديل أحداث المنتجات؟​

يتم إنشاء الأحداث وتكوينها في لوحة إدارة OneEntry (قسم الأحداث) - قم بإعداد المحفزات والقنوات والقوالب هناك، ثم قم بتنشيط الحدث. تقوم SDK فقط بإدراج الأحداث وإدارة الاشتراكات.

هل يمكنني تشغيل حدث منتج يدويًا من الكود الخاص بي؟​

لا. لا تدعم SDK المحفزات اليدوية - يتم تشغيل الأحداث تلقائيًا بناءً على المحفزات المكونة في OneEntry عند تغيير بيانات المنتج.

لماذا يفشل الاشتراك مع خطأ في التفويض؟​

تتطلب طرق الاشتراك مستخدمًا مخولًا. قم بالتفويض أولاً عبر وحدة AuthProvider، ثم اتصل بـ subscribeByMarker / subscribeToForm. getAllEvents() يعمل بدون تفويض.

🎓 أفضل الممارسات​

  • قم بتفويض المستخدم قبل استدعاء أي طريقة اشتراك.
  • استخدم علامات أحداث وصفية (مثل product_back_in_stock, product_price_drop).
  • دائمًا قدم مسار إلغاء اشتراك سهل (unsubscribeByMarker / unsubscribeFromForm).
  • تعامل مع أخطاء الاشتراك بشكل جيد وتحقق من شكل إرجاع IError.

🔗 الوثائق ذات الصلة​

  • وحدة AuthProvider - قم بتفويض المستخدمين قبل إدارة الاشتراكات
  • وحدة Products - إدارة المنتجات التي تؤدي إلى أحداث
  • وحدة Forms - النماذج التي يمكن الاشتراك في تقديماتها
  • وحدة Users - إدارة المستخدمين الذين يشتركون في الإشعارات