نهاية دورة حياة وشيكة لنظام عرض الودجات

مرحباً بالجميع! كخطوة أخيرة في جهودنا للابتعاد عن نظام العرض القديم “widget” (الأداة)، فإننا نوقف استخدام الأدوات في Discourse وسنقوم بتعطيلها بالكامل قريباً.

الجدول الزمني

هذه تقديرات قابلة للتغيير

يوليو 2025:

  • :white_check_mark: إضافة تحذيرات الإيقاف في النظام الأساسي وإعداد موقع تجريبي لتعطيلها
  • :white_check_mark: نشر إعلان على Meta

أغسطس 2025

  • :white_check_mark: ترقية المكونات الإضافية (plugins) الرسمية ومكونات الثيمات (theme components) لاستخدام Glimmer Components.
  • :white_check_mark: تشغيل Meta مع تعطيل الأدوات.
  • :white_check_mark: تفعيل رسائل الإيقاف مع شريط تحذير للمسؤولين.

الربع الثالث 2025:

  • يجب ترقية المكونات الإضافية والثيمات الخاصة بالجهات الخارجية.

الربع الرابع 2025:

  • :white_check_mark: سيتم تعطيل نظام عرض الأدوات افتراضياً باستخدام deactivate_widgets_rendering: true. ستكون هناك فترة قصيرة يمكن إعادة تمكينه فيها يدوياً.
  • :white_check_mark: إزالة الكود القديم وتعطيل نظام عرض الأدوات

:police_car_light: المكونات الإضافية والثيمات غير المتوافقة ستتوقف عن العمل بشكل صحيح بعد ذلك.

ماذا يعني هذا بالنسبة لك؟

إذا كانت أي من المكونات الإضافية أو الثيمات الخاصة بك تستخدم واجهات برمجة تطبيقات (APIs) خاصة بـ “الأدوات”، فستحتاج إلى تحديثها لاستخدام واجهات برمجة تطبيقات أحدث أو Glimmer Components قبل الموعد النهائي للربع الرابع من عام 2025.

لدي مكونات إضافية أو ثيمات مخصصة مثبتة. هل أحتاج إلى تحديثها؟

ستحتاج إلى تحديث المكونات الإضافية أو الثيمات الخاصة بك إذا كانت تستخدم أياً مما يلي:

  • createWidget
  • decorateWidget أو changeWidgetSetting أو reopenWidget أو attachWidgetAction
  • المكون MountWidget

:bulb: نصيحة احترافية: إذا كان لديك ملحقات تستخدم أياً من هذه التخصيصات، فسترى تحذيراً في وحدة التحكم (console) يحدد المكون الإضافي أو المكون الذي يحتاج إلى الترقية.

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

معرّف الإيقاف هو: discourse.widgets-end-of-life

كيف يرتبط هذا بالتحديث الأخير لـ post-stream؟

كان تدفق المنشورات (post-stream) هو الجزء الرئيسي الأخير في Discourse الذي لا يزال يستخدم نظام عرض الأدوات. مع تحديثه، يمكننا الآن المضي قدماً في التقاعد الكامل لنظام الأدوات. ألقِ نظرة على دليل الترقية لمزيد من التفاصيل حول تلك التغييرات.

كيف أقوم بالترقية؟

إذا كنت تستخدم مكوناً إضافياً أو ثيماً من جهة خارجية: تحقق مما إذا كان المؤلف قد أصدر نسخة مُحدّثة متوافقة مع النظام الجديد.

إذا كنت مؤلف مكون إضافي/ثيم:

  • استبدل الأدوات المخصصة الخاصة بك بـ Glimmer Components
  • استخدم موصلات plugin-outlet لإدراجها في واجهة المستخدم

تحقق من أدلة المطورين للحصول على مزيد من المعلومات حول إجراء هذه التحديثات.

8 إعجابات

عندما تقوم بتحديث تثبيت Discourse الخاص بك في المرة القادمة، سيتم تعطيل نظام عرض الأدوات (widget rendering system) الآن، ولن يتم عرض أي تخصيص يعتمد على الأدوات بعد الآن.

في الوقت الحالي، في المواقع غير المتوافقة، يمكن للمسؤول إعادة تمكين السلوك القديم عن طريق تعديل قيم الإعداد التالي:

  • deactivate_widgets_rendering

هذه هي المرحلة النهائية قبل إزالة الكود القديم من قاعدة كود Discourse، والذي من المتوقع أن يحدث في غضون شهر تقريبًا. بعد ذلك، لن يكون من الممكن إعادة تمكين الأدوات بعد الآن.

6 إعجابات

تم دمج طلب السحب (PR) الذي يزيل نظام الأدوات (widget system) من Discourse بالأمس.

إعجابَين (2)