استخدام الوضع الآمن لاستكشاف الأخطاء وإصلاحها في السمات والإضافات

[Discourse]

يشرح هذا الدليل كيفية استخدام الوضع الآمن في Discourse لاستكشاف الأخطاء وإصلاحها المتعلقة بالمظاهر والإضافات.

مستوى المستخدم المطلوب: جميع المستخدمين

توفر منصة Discourse “وضع الأمان للـ JavaScript” الذي يسمح لأي مستخدم بعزل السبب الجذري لمشاكل JavaScript الناجمة عن الإضافات أو المظاهر أو مكونات المظاهر. تُعد هذه الميزة مفيدة بشكل خاص لاستكشاف الأخطاء وإصلاحها في موقع Discourse الخاص بك.

الوصول إلى الوضع الآمن

للوصول إلى الوضع الآمن، اتبع الخطوات التالية:

1. افتح علامة تبويب جديدة في المتصفح.

2. أدخل عنوان URL التالي في شريط العناوين، مع استبدال [your-site-name](http://discourse.example.com) بنطاق موقع Discourse الفعلي الخاص بك:

   http://discourse.example.com/safe-mode
   

   على سبيل المثال، يكون عنوان URL للوضع الآمن لموقع Demo الخاص بـ Discourse هو:
   https://try.discourse.org/safe-mode

3. انقر فوق زر “الدخول إلى الوضع الآمن”:
   

   

خيارات الوضع الآمن

عند الدخول إلى الوضع الآمن، يمكنك الاختيار من بين الخيارات التالية:

• تعطيل المظاهر ومكونات المظاهر
• تعطيل تخصيصات الإضافات غير الرسمية من جانب العميل
• تعطيل جميع تخصيصات الإضافات من جانب العميل
• جعل تحذيرات JavaScript (deprecations) تثير خطأ

بشكل افتراضي، يتم تحديد الخيارات الثلاثة الأولى. أما خيار أخطاء التحذيرات (deprecation errors) فهو غير محدد افتراضيًا، وهو مفيد بشكل أساسي لمطوري الإضافات والمظاهر الذين يختبرون التوافق مع تحديثات Discourse القادمة. يمكنك الدخول إلى الوضع الآمن عدة مرات باستخدام مجموعات مختلفة لعزل المكون المحدد الذي يسبب المشاكل في موقعك.

استخدام الوضع الآمن

1. حدد الخيارات المطلوبة في صفحة الوضع الآمن.
2. انقر فوق “الدخول إلى الوضع الآمن” لتطبيق تحديداك.
3. سترى شريطًا يشير إلى أن الوضع الآمن مفعل.
4. تصفح موقعك للتحقق مما إذا كانت المشكلة لا تزال قائمة مع تعطيل المكونات المحددة.

الخروج من الوضع الآمن

لخروج من الوضع الآمن، ما عليك سوى إغلاق علامة التبويب في المتصفح.

ملاحظات هامة

عند مشاركة رابط الوضع الآمن لموقعك، انتبه إلى أنه يجب فتحه في علامة تبويب جديدة أو إضافته مباشرة إلى شريط العناوين؛ وإلا فقد لا يعمل بشكل صحيح.

يعطل الوضع الآمن حاليًا الأجزاء الخاصة بـ JavaScript من الإضافات فقط. لتعطيل الجزء الخاص بالخادم (server-side) من إضافة ما، يجب عليك إعادة بناء الحاوية مع تعليق الإضافة.

استكشاف الأخطاء وإصلاحها

إذا لم تتمكن من تحميل صفحة اختيار الوضع الآمن الأولية، فحاول زيارة عنوان URL التالي، والذي سيتجاوز الصفحة ويحمل الوضع الآمن مباشرة:

https://discourse.example.com/?safe_mode=no_themes,no_plugins

على سبيل المثال: https://try.discourse.org/?safe_mode=no_themes,no_plugins

القيم المتاحة لمعلمة الاستعلام safe_mode هي: no_themes، no_unofficial_plugins، no_plugins، و deprecation_errors. يمكن دمج هذه القيم باستخدام الفواصل.