كيفية المساعدة في تصحيح أخطاء إضافة ووردبريس

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

سنشرح في هذا المقال كيفية تزويد المطور بالمعلومات الصحيحة ليتمكن من فهم الخطأ وحلّه بسرعة. سيُقسّم هذا المقال إلى ثلاث خطوات سنتبعها لتزويد المطور بالمعلومات الصحيحة عند حدوث مشكلة:

• قم بتفعيل سجل التصحيح
• قم بتثبيت إضافة استكشاف الأخطاء وإصلاحها
• التحقق من أخطاء جافاسكريبت

قم بتفعيل نظام تصحيح الأخطاء وتسجيل الأحداث في ووردبريس

أولاً، علينا أن نعرف ما WP_DEBUG ؛ كما هو موضح في ويكيبيديا، " WP_DEBUG هو PHP (متغير عام دائم) يُستخدم لتفعيل وضع "التصحيح" في جميع أنحاء ووردبريس. يُفترض أن قيمته الافتراضية هي خطأ، وعادةً ما يتم ضبطها على صحيح في ملف wp-config.php في نسخ التطوير من ووردبريس."

كما نرى، فإن WP_DEBUG هو ثابت يكون معطلاً ولكن يمكننا تشغيله لغرض تصحيح الأخطاء بشكل مؤقت. 

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

سنشرح لك بالتفصيل كيفية تفعيل هذه الميزة، وكيف سيبدو الأمر في حال وجود خطأ في إضافتك. سنستخدم إضافة WP Meta SEO كمثال، ولكن يمكنك اتباع نفس الخطوات مع جميع إضافاتنا. في هذه الحالة، نواجه مشكلة مع إضافة WP Meta SEO ، وقد تكون أي مشكلة، لذا سنقوم بفتح ملف wp-config.php. يمكنك القيام بذلك باستخدام برنامج تحرير النصوص الذي تفضله، مثل المفكرة أو Visual Studio Code أو Brackets. ما عليك سوى فتح ملف wp-config.php .

يوجد الملف في جذر خادمك، حيث تم تثبيت موقع WordPress الخاص بك.

افتح الملف باستخدام محرر النصوص، ثم اضغط على CTRL + F أو انقر على تحرير > بحث... ستظهر لك خانة يمكنك كتابة الكلمة التي تريد البحث عنها، في هذه الحالة، سنكتب "WP_DEBUG" ونضغط على Enter حتى نجد:
"define( 'WP_DEBUG', false )"

الآن وقد وصلنا إلى هذا السطر، قم بإزالة "false" واكتب true، ثم اضغط على Enter وفي السطر التالي انسخ define( 'WP_DEBUG_LOG', true ); واحفظ الملف، يجب أن يبدو مثل الصورة التالية.

إذا تم تغيير هذين السطرين، فسيظهر ملف باسم "debug.php" في /wp-content/

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

قم بتثبيت إضافة استكشاف الأخطاء وإصلاحها في ووردبريس

إضافة "فحص الصحة واستكشاف الأخطاء وإصلاحها" هي إضافة تتيح لك إجراء فحص للتعارضات دون التأثير على زوار موقعك العاديين. تتميز بسهولة استخدامها وتثبيتها، وسنستخدم إضافة WP Meta SEO كمثال. اتبع الخطوات التالية لتثبيت إضافة "فحص الصحة واستكشاف الأخطاء وإصلاحها" وإجراء فحص للتعارضات:  

• قم بتسجيل الدخول إلى موقع ووردبريس الخاص بك، وستجد نفسك في لوحة تحكم الموقع
• انقر على "الإضافات" في القسم الأيسر من صفحتك
• انقر على "إضافة جديد"
• اكتب "الفحص الصحي واستكشاف الأخطاء وإصلاحها" في شريط البحث، كما هو موضح أدناه

• انقر على "التثبيت الآن"، ستظهر قائمة الإضافات تلقائيًا، ابحث عن الإضافة المناسبة وانقر على "التثبيت الآن" ثم على "تفعيل".

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

• انقر على "استكشاف الأخطاء وإصلاحها" ، واقرأ معلومات التحذير، ثم انقر فوق "الدخول إلى وضع استكشاف الأخطاء وإصلاحها". 

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

• أعد إنتاج المشكلة التي كنت تواجهها

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

• انقر على "الإضافات" > "الإضافات المثبتة"

  ستظهر قائمة "الإضافات" لتمنحك خيارات إضافية. انقر على "الإضافات المثبتة"

• انقر على "تمكين أثناء استكشاف الأخطاء وإصلاحها" بجوار WP Meta SEO

• قم بإعادة إنتاج المشكلة التي كنت تواجهها فقط WP Meta SEO واستخدام قالب افتراضي، إذا حدثت المشكلة، فإن سببها هو الإضافة الخاصة بنا.

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

فحص وتصحيح أخطاء جافا سكريبت في إضافات ووردبريس

سنبحث عن أخطاء جافا سكريبت باستخدام وحدة تحكم Chrome أو Firefox. يختلف اسمها قليلاً حسب المتصفح، ولكن سنستخدم مصطلح "وحدة التحكم" (Console) في Chrome وFirefox. لفتح وحدة التحكم، اتبع الخطوات التالية:  

• انقر بزر الماوس الأيمن على "فحص" في واجهة المستخدم في أي جزء من الموقع

• حدد "وحدة التحكم"، وسيتم فتح أدوات المطور على الجانب الأيمن من الصفحة، انقر فوق "وحدة التحكم".

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

إذا وجدت خطأ في JavaScript، فيرجى أخذ لقطة شاشة للنسخة الموسّعة من الخطأ لتضمينها في تذكرة الدعم/المنشور.

أرسل/شارك تقرير مشكلتك

الآن بعد أن أصبحت لديك كل هذه المعلومات، ستساعد المطوّر على تسريع العملية، ما عليك سوى استخدام كل المعلومات التي جمعتها وإضافتها إلى تذكرة الدعم/المنشور الخاص بك، ولنتذكّر، العناصر هي:  

• debug.log
• ملاحظة بخصوص الإضافات التي تسبب تعارضات
• لقطة شاشة لوحدة تحكم جافا سكريبت مع الخطأ

إذا اتبعت هذه الخطوات وأرسلت لنا المعلومات الصحيحة، سيتمكن المطور من إجراء عملية تصحيح أسرع ونشكرك جزيل الشكر مسبقًا :)    

أنشئ وشارك حساب مستخدم ووردبريس جديدًا لأغراض الدعم

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

• لا نقوم بتخزين بيانات الاعتماد القديمة بعد حل المشكلة (لأسباب أمنية)
• نوصي بإزالة حسابات المستخدمين الإداريين التي تم إنشاؤها لأغراض الدعم
• جميع المعلومات التي تتم مشاركتها مع فريقنا آمنة وستبقى خاصة

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

ثم، يجب عليك الذهاب إلى القائمة اليسرى > المستخدمون.

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

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

في كلمة المرور ، يمكنك استخدام مولد كلمات مرور عشوائي أو تعيين كلمة مرور خاصة بك. كما يمكنك تحديد "إرسال إشعار للمستخدم" إذا كنت ترغب في إرسال بريد إلكتروني إلى المستخدم الجديد بخصوص حسابه.

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

وأخيرًا، انقر على "إضافة مستخدم جديد" في الأسفل. تمّ الأمر بالفعل، بالتوفيق!