خلال الأشهر القليلة الماضية، كنا نعمل على ميزة شريط ترحيب تُعد جزءًا من المنتج الأساسي لـ Discourse. يُعد شريط الترحيب الأساسي هذا بمثابة ترحيب للزوار الجدد والعودة إلى مجتمعك، ويسهل عليهم البحث عن المحتوى الذي يهم احتياجاتهم واهتماماتهم. مع وجود هذا الشريط الأساسي الجديد، نقوم الآن بإيقاف استخدام مكون قالب “شريط البحث” لتقليل تعقيد عروض منتجاتنا وضمان استفادة جميع مستخدمي Discourse من التحسينات المستمرة في الميزة الأساسية.
في هذا الموضوع، سنغطي ما يعنيه الإيقاف بالنسبة للمستخدمين الحاليين لمكون قالب “شريط البحث”.
إذا كنت عميلًا مُستضافًا لدينا…
سنبدأ بنقل العملاء المستضافين من مكون شريط البحث إلى ميزة شريط الترحيب في 20 نوفمبر 2025. إذا كنت تستخدم هذا المكون حاليًا، فستتلقى رسالة تحتوي على تفاصيل التوقيت الدقيق لمستوى خطتك.
سيتم خلال هذا النقل نسخ أي نصوص موقع قمت بتحديثها للعنصر النمطي (مثل search_banner.headline، search_banner.subhead، search_banner.search_button_text) وقيم إعدادات مكون القالب show on، plugin outlet، وbackground image إلى إعدادات الميزة الأساسية.
هدفنا هو تقليل التأثير المرئي لهذا الانتقال، بحيث يبدو الشريط الذي تم إنشاؤه بواسطة الميزة الأساسية مماثلًا للشريط الذي تم إنشاؤه بواسطة مكون القالب. قد يلاحظ المجتمعات التي تستخدم صورة على شريطها تحركًا طفيفًا في موقعها، ويمكن معالجة ذلك عن طريق قص الصورة لمركز المحتوى الذي ترغب في ظهوره في الشريط.
بعد هذا النقل، سيتم تعطيل مكون القالب ويمكن حذفه بأمان من صفحة القوالب والمكونات (/admin/config/customize/components).
إذا كنت مستخدمًا مُستضافًا ذاتيًا…
يجب أن تخطط للانتقال من مكون القالب إلى الميزة الأساسية بحلول 15 ديسمبر 2025. يمكنك القيام بذلك يدويًا أو باستخدام النص البرمجي المقدم.
التحويل اليدوي
إليك خريطة توضح كيف ترتبط إعدادات ونصوص موقع مكون شريط البحث مع نفس الميزات في شريط الترحيب الأساسي:
| وصف الإعداد | مكون شريط البحث النمطي | ميزة شريط الترحيب الأساسية |
|---|---|---|
| نص العنوان المعروض على شريط الترحيب. | search_banner.headline نص الموقع |
js.welcome_banner.header.anonymous_members و js.welcome_banner.header.logged_in_members نصوص الموقع |
| نص التوضيح المعروض على شريط الترحيب. | search_banner.subhead نص الموقع |
js.welcome_banner.subheader.anonymous_members و js.welcome_banner.subheader.logged_in_members نصوص الموقع |
| النص المستخدم لزر البحث على الشريط. \* | search_banner.search_button_text نص الموقع |
js.welcome_banner.search_placeholder نص الموقع |
| إعداد لتحديد الصفحات التي تظهر فيها شريط الترحيب. | إعداد مكون القالب show on |
إعداد الموقع Welcome banner page visibility |
| إعداد لتحديد المكان الذي يظهر فيه شريط الترحيب على الصفحة. | إعداد مكون القالب plugin outlet |
إعداد الموقع Welcome banner location |
| الصورة الخلفية المستخدمة على شريط الترحيب. | إعداد مكون القالب background image light |
إعداد الموقع Welcome banner image |
\* ملاحظة: لا تدعم ميزة شريط الترحيب الأساسي زر بحث صريح، لذلك نوصي بربط هذا النص بنص مكان البحث القابل للتخصيص للحصول على نتيجة مشابهة.
التحويل باستخدام النص البرمجي
يتكون التحويل من ثلاث مهام rake يجب تشغيلها بالترتيب التالي:
- نقل إعدادات المكون:
themes:advanced_search_banner:1_migrate_settings_to_welcome_banner - نقل ترجمات المكون:
themes:advanced_search_banner:2_migrate_translations_to_welcome_banner - تمكين الشريط الأساسي، واستبعاد المكون من القوالب التي تستخدمه، وتعطيل المكون:
themes:advanced_search_banner:3_exclude_and_disable
ملفات \u003crandom_name\u003e.sh التي يجب تشغيلها داخل الحاوية:
task_1.sh:
#!/bin/bash
cd /var/www/discourse && rake themes:advanced_search_banner:1_migrate_settings_to_welcome_banner
task_2.sh:
#!/bin/bash
cd /var/www/discourse && rake themes:advanced_search_banner:2_migrate_translations_to_welcome_banner
task_3.sh:
#!/bin/bash
cd /var/www/discourse && rake themes:advanced_search_banner:3_exclude_and_disable
من المستحسن تشغيل كل مهمة rake بشكل منفصل للحصول على تحكم أفضل في عملية التحويل.
كما تتوفر مهمة مريحة themes:advanced_search_banner:migrate_all لتشغيل الثلاثة بشكل متتالي، ولكن استخدمها على مسؤوليتك الخاصة.