الإعلان عن إعدادات الموقع القابلة للتخصيص

[martin (Martin Brennan)]

هذا موضوع شقيق للإعلان الموجود في Themeable site settings are now available حتى يكون المطورون على علم.

@martin

أين يتم تعريفها؟

يتم تعريف إعدادات الموقع القابلة للتخصيص في ملف config/site_settings.yml الأساسي. كل إعداد موقع قابل للتخصيص لديه خيار themeable: true محدد.

في الوقت الحالي، إعدادان فقط للموقع قابلان للتخصيص - enable_welcome_banner و search_experience - ولكن في المستقبل من المرجح أن نجعل المزيد من إعدادات الموقع قابلة للتخصيص.

كيف يمكن لمؤلفي السمات التحكم في القيم الافتراضية؟

يمكن لمؤلفي السمات تحديد تجاوزات لإعدادات الموقع القابلة للتخصيص في ملف about.json تحت مفتاح theme_site_settings على النحو التالي:

"theme_site_settings": {
  "enable_welcome_banner": false
}

سيتم حفظ أي قيمة هنا في قاعدة البيانات وربطها بالسمة. بمجرد حفظ القيمة، لن تؤثر التغييرات على theme_site_settings في ملف about.json عند تحديث سمة ما على القيمة المحفوظة حاليًا في قاعدة البيانات، حيث لا يمكننا معرفة ما إذا كان المسؤول قد قام بتغيير الإعداد في هذه الأثناء.

ما هي قيود إعدادات الموقع القابلة للتخصيص؟

تم تصميم إعدادات الموقع القابلة للتخصيص فقط للتحكم في عناصر واجهة المستخدم، وعند استرداد قيمتها، نطلب معرف السمة، لذا تنطبق هذه القيود:

• لا يمكن استخدام إعدادات الموقع القابلة للتخصيص في مهام Sidekiq
• لا يمكن استخدام إعدادات الموقع القابلة للتخصيص في قواعد markdown
• سيتم تخزين إعدادات الموقع القابلة للتخصيص مؤقتًا بشكل منفصل عن إعدادات موقع العميل باستخدام معرف السمة كمفتاح
• ستقوم إعدادات الموقع القابلة للتخصيص بتجاوز المفاتيح في خدمة siteSettings على العميل باستخدام مُحمّل التطبيق المسبق
• لن يتضمن SiteSetting.client_settings_json إعدادات الموقع القابلة للتخصيص، بدلاً من ذلك يمكنك استدعاء SiteSetting.theme_site_settings_json بمعرف سمة

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

الطلب الأولي هنا https://github.com/discourse/discourse/pull/32233

وثائق المطورين هنا https://meta.discourse.org/t/controlling-site-settings-with-themes/374376