المتجر والمنتجات·5 min read·

كيف أربط Circle.so لإضافة الأعضاء إلى مجتمعي تلقائيًا؟

ألصق رمز API ومعرّف المجتمع في Circle.so، فيُضاف كل عضو جديد في المدونة إلى مجتمعك على Circle — ويُزال تلقائيًا إذا حُذف حسابه.

يُبقي موصل Circle.so عضوية مجتمعك متسقة مع عضوية مدونتك: يُضاف كل عضو جديد في المدونة تلقائيًا إلى مجتمعك على Circle.so، ويُزال منه عندما يُحذف حسابه في VeloCMS. وهو بديل مجاني عن دفع ثمن إضافة SSO مخصصة.

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

الخطوة 1 — احصل على رمز API ومعرّف المجتمع

في إعدادات مجتمعك على Circle افتح قسم API وأنشئ رمز API. ثم اعثر على «معرّف المجتمع»، وهو رقم يظهر في رابط لوحة تحكم Circle. وإذا أردت إسقاط الأعضاء الجدد في مساحة (Space) بعينها لا في المجتمع فقط، فدوّن أيضًا المعرّف الرقمي لتلك المساحة.

الخطوة 2 — املأ لوحة Circle.so

افتح «لوحة التحكم ← الإضافات ← Circle.so» واملأ ثلاثة حقول: «رمز API»، و«معرّف المجتمع»، و«معرّف المساحة» وهو اختياري. اضغط «حفظ الإعدادات». لا يوجد مفتاح تفعيل ولا زر «اختبار الاتصال» في هذه اللوحة، لذا فأول تسجيل حقيقي بعد الحفظ هو الاختبار.

ماذا يحدث عند التسجيل

  • يُضاف العضو الجديد إلى مجتمعك بحسب بريده الإلكتروني، مع اسمه إن ذكره.
  • يطلب VeloCMS من Circle ألا يرسل رسالة الدعوة الخاصة به عند إضافة العضو.
  • إذا ردّت Circle بأن الشخص عضو بالفعل، يعدّ VeloCMS ذلك نجاحًا، فلا يمكن أن ينتهي عضو في المجتمع مرتين.
  • إذا ضُبط معرّف مساحة، يضيفه طلب ثانٍ إلى تلك المساحة أيضًا.

الطلب الثاني هو موضع الثغرات. فإخفاق إضافة شخص إلى المساحة يُكتب في السجل لكنه لا يُسجَّل مزامنةً فاشلة، فيبقى نشاط المزامنة أخضر حتى لو فاتت خطوة المساحة. وعندما تجد أعضاء في المجتمع وليسوا في المساحة، افحص معرّف المساحة أولًا.

ماذا يحدث عندما يغادر العضو

عندما يُحذف حساب عضو، يُزال من المجتمع، ويُعدّ ردّ Circle بأنه غير موجود أصلًا إنجازًا للمهمة. أما إلغاء الاشتراك في نشرتك البريدية فلا يزيل أحدًا من Circle؛ حذف الحساب وحده يفعل.

هذا الموصل لا يمسّ شيئًا إذا كان رمز API أو معرّف المجتمع مفقودًا — بل يتخطى المزامنة بصمت بدل أن يعطّل التسجيل، فيحصل العضو دائمًا على حسابه في VeloCMS حتى لو كان Circle.so مهيّأً بشكل خاطئ أو تعذّر الوصول إليه مؤقتًا.

إذا لم يصل تسجيل إلى Circle

تظهر إضافة المجتمع الفاشلة في «التكاملات ← نشاط المزامنة» مقرونة بالعضو. وCircle.so من الموصلات التي تتيح هناك زر إعادة المحاولة، لأن تكرار الطلب نفسه غير ضار. أصلح الرمز أو معرّف المجتمع، ثم أعد محاولة الصفوف الفاشلة بدل إضافة الأشخاص يدويًا.

قطع الاتصال

امسح رمز API في نفس اللوحة لإيقاف المزامنة. يبقى الأعضاء الذين أُضيفوا إلى مجتمعك على Circle.so فيه — فلا يزيل VeloCMS عضوًا تلقائيًا إلا حين يُحذف حسابه في VeloCMS نفسه، لا حين تقطع اتصال الإضافة.