كيفية تفعيل وضع التصحيح في ووردبريس

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

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

تحديد موقع ملف wp-config.php

الخطوة الأولى لتفعيل وضع التصحيح هي العثور على ملف wp-config.php. يوجد هذا الملف في المجلد الجذري لتنصيب ووردبريس، في نفس المكان الذي ستجد فيه wp-content، wp-includes و wp-admin. يمكنك الوصول إليه عبر برنامج FTP، مدير الملفات في لوحة تحكم الاستضافة أو محليًا إذا كنت تعمل على خادم تطوير.

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

تفعيل WP_DEBUG

داخل ملف wp-config.php مرر حتى تجد سطرًا مشابهًا لهذا: define( 'WP_DEBUG', false );. هذا السطر يتحكم فيما إذا كان وضع التصحيح مفعلًا أم لا. بشكل افتراضي، يقوم ووردبريس بتعطيل التصحيح لأسباب تتعلق بالأمان والأداء. لتفعيله، ما عليك سوى تغيير القيمة من false إلى true.

السطر الصحيح يجب أن يبدو هكذا: define( 'WP_DEBUG', true );. بعد حفظ الملف، سيبدأ ووردبريس فورًا بعرض التحذيرات، الإشعارات ورسائل أخطاء PHP على موقعك بأكمله. هذا سيمكنك من تحديد الإضافات، القوالب أو الأكواد المخصصة التي تسبب المشاكل.

استخدام WP_DEBUG_LOG لتسجيل الأخطاء

عرض الأخطاء على الشاشة قد يكون مفيدًا أثناء التطوير، لكنه ليس عمليًا دائمًا. للمراقبة طويلة الأمد، يمكنك تفعيل WP_DEBUG_LOG. للقيام بذلك، أضف السطر التالي مباشرة أسفل ثابت WP_DEBUG: define( 'WP_DEBUG_LOG', true );. هذا سيخزن جميع الأخطاء في ملف debug.log داخل مجلد wp-content.

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

إخفاء الأخطاء عن الزوار

إذا كان موقع ووردبريس الخاص بك مباشرًا، فأنت بالتأكيد لا تريد أن يرى الزوار رسائل الأخطاء الخام. في هذه الحالة، يمكنك إضافة إعداد آخر لتعطيل عرضها في الواجهة الأمامية: define( 'WP_DEBUG_DISPLAY', false );. هذا يضمن أن الأخطاء ستظل مسجلة ولكن لن تظهر للمستخدمين.

بالإضافة إلى ذلك، يمكنك إضافة @ini_set( 'display_errors', 0 ); لتعزيز هذا السلوك. هذا المزيج يحافظ على موقعك احترافيًا وآمنًا بينما تبقى المعلومات الضرورية متاحة في سجل التصحيح للمسؤولين والمطورين.

التصحيح المتقدم باستخدام SCRIPT_DEBUG

للمطورين الذين يعملون مع JavaScript وCSS، يقدم ووردبريس ثابتًا إضافيًا: define( 'SCRIPT_DEBUG', true );. بشكل افتراضي، يقوم ووردبريس بتحميل نسخ مضغوطة من السكربتات والأنماط. عند تفعيل تصحيح السكربتات، يجبر ووردبريس على تحميل النسخ الكاملة غير المضغوطة، مما يسهل فحصها وتصحيحها.

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

باختصار، تفعيل وضع التصحيح في ووردبريس هو طريقة بسيطة لكنها قوية لاستكشاف الأخطاء والحفاظ على موقعك. من خلال تعديل ملف wp-config.php، يمكنك عرض الأخطاء، تخزينها في السجلات والحفاظ على مظهر احترافي حتى أثناء حدوث المشاكل. عند استخدامه بشكل صحيح، يعد وضع التصحيح أحد أهم الأدوات للحفاظ على ووردبريس آمنًا، مستقرًا وملائمًا للمطورين.