المستخدمون والوصول في مُبَرمِج

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

من يستطيع فتح القسم

«المستخدمون والوصول» في مجموعة «البناء» يتطلب قدرة الاستضافة. الباقات التي تشملها: «الأساسية» و«المميزة» و«الاحترافية». في خطة «المجانية» يظهر القسم في الشريط الجانبي بقفل، وحين تفتحه يرد الخادم بالرمز 402 وتعرض الصفحة: «الاستضافة متاح في الباقات المدفوعة فقط — خطة المجانية تشمل القوالب الجاهزة والمحرّر المرئي.». الترقية من الفوترة. والقسم لمالك المشروع وحده: المتعاون بأي دور يُرفض برسالة «هذا الإجراء لمالك المشروع وحده».

إضافة مستخدم

1. في تبويب «المستخدمون»، داخل لوحة «إنشاء مستخدم»، اكتب «البريد الإلكتروني» و«الاسم (اختياري)».
2. اضغط «إضافة». عند النجاح تظهر «أُضيف المستخدم» ويُضاف الصف إلى «القائمة».

أسباب الرفض: «البريد الإلكتروني غير صالح»، أو «هذا البريد مسجّل بالفعل»، أو «هذا البريد ممنوع بقاعدة دخول» حين تطابقه قاعدة منع، أو «سياسة التسجيل «بموافقتي فقط» ولا توجد قاعدة سماح تطابق هذا البريد». الرفض يُسجَّل في سجل التدقيق بنتيجة «مرفوض» وسببه.

الاستيراد من CSV

1. جهّز ملفاً فيه سطر لكل مستخدم: بريد وحده، أو بريد ثم فاصلة ثم الاسم.
2. اضغط «استيراد CSV» واختر الملف.
3. تظهر رسالة بعدد الصفوف المرسلة. البريد المكرر يُتخطّى، فإعادة استيراد الملف نفسه لا تضر.

انتبه: الاستيراد لا يطبّق قواعد المنع والسماح التي يطبّقها زر «إضافة». وإن لم يوجد في الملف بريد صالح تظهر «لم يُعثر على بريد صالح في الملف».

القائمة والبحث

ابحث بحقل «بحث بالبريد أو الاسم…». الجدول يعرض أحدث ٢٠٠ مستخدم بأعمدة «الاسم» و«البريد» و«موثّق» (مفتاح تغيّره يدوياً) و«آخر طريقة دخول» و«الانضمام»، مع زر حذف لكل صف. الحذف فوري ودون تأكيد. وعدد المستخدمين الكلي يظهر على تبويب «المستخدمون».

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

دخول زوّار تطبيقك

تبويب «دخول تطبيقك» يعرض حالة الباب بشارة «يعمل» أو «غير مكتمل»، وتحتها أسطر «الباب» و«بريد وكلمة مرور» و«مضيف التطبيق» و«البريد» تسمّي ما ينقص. الباب مغلق حتى تفتحه، وما دام مغلقاً ترد كل نقاطه 404.

1. في تبويب «بوابة الدخول» فعّل طريقة «بريد وكلمة مرور» واضغط «احفظ طرق الدخول». هي الطريقة الوحيدة التي يخدمها الباب.
2. تأكّد أن لتطبيقك نطاقاً مخدوماً: فعّل نطاقاً فرعياً أو اربط نطاقك من النطاقات. الباب لا يعمل على عنوان المنصّة (/اسم-موقعك) لأن كل المواقع هناك تتقاسم أصلاً واحداً.
3. في «دخول تطبيقك» شغّل مفتاح «فتح الباب». إن لم تكن طريقة كلمة المرور مفعّلة يرفض الخادم برسالة «فعّل طريقة «بريد وكلمة مرور» في «بوابة الدخول» أولًا — هي الطريقة التي يخدمها باب دخول الزوّار».
4. (اختياري) شغّل «اشتراط توثيق البريد».
5. في لوحة «أضِف الأزرار إلى تطبيقك» اضغط «نسخ المقطع» وضع المقطع في صفحاتك. أزراره «تسجيل الدخول» و«إنشاء حساب» و«تسجيل الخروج» تنقل الزائر إلى صفحة دخول مستضافة ثم تعيده إلى الصفحة نفسها.

حين يكون الباب مفتوحاً يحقن مُبَرمِج حالة الزائر في صفحات موقعك على نطاق تطبيقك: العناصر ذات data-auth="signed-in" تظهر للمسجَّل وحده، وdata-auth="signed-out" للزائر، وdata-auth-name يُملأ باسمه، ومن الشيفرة window.MubarmijAuth.user. تدوم جلسة الزائر ١٤ يوماً. والتطبيق الذي يعمل في حاويته لا يُحقن فيه شيء، فيطلب نقاط الباب من أصله: signup وlogin وlogout (POST) وme (GET).

توثيق البريد واستعادة كلمة المرور يرسلان رابطاً بالبريد، فيحتاجان بريداً مضبوطاً على الخادم (سطر «البريد»). رابط الاستعادة صالح ٦٠ دقيقة ورابط التوثيق ٤٨ ساعة، وكلاهما لمرة واحدة. إن اشترطت التوثيق والبريد غير مضبوط يُرفض التسجيل برسالة «التسجيل يتطلّب توثيق البريد، والبريد غير مضبوط على الخادم — لم يُنشأ حساب»، ولا يدخل من اشترطت توثيقه قبل أن يوثّق بريده.

وللباب حدود معدّل: ٥ تسجيلات في الساعة لكل عنوان IP، و٢٠ محاولة دخول كل ١٥ دقيقة لكل عنوان و٨ لكل بريد، وبعدها «محاولات كثيرة — حاول بعد قليل».

قواعد الدخول

1. افتح «قواعد الدخول»، واختر «سماح» أو «منع» في لوحة «قاعدة جديدة».
2. اكتب النمط: *@example.com أو @example.com لنطاق كامل، أو بريداً بعينه.
3. اضغط «إضافة». تظهر القاعدة في «القواعد» بمفتاح «مفعّلة» وزر حذف.

قاعدة المنع ترفض دائماً: عند الإضافة، وعند تسجيل الزائر، وعند دخوله حتى لو أُضيفت القاعدة بعد تسجيله. وقواعد السماح لا تُلزم إلا حين تكون السياسة «بموافقتي فقط»، أما تحت «الجميع» فيُقبل أي بريد صالح لا تمنعه قاعدة.

وتحت «بموافقتي فقط» يختلف الطريقان: ما تضيفه أنت بزر «إضافة» يُقبل إن لم توجد قواعد سماح أصلاً، لأن إضافتك هي الموافقة. أما الزائر فلا يسجّل إلا بقاعدة سماح تطابق بريده، وغياب القواعد عنده رفض.

بوابة الدخول

تبويب «بوابة الدخول» يحفظ: «نطاق البوابة» و«عنوان البوابة» و«الشعار» و«لون الأزرار» و«اللغة الافتراضية» والروابط القانونية، ولوحات «طرق الدخول» و«رسائل الدخول» و«روابط إعادة التوجيه» و«من يستطيع التسجيل؟» («الجميع» أو «بموافقتي فقط»). طرق الدخول التي تحتاج مفتاحاً تطلب «معرّف العميل (Client ID)» ومفتاحاً سرياً محفوظاً في الأسرار.

صفحة الدخول التي يفتحها الباب تستعمل من هذه الإعدادات «عنوان البوابة» و«لون الأزرار»، والروابط القانونية حين تشغّل «إظهار الشروط وسياسة الخصوصية»، وتُعرض بالعربية. ورسائل التوثيق والاستعادة تحمل «اسم التطبيق في الرسالة» و«تذييل الرسالة».

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

سجل التدقيق

في «سجل التدقيق» ترى آخر ١٠٠ حدث في مساحة عمل التطبيق، مثل إضافة مستخدم ورفضه، وحفظ الهوية، وتشغيل التدقيق، وإنشاء المجلدات وحذف الملفات. رشّح بحقل «بحث في السجل…» أو بقائمة «كل الأحداث». زر «تصدير CSV» ينزّل حتى ١٠٬٠٠٠ حدث بأعمدة الوقت والمستخدم والحدث والهدف والنتيجة والسبب والطريقة، بترميز يفتحه Excel بالعربية.

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

أسئلة شائعة

هل يستطيع زوّار موقعي إنشاء حسابات الآن؟

نعم، بالبريد وكلمة المرور، حين تفتح الباب من «دخول تطبيقك» ويكون لتطبيقك نطاق مخدوم. على عنوان المنصّة بلا نطاق مخدوم لا يستطيعون.

هل يُرسل بريد للمستخدم حين أضيفه؟

لا يُرسل زر «إضافة» أي رسالة. البريد يُرسل فقط لروابط التوثيق واستعادة كلمة المرور التي تخص حسابات الباب.

أضفت مستخدماً بنفسي، كيف يدخل؟

لا كلمة مرور له بعد. يطلب استعادة كلمة المرور من صفحة الدخول فيصله رابط يضبط به كلمة مروره، وهذا يحتاج بريداً مضبوطاً على الخادم.