نموذج ترحيب Discourse

:information_source: الملخص نافذة منبثقة ترحيبية لمساعدة أعضاء المجتمع الجدد أو العائدين بطرق قابلة للتنفيذ لبدء استكشاف/المشاركة في منتدى
:eyeglasses: معاينة Theme Creator (يتطلب تسجيل الدخول)
:hammer_and_wrench: المستودع GitHub - noahLovell/discourse-welcome-modal
:question: دليل التثبيت كيفية تثبيت سمة أو مكون سمة
:open_book: جديد في سمات Discourse؟ دليل المبتدئين لاستخدام سمات Discourse

تثبيت مكون السمة هذا

:rocket: لماذا تستخدم هذا؟

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


:camera_flash: لقطات الشاشة

سطح المكتب


الهاتف المحمول


كيف يعمل

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

  1. المستخدمون الجدد: يتم عرضها تلقائيًا لجميع المستخدمين الذين سجلوا بعد feature_enabled_date الخاص بك.
  2. فترة السماح: خلال نافذة قابلة للتكوين، يقوم المكون بوضع علامة “صامتة” على المستخدمين النشطين على أنهم شاهدوا النافذة المنبثقة حتى لا تتم مقاطعتهم.
  3. المستخدمون القدامى: يتم عرضها للمستخدمين الحاليين الذين يعودون إلى المنتدى بعد انتهاء فترة السماح الخاصة بك، مما يساعد على إعادة إشراكهم.

ملاحظة: يتم تخزين حالة “المشاهدة” محليًا في متصفح المستخدم، لذلك قد تظهر النافذة المنبثقة مرة أخرى إذا قاموا بتغيير الأجهزة أو مسح ذاكرة التخزين المؤقت.


:gear: الإعدادات

الإعداد النوع الافتراضي الوصف
enabled bool false تبديل نافذة Discourse الترحيبية عندما تكون جاهزًا لتمكينها للأعضاء.
feature_enabled_date string \"2026-01-01\" أدخل التاريخ بتنسيق YYYY-MM-DD.
grace_period_months integer 3 عدد الأشهر بعد تاريخ تمكين الميزة لوضع علامة صامتة على المستخدمين الحاليين على أنهم شوهدوا.
card_layout enum \"grid\" اختر كيفية عرض البطاقات في النافذة الترحيبية (grid أو list).
card_content objects [] قم بتكوين البطاقات المعروضة في النافذة الترحيبية (يتطلب id وtitle وsubtitle وimgUrl وaltText وbtnLabel وaction).
title (الترجمة) text Join the conversation العنوان الرئيسي المعروض في الجزء العلوي من النافذة المنبثقة.
close_btn (الترجمة) text Done التسمية للزر الذي يغلق النافذة المنبثقة.

استخدم ?show-welcome-modal=true لإظهار النافذة الترحيبية بالقوة، بغض النظر عما إذا كانت الميزة ممكّنة، أو حالتها التي تمت مشاهدتها سابقًا - وهو أمر مثالي للاختبار قبل الإطلاق في مجتمعك :slight_smile:


هذا هو أول مكون سمة حقيقي لي :raised_hands: أود الحصول على تعليقات، وأفكار، وأشياء كان من الممكن القيام بها بشكل أفضل :smile:

20 إعجابًا

مرحباً @noahl

ما هي أسهل طريقة لاختبار هذا ورؤية المربعات (tiles) كما في صور العرض التوضيحي الخاصة بك؟ هل هناك مجموعة معينة من الإعدادات تسمح للمسؤولين برؤية المربعات قبل أن نتيحها على نطاق أوسع في بيئة PORD؟

إعجابَين (2)

مرحباً @marksalter! أنت أول “طالب ميزة” لي :raising_hands:

لقد دفعت للتو إعداد enable، بالإضافة إلى معلمة استعلام (query param) لإظهار النافذة المنبثقة بالقوة - ?show-welcome-modal=true

إذا قمت بدمج كلتا الميزتين، ستتمكن من الاختبار كمسؤول قبل تمكينها للمستخدمين :slight_smile:

على سبيل المثال: قم بتعيين التمكين على إيقاف (لن يظهر لأي شخص)، ثم استخدم معلمة الاستعلام لإجباره على الظهور.

6 إعجابات

يعمل بشكل رائع! شكرًا لك على إلقاء نظرة.

3 إعجابات

مجرد فكرة للجولة القادمة من التطوير. سيكون من الجيد لو تمكنا من تحديد الرسائل التي يتم عرضها للمستخدمين الجدد مقابل المستخدمين الحاليين الذين لم يكونوا نشطين خلال الفترة الزمنية المحددة.

لذا، يحصل المستخدمون الجدد على رسائل ترحيب (اذهب إلى المواد التمهيدية) بينما يحصل المستخدمون الحاليون على رسالة “ما الجديد” (تحقق من هذه الميزات/الفئات/الأشياء الجديدة..).

4 إعجابات

هذا لطيف حقًا! عمل رائع :clap:

ما رأيك في إزالة التذييل؟ نظرًا لوجود عبارات تحث على اتخاذ إجراء (CTAs) وزر الإغلاق، فإن كلمة “تم” (Done) تبدو غير ضرورية بعض الشيء، ولكني أود أن أعرف رأيك؟

أحب هذه الفكرة! لقد كانت شيئًا فكرت فيه للمرور الأول، لكنني قررت إبقاء الإصدار الأولي بسيطًا.

على أي حال، لقد قمت للتو بدفع تحديث ينفذ هذا التقسيم! هناك تغيير طفيف في المنطق للتمييز بين حالات المستخدمين المختلفة حتى تتمكن من تخصيص المحتوى دون أن تكون متطفلاً.

كيف يعمل الآن:

1. التعريفات

  • المستخدمون الجدد: مسجلون في أو بعد feature_enabled_date الخاص بك.
  • المستخدمون الحاليون: مسجلون قبل ذلك التاريخ.
  • المستخدمون النشطون: الأعضاء الذين يزورون بانتظام (ضمن نافذة عدم النشاط الخاصة بك).
  • المستخدمون العائدون: الأعضاء النشطون سابقًا الذين ابتعدوا لفترة كافية لتجاوز حد عدم النشاط.

2. تدفق المنطق لضمان عدم إزعاج أعضائك الأكثر نشاطًا، يتبع المكون أولوية محددة:

  • التسجيل الجديد: يرون النموذج على الفور (يستهدفون ببطاقات معلمة بـ new_users أو both).
  • فترة السماح: إذا زار “مستخدم حالي” خلال نافذة الإعداد الخاصة بك، فإن المكون يحددها بصمت على أنها تمت رؤيتها حتى لا تتم مقاطعتها.
  • فجوة عدم النشاط: بمجرد تحديد المستخدم على أنه “تمت رؤيته”، يتتبع المكون الزيارات محليًا. إذا زار يوميًا، فإنه يظل نشطًا ولا يراه أبدًا. لن يراه (كـ مستخدم عائد) إلا إذا تجاوزت الفجوة بين زياراته الإعداد الخاص بك returning_user_inactivity_months (هذا إعداد جديد :slight_smile: )

3. المحتوى المخصص يمكنك الآن استخدام إعداد displayFor على كل بطاقة:

  • new_users: مثالي لـ “كيفية النشر” أو “قدم نفسك”.
  • returning_users: مثالي لـ “اطلع على ما تغير أثناء غيابك”.
  • both: روابط أساسية مثل الإرشادات أو الأسئلة الشائعة.

لقد أضفت أيضًا معلمات المعاينة حتى تتمكن من اختبار هذه التدفقات بسهولة: ?show-welcome-modal=true&user-type=new أو &user-type=returning.

شكرًا مرة أخرى على الدفعة!

3 إعجابات

@noahl هذا رائع!

سأحاول إلقاء نظرة على هذا في وقت لاحق اليوم أو يوم الاثنين وأخبرك كيف تسير الأمور.

إعجاب واحد (1)