FX - Trending Tags - الوسوم الرائجة لـ XenForo 1.1.0

codeNET · اليوم في 6:09 صباحاً

[FX] Trending Tags - الوسوم الرائجة لـ XenForo

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

الميزات الرئيسية

1. شريط الوسوم الرائجة بعرض كامل تحت شريط التنقل

يعرض تلقائياً شريط كلمات مفتاحية رائجة جذاباً مباشرة أسفل شريط التنقل الرئيسي (PAGE_CONTAINER).
واجهة حديثة موسومة بشارة لهب نشطة (fa-fire)، تتميز بتمرير أفقي سلس عبر جميع أحجام الشاشات (الجوال، الجهاز اللوحي، سطح المكتب).
توافق أصلي سلس مع الوضعين الفاتح والداكن.

2. ودجت الوسوم الرائجة المخصص

يوفر معرف تعريف الودجت: fx_trending_tags، جاهز للوضع في أي موضع ودجت عبر منتداك (الشريط الجانبي للبوابة/الرئيسية، قوائم المواضيع، عرض الموضوع، إلخ).
يتيح للمسؤولين تخصيص عنوان الودجت وأيقونة FontAwesome مباشرة من لوحة تحكم الإدارة.

3. إدارة مباشرة من الواجهة الأمامية (نافذة منبثقة)

سيرى الأعضاء الحاصلون على الصلاحيات المخصصة أيقونة ترس إدارة سريعة (fa-cog) بجوار شريط الوسوم مباشرة.
فتحها يظهر نافذة إدارة تفاعلية:
إضافة جديد: أضف وسوماً غير محدودة مع عنوان ورابط وترتيب عرض.
تعديل: حدّث العنوان أو الرابط أو غيّر أولوية العرض (display_order).
حذف: حذف فوري بنقرة واحدة للوسوم المنتهية.
مزامنة تلقائية: تتحدث ودجت وشريط الواجهة الأمامية فوراً عند الحفظ دون الحاجة لتدخل من لوحة التحكم.

4. تخزين مؤقت متعدد المستويات عالي الأداء

المستوى الأول: مزود التخزين المؤقت لـ XF (\XF::app()->cache()): يقوم بتخزين قوائم الوسوم تلقائياً في خلفيات عالية الأداء مثل Redis أو Memcached أو APCu إذا كانت مهيأة على الخادم.
المستوى الثاني: XF SimpleCache (\XF::app()->simpleCache()): يستمر مباشرة داخل سجل التحميل التلقائي لـ XenForo.
يضمن أنه حتى على الخوادم التي لا تحتوي على Redis/Memcached، تحقق الإضافة 0 استعلامات لقاعدة البيانات عبر جميع الصفحات لأن قائمة الوسوم تُحمَّل مسبقاً في ذاكرة الوصول العشوائي عند بدء تشغيل XenForo.
إبطال وإعادة بناء في الوقت الفعلي: مدعوم بخطافات دورة حياة الكيان (_postSave، _postDelete) في Entity\Tag: في أي وقت يتم فيه إضافة وسم أو تعديله أو حذفه عبر النافذة الأمامية أو API أو سكربت سطر الأوامر، يتم إبطال طبقات التخزين المؤقت وإعادة بنائها فوراً.

التكوين والصلاحيات

1. الخيارات (AdminCP > Options > [FX] Trending Tags)

fx_tt_show_under_nav | نوع البيانات: منطقي (تشغيل/إيقاف) | الافتراضي: تشغيل | الوصف: يدرج تلقائياً شريط الوسوم الرائجة تحت شريط التنقل الرئيسي (قبل محتوى الصفحة).
fx_tt_allowed_groups | نوع البيانات: مجموعات المستخدمين (اختيار متعدد) | الافتراضي: فارغ | الوصف: مجموعات المستخدمين المسموح لها بالنقر على أيقونة الترس وإدارة الوسوم الرائجة من الواجهة الأمامية.

2. صلاحيات مجموعات المستخدمين

الصلاحية: [FX] Manage Trending Tags (المجموعة: الصلاحيات العامة).
تسمح بتفويض صلاحيات دقيقة لمجموعات مستخدمين محددة أو مستخدمين فرديين عبر نظام الصلاحيات القياسي في XenForo.

التثبيت والترقية

التثبيت عبر لوحة التحكم:

ارفع مجلد FX/TrendingTags إلى src/addons/FX/TrendingTags/.
انتقل إلى AdminCP > Add-ons، وابحث عن [FX] Trending Tags واضغط Install.
انتقل إلى AdminCP > Options > [FX] Trending Tags لاختيار مجموعات الإدارة المسموح بها.
سجّل الدخول كمستخدم مصرح، زر الصفحة الرئيسية، واضغط أيقونة الترس لإضافة أول وسوم رائجة لك.

التثبيت / إعادة البناء عبر سطر الأوامر (CLI):

كود:

php cmd.php xf-addon:install FX/TrendingTags
# أو إعادة بناء بيانات الإضافة:
php cmd.php xf-addon:rebuild FX/TrendingTags

بنية مجلد الإضافة

كود:

src/addons/FX/TrendingTags/
├── Entity/
│ └── Tag.php                          # الكيان الذي يمثل جدول xf_fx_trending_tag مع خطافات دورة حياة التخزين المؤقت
├── Pub/Controller/
│ └── Trending.php                     # المتحكم الذي يعالج نموذج التعديل الأمامي وحفظ الوسوم
├── Repository/
│ └── Tag.php                          # المستودع الذي يدير الاستعلامات وطرق XF Cache / SimpleCache
├── Widget/
│ └── TrendingTags.php                 # معالج ودجت الوسوم الرائجة
├── _data/
│ ├── options.xml                      # خيارات التكوين (تبديل شريط التنقل ومجموعات الإدارة)
│ ├── option_groups.xml                # مجموعة خيارات fx_trending_tags
│ ├── phrases.xml                      # عبارات اللغة
│ ├── routes.xml                       # مسار trending-tags
│ ├── templates.xml                    # قوالب شريط الوسوم ونموذج التعديل وLESS
│ ├── template_modifications.xml       # تعديل القالب لإدراج شريط الوسوم في PAGE_CONTAINER
│ └── widget_definitions.xml           # تعريف الودجت لـ fx_trending_tags
├── addon.json                         # بيانات وصفية للإضافة (v1.0.4)
├── hashes.json                        # التحقق من سلامة الملفات SHA256
├── Listener.php                       # مستمع الاستدعاء لإدراج شريط الوسوم تحت التنقل
├── Setup.php                          # المثبّت الذي ينشئ جدول xf_fx_trending_tag وتنظيف إلغاء التثبيت
└── logo.png                           # شعار الإضافة

الترخيص والحقوق

العلامة التجارية: FX Add-on Suite
التوافق: XenForo 2.3.0 أو أحدث
المصدر: طُوّرت حصرياً لأنظمة XenForo.