مكوّن سمة بوابة الضيوف

[Don]

	المستودع	GitHub - VaperinaDEV/discourse-guest-gate-theme-component: Forced login / registration popup insired by Quora · GitHub
	وجدته مفيدًا؟	> ./support --coffee
	دليل التثبيت	كيفية تثبيت موضوع أو مكوّن موضوع
	جديد على مواضيع Discourse؟	دليل المبتدئين لاستخدام مواضيع Discourse

Guest Gate v1.0

مرحبًا تم إنشاء مكوّن هذا الموضوع من Guest Gate (Sign Up Popup Plugin). يمكنه قفل المواضيع للزوار غير المسجلين من خلال نافذة منبثقة (Modal) وإجبارهم على التسجيل أو تسجيل الدخول. يمكن استخدام المكوّن كنافذة تنبيه تشجع الزوار على التسجيل مع السماح لهم بإغلاق النافذة (لذلك، اترك خيار dismissable false غير مُفعّل). تتضمن الخيارات تغيير عدد المواضيع التي يمكن عرضها قبل ظهور النافذة.

نصيحة: إذا كنت تستخدم خيار “البوابة المخصصة” وتريد إخفاء رأس النافذة (كما في الصورة أعلاه)، فيجب عليك حذف حقل guest_gate.title والضغط على مفتاح المسافة. سيزيل هذا عنوان النافذة، مما يتيح لك استخدام عنوان أسفل الصورة بدلاً من ذلك.

لديك خياران رئيسيان للبوابة:

1. البوابة العامة (افتراضي: ستستخدم نص دعوة التسجيل في Discourse داخل النافذة). تستخدم هذه النصوص: js.signup_cta.intro و js.signup_cta.value_prop

2. البوابة المخصصة (يمكنك تخصيص النافذة: إضافة صورة، نص مخصص وألوان).

---

وهناك العديد من الإعدادات الأخرى

الإعدادات العامة لنافذة Guest Gate

1. max guest topic views
   عدد مرات عرض الموضوع حتى تظهر البوابة. بعد ظهور البوابة لأول مرة، ستظهر بشكل عشوائي بين 1 وهذا العدد.
2. dismissable false
   يزيل زر الإغلاق، مما يمنع الزوار من إغلاق النافذة.
3. use gate buttons
   استخدام أزرار في تذييل النافذة بدلاً من الروابط.
4. custom url enabled
   تفعيل خيارات عنوان URL المخصص لتسجيل الدخول وعنوان URL المخصص للتسجيل. السلوك الطبيعي (إذا تركت هذا الخيار غير مُفعّل) هو ظهور نافذة تسجيل الدخول أو التسجيل في صفحة الموضوع الحالية.
5. custom login url
   على سبيل المثال، /login هي الصفحة الرئيسية مع عرض نافذة “تسجيل الدخول”.
6. custom signup url
   على سبيل المثال، /signup هي الصفحة الرئيسية مع عرض نافذة “التسجيل”.
7. gate footer position
   موضع أزرار/روابط التذييل.
8. gate show only once
   ظهور نافذة Guest Gate مرة واحدة فقط لكل جلسة.

---

إعدادات البوابة المخصصة

1. custom gate enabled
   فعّلها إذا كنت تريد تخصيص النافذة.
2. custom gate image
   ارفع صورة لعرضها في أعلى النافذة.
3. custom gate image width
   عرض الصورة المرفوعة. يمكنك استخدام px، % إلخ، على سبيل المثال، 100% سيضيف صورة بعرض النافذة الكامل (باستثناء الحشوة).
4. custom gate big text color
   يظهر “النص الكبير” أسفل الصورة. يمكنك تحديد لون النص.
5. custom gate little text color
   يظهر “النص الصغير” أسفل النص الكبير. يمكنك تحديد لون النص.
6. custom gate background color
   تغيير لون خلفية النافذة.
7. custom gate footer text color
   تغيير لون نص التذييل. ينطبق هذا إذا كان إعداد use gate buttons معطلاً وقد قمت بإعداد بوابة مخصصة.
8. custom gate link color
   تغيير لون روابط التذييل. ينطبق هذا إذا كان إعداد use gate buttons معطلاً وقد قمت بإعداد بوابة مخصصة.

---

الاعتماد شكر كبير لمؤلفي المكوّن الإضافي، والمصنفين والمساهمين: @vinothkannans, @jgujgu و @michaeld

Guest Gate v2.0

مرحبًا

Guest Gate v2.0 هي بوابة عصرية وقابلة للضبط للزوار المجهولين على Discourse.

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

بدأت Guest Gate من المكوّن الإضافي الأصلي Guest Gate Sign Up Popup plugin وقد تطورت بشكل كبير منذ ذلك الحين.

تشغيل Guest Gate

تدعم الإصدار 2.0 عدة طرق لتشغيل البوابة:

1. عدد مرات عرض الصفحة
   عرض البوابة بعد عدد قابل للضبط من مرات عرض الصفحة المؤهلة.

2. الوقت
   عرض البوابة بعد أن يقضي الزائر وقتًا قابلًا للضبط على صفحة مؤهلة.

3. التمرير (Scroll)
   عرض البوابة بعد أن يمر الزائر بنسبة قابلة للضبط من الصفحة.

4. Lightbox
   عرض البوابة عندما يفتح الزائر المجهول صورة في Lightbox الخاص بـ Discourse.

5. أي
   تفعيل أنواع تشغيل متعددة وعرض البوابة عند الوصول إلى أول مُشغّل مُعد.

يمكنك أيضًا ضبط تأخير بين المُشغّل وظهور النافذة.

---

سلوك التكرار

بعد عرض Guest Gate، يمكنك التحكم في متى يمكن أن تظهر مرة أخرى.

الأوضاع المتاحة:

• تكرار المُشغّل: عرض البوابة كلما تم تشغيل المُشغّل المُعد.

• عدد مرات عرض عشوائي: عرض البوابة بعد عدد عشوائي من مرات عرض الصفحة.

• مرة واحدة لكل جلسة: عرض البوابة مرة واحدة على الأكثر أثناء جلسة المتصفح.

يتم أيضًا دعم إعداد Show only once القديم للتوافق مع الإصدارات السابقة.

---

ظهور URL

يتحكم إعدادان في مكان السماح لـ Guest Gate بالظهور:

url_for_show

حدد المسارات التي يمكن فيها تشغيل Guest Gate.

أمثلة:

• * جميع الصفحات

• / الصفحة الرئيسية

• /latest الأحدث

• /t/* المواضيع

• /c/* الفئات

url_for_hide

حدد المسارات التي يجب ألا تظهر فيها Guest Gate أبدًا.

أنماط الإخفاء لها دائمًا الأولوية على قائمة العرض.

---

إعدادات النافذة

dismissable

السماح للزوار بإغلاق نافذة Guest Gate.

عطّل هذا الخيار لإنشاء بوابة لا يمكن تجاهلها.

gate_modal_size

اختر عرض النافذة:

• compact

• standard

• wide

gate_body_alignment

اختر المحاذاة الأفقية لمحتوى النافذة الرئيسي:

• left

• center

• right

gate_footer_position

اختر محاذاة روابط أو أزرار تسجيل الدخول / التسجيل:

• left

• center

• right

gate_title_visibility

إظهار أو إخفاء عنوان النافذة.

gate_title_position

التحكم في موضع هوامش العنوان.

---

تسجيل الدخول والتسجيل

تدعم Guest Gate تدفق المصادقة العادي في Discourse بالإضافة إلى عناوين URL مخصصة.

use_gate_buttons

استخدام أزرار في تذييل النافذة بدلاً من روابط النص.

custom_url_enabled

استخدام عناوين URL مخصصة لتسجيل الدخول والتسجيل بدلاً من إجراءات المصادقة الأصلية في Discourse.

custom_login_url

الوجهة المستخدمة لتسجيل الدخول عند تفعيل عناوين URL المخصصة.

custom_signup_url

الوجهة المستخدمة للتسجيل عند تفعيل عناوين URL المخصصة.

يمكنك أيضًا ضبط أنماط الأزرار وأيقونات Font Awesome بشكل مستقل.

---

Discourse Connect

تدعم Guest Gate خاصية Discourse Connect.

عند تفعيل Discourse Connect، يمكنك اختيار توفير عنوان URL منفصل للتسجيل باستخدام:

• enable_discourse_connect_signup

• discourse_connect_signup_url

---

البوابة المخصصة

يتيح لك البوابة المخصصة تخصيص محتوى ومظهر النافذة بالكامل.

فعّلها باستخدام:

custom_gate_enabled

تفعيل تصميم البوابة المخصصة.

custom_gate_image

صورة اختيارية تُعرض فوق النص المخصص.

custom_gate_image_alt

نص بديل للصورة المخصصة.

custom_gate_image_width

ضبط عرض الصورة باستخدام قيم مثل:

• 150px

• 50%

• 100%

custom_gate_image_position

محاذاة الصورة:

• left

• center

• right

custom_gate_big_text_position

محاذاة العنوان المخصص:

• left

• center

• right

custom_gate_little_text_position

محاذاة النص المخصص:

• left

• center

• right

توفر البوابة المخصصة أيضًا إعدادات للعنوان، والنص، والخلفية، والتذييل، وألوان الروابط.

---

التحليلات

يتضمن Guest Gate v2.0 تحليلات اختيارية تحترم الخصوصية.

فعّلها باستخدام:

enable_analytics

عند التفعيل، تتتبع Guest Gate:

• انطباعات البوابة

• سبب التشغيل

• مسار الصفحة

• نقرات تسجيل الدخول

• نقرات التسجيل

• إجراءات SSO

• إجراءات الإغلاق

تُعرض الأحداث من خلال window.dataLayer وتُطلق أيضًا كحدث متصفح:

discourse-guest-gate:analytics

هذا يسمح بتكامل Guest Gate مع منصات التحليلات وإدارة الوسوم مثل Google Analytics, Google Tag Manager, Matomo، أو تطبيقات التحليلات المخصصة.

لا تجمع Guest Gate أي بيانات شخصية.

التحليلات معطلة افتراضيًا.

analytics_debug_logging

فعّل هذا أثناء إعداد التحليلات لطباعة أحداث Guest Gate في وحدة التحكم بالمتصفح.

يُوصى بإيقاف هذا في بيئة الإنتاج.

---

الترحيل من v1

يتضمن Guest Gate v2.0 ترحيلًا للإعدادات للتركيبات الحالية.

تتم ترقية الإعدادات القديمة التالية تلقائيًا:

• max_guest_topic_views

• dismissable_false

• gate_show_when_thumbnail_clicked

لذلك، لا تحتاج التكوينات الحالية إلى إعادة إنشائها يدويًا بعد الترقية.

---

المتطلبات

يتطلب Guest Gate v2.0 Discourse 3.2.0 أو أحدث.

---

الاعتماد
شكر كبير لمؤلفي المكوّن الإضافي الأصلي، والمصنفين والمساهمين: @vinothkannans, @jgujgu و @michaeld

[markersocial]

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

[Don]

مرحباً @markersocial،

شكراً على الاقتراح!

لقد أضفت هذين الإعدادين. الآن يمكنك تغيير نمط أزرار تسجيل الدخول والتسجيل في نافذة بوابة الضيف.

btn-primary أو btn-default

Feature: ability to change login and signup button style

[markersocial]

رائع، شكرًا جزيلاً لك @Don! لقد قمت بتحديثه الآن وهو يعمل بشكل رائع

اقتراحي الآخر الوحيد هو أن تكون قادرًا على تخصيص تكرار المطالبات المتكررة.

الإعداد: أقصى عدد مرات مشاهدة الموضوع للضيوف

• “عدد مرات مشاهدة الموضوع حتى ظهور البوابة. بعد ظهور البوابة لأول مرة، تظهر بشكل عشوائي بين 1 وهذا الرقم.” *

يعد تعيين أقصى عدد مرات مشاهدة الموضوع للضيوف إلى 1 أو 2 أمرًا جيدًا، مما يشجع على التسجيل مبكرًا - ولكن إذا رفض المستخدم (ولم يتم تمكين “إظهار مرة واحدة لكل جلسة”)، فسيكون من الجيد أن تكون قادرًا على إظهار النافذة المنبثقة مرة أخرى بمعدل أقل حتى لا تكون عدوانية جدًا تجاه المتطفلين. مثل كل 5 مشاهدات موضوع أو أكثر على سبيل المثال.

[davidkingham]

مرحباً دون، مكون رائع! هل هناك أي فرصة لجعل زر التسجيل قابلاً للتخصيص بحيث يمكن إدراج عنوان URL؟ أستخدم Memberful لـ SSL لذا فإن رابط التسجيل العادي لا يعمل، بل ينقلك فقط إلى صفحة تسجيل الدخول. شكراً!

[Don]

مرحباً ديفيد،

شكراً لك، هذا اقتراح رائع!

لقد أضفت هذا. لقد استبدلت إعداد redirect_to_home بـ custom_url_enabled وخيارين.

1. custom_login_url: /login
   (بشكل افتراضي، يتم إعادة التوجيه إلى الصفحة الرئيسية وفتح نافذة تسجيل الدخول)
2. custom_signup_url: /singup
   (بشكل افتراضي، يتم إعادة التوجيه إلى الصفحة الرئيسية وفتح نافذة التسجيل)

Feature: abality to change guest gate buttons url

[davidkingham]

رائع! هناك مشكلة واحدة فقط، الآن خيارات نص البوابة المخصص لا تعمل

[Don]

لقد تفقدت موقعك ويعمل لدي. ربما جرب تحديثًا قويًا أو أعد فتح المتصفح، أعتقد أنك ترى نسخة مخبأة.

[davidkingham]

هذا ما فكرت فيه أيضًا، لقد مسحت ذاكرة التخزين المؤقت الخاصة بي، وجربت 4 متصفحات مختلفة وكانت جميعها متماثلة، غريب جدًا! إذا كنت لا تمانع في المحاولة مرة أخرى، فقد قمت للتو بتغيير guest_gate.title إلى ‘Test’، هل ترى هذا التحديث؟

[Don]

نعم، هذا ما أراه الآن.

سأحاول التحقق من المتصفحات والأجهزة الأخرى.

[davidkingham]

نفس النتائج عبر vpn، على هاتفي، شبكة مختلفة. هذا أغرب شيء على الإطلاق! أعتقد ما دام بإمكان الجميع رؤية النص الصحيح فلا بأس!

[Don]

مرحباً ديفيد،

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

هل يمكنك إيقاف هذا الإعداد والمحاولة مرة أخرى؟

---

الآن يمكنني تكرار هذا. لقد غيرت لغة كروم من الإنجليزية (المملكة المتحدة) إلى الإنجليزية (الولايات المتحدة) وحدث هذا.

والعودة إلى الإنجليزية (المملكة المتحدة)

[davidkingham]

شكراً لك دون، أنت مفيد بشكل لا يصدق! أعتقد أن هناك خطأ في تثبيتي يتعلق باللغات. بما أن هذا لا يبدو أنه ناتج عن مكونك، سأبدأ موضوعًا جديدًا. أقدر لك النظر في هذا الأمر.

تحرير: اكتشفت أن إعدادات اللغة الإدارية الخاصة بي قد تم تغييرها بطريقة ما إلى المملكة المتحدة بدلاً من الولايات المتحدة، غريب جدًا! قمت بتغييرها مرة أخرى واملأت الحقول مرة أخرى، والآن كل شيء على ما يرام في العالم.

[Jonathan5]

يعمل هذا بشكل جيد حقًا. شكرا لك.

لقد أجريت بعض التعديلات الطفيفة لجعل المنشور الأول أسهل في القراءة. كانت هناك جملة واحدة لم أستطع فهمها على الإطلاق:

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

[Don]

شكراً لك جوناثان أقدر ذلك حقاً للأسف لغتي الإنجليزية ليست الأفضل آسف على هذا! سأقوم بتغيير هذه في مكون السمة أو بالطبع يمكنك إرسال طلب سحب (PR) أيضاً.

إعداد الموقع custom url enabled يعني.
يمكنك إضافة عناوين URL مخصصة لأزرار/روابط بوابة الضيف لتسجيل الدخول والتسجيل والتي تستخدم افتراضياً عناوين URL المخصصة هذه /login و /signup والتي تعيد توجيه الزائر إلى الصفحة الرئيسية وتفتح نافذة تسجيل الدخول أو التسجيل المنبثقة. لذا إذا قمت بتحديدها، فسيؤدي ذلك إلى تنشيط الإعدادين أدناه. custom login url و custom signup url.

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

آمل أن يساعد ذلك في الفهم ومرة أخرى شكراً لك على وقتك لجعل الأمر أكثر قابلية للفهم

[Jonathan5]

لغتك الإنجليزية جيدة، ولا يوجد خطأ في JavaScript الخاص بك، وهذا هو الشيء المهم ماذا عن هذا؟

4. custom url enabled – تمكين خيارات custom login url و custom signup url. السلوك الطبيعي (إذا تركت هذا الخيار غير محدد) هو ظهور نافذة تسجيل الدخول أو التسجيل المنبثقة على صفحة الموضوع الحالية.
5. custom login url – على سبيل المثال، /login هي الصفحة الرئيسية مع عرض نافذة تسجيل الدخول المنبثقة.
6. custom signup url – على سبيل المثال، /signup هي الصفحة الرئيسية مع عرض نافذة التسجيل المنبثقة.

[Don]

@Jonathan5

ولا يوجد خطأ في جافاسكريبت الخاص بك

هذا يعود الفضل فيه إلى مؤلفي المكونات الإضافية والمساهمين أيضًا. لكنني أبذل قصارى جهدي لتطوير هذا وإضافة المزيد من الميزات والإصلاحات وما إلى ذلك.

---

شكرًا على التصحيح يبدو هذا أفضل بكثير. سأقوم بتصحيح هذه الأمور في مكون السمة أيضًا.

[Himanshu_Singh]

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

هل يعرف أي شخص عن تأثير ذلك على الزواحف؟

[Himanshu_Singh]

أواجه بعض مشكلات التكوين مع Guest Gate عند استخدام SSO مع Discourse Connect.

يمكن للمستخدم تسجيل الدخول إلى الموقع الرئيسي ثم يبدو أنه مسجل الدخول في Discourse ولكن بعد النقر على بعض المواضيع، يظهر مربع حوار Guest Gate. هذا غير عادي لأن المستخدم مسجل الدخول.

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

الطريقة الوحيدة لتجاوز ذلك هي عندما ينقر المستخدم على زر تسجيل الدخول الأصلي في Discourse ويتم تسجيل دخوله تلقائيًا.

يبدو أنه لسبب ما، لا يحترم Guest Gate تسجيل الدخول من SSO ويتطلب تسجيل الدخول الأصلي للتفعيل.

هل واجه أشخاص آخرون هذه المشكلات؟ أي اقتراحات لحل أو حل بديل؟