شرح مشكلة خطأ الـ Exception عند حذف إضافات XenForo

[مهدي حميد]

حل مشكلة خطأ الـ Exception عند حذف إضافات XenForo
دليل شامل لإصلاح انهيار الموقع بعد حذف الإضافات يدوياً

---

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

Exception: Could not find class XenConcept\HideBBCode\XF\Template\Templater when attempting to extend XF\Template\Templater

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

---

خطوات الحل الجذري:

1. استعادة الوصول للموقع (وضع الطوارئ):
إذا كان موقعك متوقفاً تماماً ولا تستطيع دخول لوحة التحكم، اتبع الآتي:

• توجه إلى ملفات الموقع عبر File Manager أو FTP.
• افتح الملف المسار التالي: src/config.php.
• أضف الكود التالي في نهاية الملف:

$config['enableListeners'] = false;

*هذا الكود سيعطل عمل جميع الإضافات مؤقتاً، مما يسمح للموقع بالعمل لكي تتمكن من إصلاحه.*

2. استعادة ملفات الإضافة المفقودة:
بما أن السيرفر يشتكي من فقدان "كلاس" معين، يجب عليك إعادة رفع مجلد الإضافة الذي حذفته إلى مساره الصحيح داخل مجلد src/addons/.
ملاحظة: بمجرد إعادة الملفات، سيتعرف عليها نظام XenForo مجدداً.

3. إلغاء التثبيت بالطريقة الصحيحة:
بعد استعادة الملفات ودخول لوحة التحكم:

1. توجه إلى الإضافات (Add-ons).
2. ابحث عن الإضافة المسببة للمشكلة.
3. اضغط على زر (الترس أو السهم) واختر إلغاء التثبيت (Uninstall).
4. انتظر حتى ينتهي النظام من حذف المدخلات من قاعدة البيانات تماماً.

4. تنظيف الكاش (التخزين المؤقت):
بعد حذف الإضافة، يفضل دائماً تنظيف الذاكرة لضمان عدم وجود بقايا:

• توجه إلى الأدوات (Tools) > إعادة بناء التخزين المؤقت (Rebuild caches).
• قم بعمل Rebuild لبيانات القوالب (Templates).

---

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

---

تم إعداد هذا الشرح للمساعدة في تجاوز أخطاء امتداد الكلاسات في سكربت XenForo.