| الملخص | يقوم بفحص وتدقيق وتنظيف بقايا قاعدة البيانات المتروكة بشكل آمن من قبل الإضافات غير المثبتة. | |
| رابط المستودع | GitHub - canbekcan/discourse-plugin-cleaner · GitHub | |
| دليل التثبيت | كيفية تثبيت الإضافات في Discourse | |
| البرمجة | Vibe Coding - Gemini |

الميزات
عند إلغاء تثبيت إضافة في Discourse، غالبًا ما تترك بيانات مخفية في قاعدة بياناتك. مع مرور الوقت، يمكن أن تؤدي هذه “البقايا” إلى ازدحام قاعدة بياناتك وتعقيد صيانة الموقع. يُعد Discourse Plugin Cleaner أداة إدارية شاملة مصممة لتحديد هذه البيانات المتروكة وإزالتها بشكل آمن.
تشمل الميزات الرئيسية:
- فحص عميق: يفحص جداول قاعدة بيانات متعددة بما في ذلك الحقول المخصصة (المستخدم، الموضوع، المنشور، الفئة، المجموعة)، وإعدادات الإضافات، والمواضيع، والشارات، ومفاتيح API، ووكلاء الويب، ومجموعات الوسوم، والعمليات الرفع.
- وضع التدقيق الآمن (بدون حذف تلقائي): تعمل الإضافة حصريًا كأداة تدقيق حتى تتخذ إجراءً. لن تحذف البيانات تلقائيًا أبدًا. يجب عليك تحديد العناصر التي ترغب في إزالتها يدويًا وتأكيد ذلك.
- تقييم المخاطر: يُخصص تلقائيًا “مستوى المخاطر” (حرج، عالي، متوسط، منخفض، جيد) للعناصر المكتشفة لمساعدة المدراء على اتخاذ قرارات مستنيرة بشأن ما هو آمن للحذف.
- تتبع سجل الإصدارات: يأخذ لقطات للإضافات المثبتة عند التشغيل. إذا تم إزالة إضافة، فإنها تسجل تغيير الحالة، مما ينشئ سجلًا تاريخيًا لما تم إلغاء تثبيته ومتى.
- واجهة إدارية عصرية: توفر لوحة تحكم أنيقة وبديهية مبنية باستخدام مكونات وضع صارم لـ Ember للاندماج السلس في واجهة إدارة Discourse.
الإعداد
تعمل الإضافة خارج الصندوق مع إعدادات افتراضية معقولة. لاستخدام الإضافة:
- الوصول إلى لوحة التحكم: انتقل إلى لوحة تحكم إدارة Discourse. في الشريط الجانبي، ضمن قسم الإضافات، انقر على منظف الإضافة.
- تشغيل فحص: انقر على زر “تشغيل فحص عميق”. سيقوم النظام بالاستعلام عن قاعدة بياناتك وإنشاء تقرير في الوقت الفعلي لجميع البيانات المتروكة التي يجدها.
- مراجعة المشكلات: تصفح عبر علامات التبويب المصنفة (الحقول المخصصة، إعدادات الإضافات، إلخ). انتبه جيدًا لأعمدة
المخاطروالحالة. - تحديد والتنظيف: ضع علامات على العناصر المتروكة التي ترغب في إزالتها.
- تأكيد الحذف: انقر على “حذف المحدد”. سيُطلب منك تحذير تأكيد نهائي قبل حذف البيانات نهائيًا. يتم تسجيل جميع عمليات الحذف تلقائيًا في سجلات إجراءات طاقم العمل في Discourse لأغراض التدقيق الأمني.
(ملاحظة حول العمليات الرفع: إذا تم العثور على عمليات رفع متروكة، ستوجهك الإضافة لتشغيل rake uploads:clean من وحدة تحكم الخادم لاستعادة مساحة القرص فعليًا).
الإعدادات
يمكنك تخصيص صرامة الماسح الضوئي عبر إعدادات موقعك.
| الاسم | الوصف |
|---|---|
plugin_cleaner_orphan_threshold |
الحد الأقصى لعدد السجلات التي يمكن أن يحتوي عليها الحقل المخصص لاعتباره “متروكًا”. إذا كان للحقل المخصص عدد سجلات أقل من هذا الحد، فسيتم تحديده للمراجعة. (الافتراضي: 5، الحد الأدنى: 1، الحد الأقصى: 100) |
plugin_cleaner_stale_api_key_days |
عدد الأيام التي يجب أن يمر فيها مفتاح API دون استخدام قبل أن يحدده الماسح الضوئي على أنه قديم/متروك. (الافتراضي: 90 يومًا، الحد الأدنى: 7، الحد الأقصى: 365) |
plugin_cleaner_stale_upload_days |
عدد الأيام التي يمكن أن يوجد فيها ملف رفع غير مرتبط قبل أن يُعتبر متروكًا. (الافتراضي: 30 يومًا، الحد الأدنى: 1، الحد الأقصى: 365) |
(ملاحظة: هذا هو المشروع لفهم كيفية عمل إضافات Discourse)