إضافة WordPress
ثبّت إضافة نشرة لـWordPress واربطها بمفتاح API من «الإعدادات ← مفاتيح API»، لتزامن مستخدمي WordPress وعملاء WooCommerce مع نشرة تلقائياً: الفئات، وبيانات الشراء لبناء التصنيفات، والرمز المختصر [nashra_optin]، وسجل النشاط، وحل مشكلات المزامنة المتعثّرة.
ما الذي تزامنه
تربط إضافة نشرة لـWordPress موقعك بمساحة عملك في نشرة، وتُبقي قائمة مشتركيك محدّثة دون تصدير يدوي. فالتسجيلات الجديدة في WordPress، ومستخدموك الحاليون، وعملاؤك إن كنت تستخدم WooCommerce، ينضمّون جميعاً مشتركين في نشرة، ومع كل منهم فئة تدلّ على مصدره لتقسّمهم إلى تصنيفات لاحقاً.
يحصل كل مستخدم WordPress تتم مزامنته على الفئة WordPress، ويحصل عملاء WooCommerce إضافة إليها على WooCommerce. وفي أول مرة ينجح فيها الاتصال، تنشئ الإضافة تلقائياً في نشرة تصنيفين مطابقين هما WordPress Users وCustomers (WooCommerce)، فيكون لديك تصنيف جاهز للإرسال إليه فوراً. راجع الجمهور لتعرف كيف تعمل الفئات والتصنيفات.
وفي الإضافة أيضاً ميزة منفصلة واختيارية اسمها Post Sync، تجلب منشوراتك المنشورة في نشرة إلى WordPress وفق جدول زمني، وتُضبط من تبويب خاص بها في إعدادات الإضافة. وهي تنسخ كل منشور ظاهر على الويب، بما فيها المنشورات غير المُعلَنة، فقد يصبح منشور غير مُعلَن مُعلَناً في موقعك على WordPress. تتناول هذه الصفحة مزامنة المشتركين والعملاء إلى نشرة، وهو الاتجاه الذي تستخدمها له أغلب المواقع.
التثبيت والربط
ارفع الإضافة وفعّلها
ارفع مجلد nashra إلى /wp-content/plugins/، ثم فعّله من قائمة الإضافات (Plugins). تتطلب الإضافة WordPress 6.2 أو أحدث وPHP 7.4 أو أحدث (جُرّبت حتى WordPress 6.9).
افتح الإعدادات ← Nashra
تضيف الإضافة صفحة إعدادات خاصة بها تحت قائمة الإعدادات (Settings) في WordPress.
أدخل بيانات الاتصال
أدخل رابط نسخة نشرة لديك (القيمة الافتراضية https://app.nashra.ai) ومفتاح API تنشئه في نشرة من الإعدادات ← مفاتيح API. تنتهي صلاحية المفاتيح الجديدة بعد 90 يوماً ما لم تختر غير ذلك، فاختر بلا تاريخ انتهاء لمفتاح الإضافة، أو دوّن التاريخ كي لا تتوقف المزامنة. راجع المصادقة.
اختبر الاتصال
انقر اختبار الاتصال (Test Connection). يستدعي ذلك GET /tags في مساحة عملك للتأكد من أن المفتاح يعمل، وإن نجح تُنشأ التصنيفات الافتراضية.
اضبط المزامنة
حدّد الحالة الافتراضية لخانة الاشتراك، واختر الأدوار التي تُزامَن، وفعّل تكامل WooCommerce إن احتجت إليه.
ما الذي يُزامَن ومتى
- التسجيلات الجديدة: تُزامَن لحظة تسجيل الشخص، إن كانت خانة الاشتراك في نموذج التسجيل محدّدة.
- المستخدمون الحاليون: يُزامَنون على دفعات في الخلفية بعد تفعيل الإضافة بقليل. ويمكنك إعادة تشغيل المزامنة في أي وقت من الإعدادات ← Nashra: مزامنة الآن (Sync Now) تلتقط كل من لم يُزامَن بعد، وإعادة مزامنة الكل (Re-sync All) تمسح حالة المزامنة أولاً وتبدأ من جديد.
- عملاء WooCommerce: بمن فيهم من أتمّوا الطلب كضيوف، يُزامَنون حين يصل الطلب إلى حالة «قيد التنفيذ» (Processing) أو «مكتمل» (Completed)، وحين يسجّل أحدهم من صفحة «حسابي» (My Account) في WooCommerce، إن كان تكامل WooCommerce مفعّلاً وخانة الاشتراك محدّدة.
- تصفية الأدوار: من «مزامنة الأدوار» (Sync Roles)، اختر أدوار WordPress المؤهلة للمزامنة. واترك كل الأدوار بلا تحديد لمزامنتها جميعاً.
خانة الاشتراك تتحكم فقط في التسجيلات الجديدة وطلبات WooCommerce من الآن فصاعداً، ولا أثر لها على المزامنة الجماعية. فالمزامنة الجماعية (عند التفعيل، أو عبر «مزامنة الآن»، أو «إعادة مزامنة الكل») تزامن كل مستخدم حالي يطابق تصفية الأدوار، سواء رأى الخانة أم لم يرها. ولأن الإضافة تضيف الأشخاص عبر API، يصبحون مشتركين فوراً، ولا يرسل لهم إعداد التأكيد المزدوج رسالة تأكيد. تأكّد من موافقة مستخدميك الحاليين على تلقي البريد قبل تفعيل المزامنة الجماعية.
بيانات الشراء للتصنيفات
لعملاء WooCommerce الذين لديهم طلب واحد على الأقل، ترسل الإضافة أيضاً بيانات الشراء في حقول مخصّصة تُنشأ تلقائياً في نشرة عند أول مزامنة لـWooCommerce:
| بيانات WooCommerce | الحقل المخصّص في نشرة | النوع |
|---|---|---|
| عدد الطلبات | Total Purchases (order_count) | رقم |
| إجمالي الإنفاق | Total Spent (total_spent) | رقم |
| تاريخ آخر طلب | Last Order Date (last_order_date) | تاريخ |
استخدم هذه الحقول لبناء التصنيفات بعد إنشائها، مثل أصحاب الإنفاق المرتفع (total_spent فوق حدّ معيّن) لرسالة ولاء، أو المشترين المنقطعين (last_order_date قبل تاريخ معيّن) لحملة استعادة.
خانة الاشتراك والرمز المختصر
تظهر خانة الاشتراك نفسها، ويمكنك ضبط نصّها وحالتها الافتراضية من الإعدادات ← Nashra، في نموذج التسجيل في WordPress، وفي صفحة إتمام الطلب في WooCommerce، وفي نموذج التسجيل بصفحة «حسابي» (My Account) في WooCommerce.
ولجمع المشتركين في أي مكان آخر من موقعك، استخدم الرمز المختصر [nashra_optin]. قيمه الافتراضية في تبويب Opt-in Form في الإضافة، ويمكنك تجاوز أي منها في كل موضع بسمات الرمز المختصر:
| السمة | ما تتحكم فيه |
|---|---|
title | نص العنوان |
subtitle | النص المساند |
placeholder | النص المؤقت في حقل البريد |
button | نص زر الإرسال |
tags | فئات مفصولة بفواصل تُضاف عند الاشتراك (الافتراضية Newsletter) |
accent_color | لون الزر واللون المميّز، بقيمة hex |
مثال: [nashra_optin title="Get updates" tags="footer,newsletter"]
سجل النشاط
يسجّل تبويب الإعدادات ← Nashra ← سجل النشاط (Activity Log) اختبارات الاتصال، ونجاح المزامنة وفشلها، وبدء المزامنة الجماعية واكتمالها، ويمكنك تصفيته حسب النوع. وتُحذف السجلات الأقدم من 30 يوماً تلقائياً. وهو أول مكان تتفقّده حين لا تتم مزامنة شيء.
حل المشكلات
فشل «اختبار الاتصال»
يستدعي «اختبار الاتصال» GET /tags بمفتاحك، والفشل هنا يعني عادةً أن المفتاح أو رابط النسخة خاطئ. تأكّد من أن الرابط يطابق نسخة نشرة لديك (الافتراضي https://app.nashra.ai)، وأن المفتاح ما زال ظاهراً في الإعدادات ← مفاتيح API في نشرة دون تاريخ منقضٍ في عمود الانتهاء. وإن كانت استضافة WordPress لديك تحجب طلبات HTTPS الصادرة، يفشل الاتصال بالطريقة نفسها، فراجع شركة الاستضافة بعد التأكد من صحة المفتاح والرابط.
المستخدمون لا يُزامَنون
تفقّد سجل النشاط أولاً. حين تفشل دفعات كاملة ثلاث مرات متتالية، تتوقف المزامنة الجماعية تلقائياً، وسبب ذلك عادةً مفتاح منتهي الصلاحية أو محذوف، وتبقى متوقفة حتى تضيف مفتاحاً صالحاً وتنقر مزامنة الآن من جديد. وبالنسبة للتسجيلات الجديدة أو طلبات WooCommerce تحديداً، تأكّد من أن خانة الاشتراك كانت محدّدة، فمن دونها لا يُرسل شيء. ولا تمنع أخطاء API التسجيل أو إتمام الطلب في موقعك أبداً، إذ تُسجَّل ولا تظهر للعميل، فلا يبدو فشل المزامنة خطأً في نظر من يسجّل.
تصفية الأدوار تستبعد أشخاصاً
إن حدّدت أدواراً معيّنة في «مزامنة الأدوار»، فلن يُزامَن إلا المستخدمون الذين لديهم هذه الأدوار، ويُتخطّى الآخرون دون أي خطأ. اترك القائمة فارغة لمزامنة كل الأدوار.