مرجع الإعدادات.

تعلّم DXPR Builderالمرجعالإعداد وAPI

يخزّن DXPR Builder إعداداته في نظام إعدادات Drupal. تسرد هذه الصفحة كل مفتاح معلَن في config/schema/dxpr_builder.schema.yml مع نوعه وقيمه المسموحة وافتراضيه. وتسرد أيضًا مفتاح status لكل كيان إعدادات ومفاتيح الإعدادات التي تقرؤها الشيفرة دون مدخل مخطط. والأسماء العريضة هي تسميات النماذج.

لا تشحن الوحدة ملف config/install/dxpr_builder.settings.yml. فتضبط الافتراضيات hook_install() وخطافات التحديث في dxpr_builder.install، أو تُطبَّق في الشيفرة عند غياب مفتاح؛ ويذكر عمود الافتراضي أيهما.

الإعدادات العامة

كائن الإعدادات: dxpr_builder.settings

مسار الإدارة: /admin/dxpr_studio/dxpr_builder/settings (src/Form/DxprBuilderSettingsForm.php)

المفتاح النوع القيم المسموحة الافتراضي الوصف
json_web_token string مفتاح منتج DXPR (JWT) فارغ مفتاح المنتج، فقط عندما يكون api_key_storage بقيمة config. يُمسَح عندما يُخزَّن المفتاح في وحدة Key؛ ويزيل التحديث 9026 قيمة متروكة هناك.
api_key_storage string config (تخزين الإعدادات)، key (وحدة Key) غير مضبوط (يُعامَل كـ config)؛ وkey بعد أن ينقل dxpr_builder_update_9020() مفتاحًا موجودًا طريقة التخزين لمفتاح المنتج.
key_provider string معرف كيان Key فارغ؛ ويضبط التحديث 9020 القيمة dxpr_builder_jwt عندما ينقل مفتاحًا موجودًا كيان المفتاح الذي يحمل مفتاح المنتج عندما يكون api_key_storage بقيمة key.
bootstrap string 0، bs5 غير مضبوط (لا تُحمَّل ملفات Bootstrap) تحميل ملفات Bootstrap جانبيًا: 0 = بلا (القالب يوفر Bootstrap)، وbs5 = Bootstrap 5. ويعيد التحديث 8040 كتابة القيمتين المزالتين 1 وbs4 إلى bs5.
cke_stylesset string مدخل واحد [label]=[element].[class] في كل سطر فارغ (فيستخدم المحرر حينها الأنماط المشحونة مع DXPR Builder) أنماط مخصصة لمحرر النصوص، مثل Sassy Title=h1.sassy-title.
editor_assets_source integer 0، 1، 2 غير مضبوط (0) مصدر الأصول: 0 = السحابة، و1 = محلي (مصغّر)، و2 = محلي (غير مصغّر). ولا يظهر الحقل إلا عندما توجد بنية محلية في مجلد dxpr_builder/ الخاص بالوحدة. ومع تخزين 0، ما زالت تلك البنية تُستخدَم، غير المصغّرة أولًا.
format_filters boolean true، false غير مضبوط (مغلق) تطبيق مرشحات تنسيق النص على محتوى الواجهة.
media_browser string '' (الرفع الأساسي للملفات) أو media_library (مكتبة الوسائط) أو media_library_acquia_dam (مكتبة الوسائط (Acquia DAM)) أو معرف Entity Browser media_library عندما تكون وحدة مكتبة الوسائط مثبّتة، وإلا dxpr_builder_media_modal عندما تكون dxpr_builder_media مثبّتة، وإلا '' (يضبطها hook_install()) نوع المتصفح الذي تستخدمه حقول الصور.
offset_selector string محدد CSS .dxpr-theme-header--sticky, .dxpr-theme-header--fixed (يُطبَّق عند الفراغ) محدد إزاحة التمرير للترويسات الثابتة.
controls_layout string element (على كل عنصر)، breadcrumb (صف واحد) element (يُطبَّق عند الفراغ) أشرطة التحكم في وضع التحرير: شريط على كل عنصر، أو صف واحد فوق العنصر الذي تشيرون إليه. ويتجاوزه ملف تعريف وإعداد المستخدم الخاص. وإعداد المستخدم ليس إعدادات: بل يُخزَّن مع حساب المستخدم (user.data، الوحدة dxpr_builder، الاسم controls_layout).

إعدادات الذكاء الاصطناعي

مخزّنة في كائن dxpr_builder.settings نفسه.

مسار الإدارة: /admin/dxpr_studio/dxpr_builder/ai_settings (src/Form/DxprBuilderAiSettingsForm.php)

المفتاح النوع القيم المسموحة الافتراضي الوصف
ai_enabled boolean true، false true عند الغياب؛ ويضبطه التحديث 9008 تفعيل مساعد تحرير النصوص.
ai_page_enabled boolean true، false true عند الغياب؛ ويضبطه التحديث 9012 تفعيل مساعد إنشاء الصفحات.
ai_image_enabled boolean true، false true عند الغياب؛ ويضبطه التحديث 9015 تفعيل توليد الصور.
ai_user_model_selection boolean true، false true عند الغياب؛ ويضبطه التحديث 9016 السماح للمستخدمين باختيار النموذج. لا يُعرض إلا عندما تكون ai_provider_dxpr غير مثبّتة.
ai_model string dxai_kavya_m1، dxai_kavya_m1_eu، dxai_kavya_m1_fast dxai_kavya_m1 (AiModelConstants::getDefaultModel()) النموذج الافتراضي. وأسماء API هي kavya-m1 وkavya-m1-eu وkavya-m1-fast. لا يُعرض ولا يُحفَظ إلا عندما تكون ai_provider_dxpr غير مثبّتة.
ai_provider_selection_mode string automatic (تلقائي)، manual (أولوية يدوية) automatic وضع موفري الخدمات. ويستخدم manual الترتيب في ai_providers. لا يُحفَظ إلا عندما تكون ai_provider_dxpr غير مثبّتة.
ai_providers تسلسل تعيينات بمفتاح معرف الموفر المفاتيح: anthropic وgemini وmistral وopenai وxai. ولكل منها enabled (قيمة boolean) وweight (عدد صحيح) وregion (بقيمة enabled أو disabled) فارغ (فيسرد النموذج حينها الخمسة كلها كمفعّلة) جدول أولوية الموفرين لوضع manual. فـ region هي قسم الجدول الذي يجلس فيه الصف، لا منطقة جغرافية.
tone_of_voice_vocabulary string معرف مفردات تصنيف ai_tone_of_voice (مفردات تنشئها hook_install() عندما تكون Taxonomy مفعّلة، وينشئها التحديث 9007) مفردات نبرة الصوت. يعيد التحديث 9025 توجيه القيمة إلى ai_tone_of_voice عندما تعود المفردات المخزّنة غير موجودة.
enable_taxonomy_tones boolean true، false true متى ضُبِطت مفردات نبرة تُضبَط إلى true مع المفردات، مع hook_install() أو التحديثات أو النموذج. بلا حقل نموذج، ولا تقرؤها أي شيفرة.
commands_vocabulary string معرف مفردات تصنيف ai_agent_commands (تنشئها hook_install() عندما تكون Taxonomy مفعّلة، وينشئها التحديث 9007، فقط عندما يكون المفتاح فارغًا) مفردات الأوامر.
enable_taxonomy_commands boolean true، false true متى ضُبِطت مفردات أوامر تُضبَط إلى true مع المفردات، مع hook_install() أو التحديث 9007 أو النموذج. بلا حقل نموذج، ولا تقرؤها أي شيفرة.
ai_output_allowed_domains text نطاقات بسطر لكل منها (مسموح بأحرف البدل مثل *.wikipedia.org)؛ ويسمح * بالكل؛ والفارغ يحظر كل الروابط الخارجية unsplash.com وimages.unsplash.com وpexels.com وimages.pexels.com وpixabay.com وpromptahuman.com (يضبطها hook_install() والتحديث 9013) النطاقات المسموحة. فإلغاء تحديد تصفية مخرجات الذكاء الاصطناعي على النموذج يخزّن *.
ai_output_allowed_tags text أسماء وسوم HTML بسطر لكل منها قائمة بوسوم النصوص والقوائم والجداول والمضمّنة والوسائط والنماذج الشائعة (من div إلى rp) تُطبَّق في النموذج عند غياب المفتاح وسوم HTML المسموحة؛ فالوسوم غير المدرجة تفقد وسومها وتحتفظ بنصها.
ai_output_stripped_tags text أسماء وسوم HTML بسطر لكل منها script، style الوسوم المحظورة، تُزال مع محتوياتها. فإلغاء تحديد تصفية مخرجات الذكاء الاصطناعي يخزّن الافتراضي script وstyle.

مفاتيح تقرؤها الشيفرة بلا حقل نموذج

هذه المفاتيح ليست في المخطط لكن الوحدة تقرؤها من dxpr_builder.settings. اضبطوها مع drush config:set أو بتجاوز إعدادات في settings.php.

المفتاح النوع الافتراضي عند الغياب الوصف
record_analytics boolean true يرسل تحليلات استخدام المحرر إلى tuur.dxpr.com عندما تكون true.
notifications boolean true يعرض إشعارات DXPR في المحرر عندما تكون true.
cloud_url string https://cdn2.dxpr.com/VERSION/ عنوان CDN الأساسي لأصول المحرر؛ ويُستبدَل VERSION بإصدار الوحدة.
license_endpoint string https://dxpr.com/api/central-user-storage/ نقطة نهاية لمزامنة المستخدمين المرخّصين.

قوالب الصفحات

كائنات الإعدادات: dxpr_builder.page_template.* (نوع الكيان dxpr_builder_page_template)

مسار الإدارة: /admin/dxpr_studio/dxpr_builder/page_template

المفتاح النوع القيم المسموحة الافتراضي الوصف
id string الاسم الآلي مطلوب المعرف.
label label أي نص مطلوب التسمية: الاسم المعروض في منتقي القوالب.
status boolean true، false true مفعّل. فلا يقدم المحرر ولا يحمّل إلا القوالب المفعّلة.
category text أي نص فارغ (ويتطلبه النموذج) الفئة التي يُجمَّع القالب تحتها.
template string HTML من DXPR Builder فارغ (ويتطلبه النموذج) القالب ووسومه.
weight integer أي عدد صحيح فارغ (فيقرؤه المحرر 0) الوزن: ترتيب الفرز.
date integer طابع Unix الزمني يضبطه نموذج التحرير عند كل حفظ وقت آخر تعديل.
image string محتويات صورة مشفرة Base64 فارغ الصورة: مصغّرة.
uuid string UUID مولّد معرف فريد عالميًا.

تشحن الوحدة خمسة قوالب صفحات في config/install: about_me وabout_us و homepage_basic وsplit_content_and_buttons و text_columns.

ملفات تعريف المستخدم

كائنات الإعدادات: dxpr_builder.dxpr_builder_profile.* (نوع الكيان dxpr_builder_profile)

مسار الإدارة: /admin/dxpr_studio/dxpr_builder/profile

على ملف جديد يحدد النموذج كل عنصر وكتلة ومعروض عرض وقالب صفحة مفعّل وقالب مستخدم عام مفعّل ومجموعة أيقونات، إضافة إلى مجموعة افتراضية من أزرار محرر النصوص. والافتراضيات تحته هي قيم الكيان نفسه.

المفتاح النوع القيم المسموحة الافتراضي الوصف
id string الاسم الآلي مطلوب المعرف.
label label أي نص مطلوب التسمية: اسم الملف.
uuid string UUID مولّد معرف فريد عالميًا.
status boolean true، false true ملف المستخدم مفعّل. تُتجاوَز الملفات المعطّلة عند مطابقة أدوار مستخدم.
sidebar boolean true، false غير مخزّن مفتاح قديم: معلَن في المخطط لكن الكيان لا يصدّره، فلا يُحفَظ أبدًا.
dxpr_editor boolean true، false true؛ وضبطه التحديث 8008 على الملفات الموجودة بدء المحرر عند تحميل الصفحة. وعندما تكون false، لا تظهر عناصر التحكم إلا بعد أن ينقر المستخدم أيقونة العين على عناصر تحكم الحاوية الرئيسية.
controls_layout string default (كالموقع)، element (على كل عنصر)، breadcrumb (صف واحد) default أشرطة التحكم في وضع التحرير لهذا الملف. ويتجاوزه إعداد المستخدم الخاص.
weight integer -10 إلى 10 في النموذج 0 الوزن: عندما تطابق أدوار مستخدم ملفات مفعّلة عدة، يفوز الوزن الأخف.
roles تسلسل نصوص الأسماء الآلية للأدوار (يستبعد النموذج anonymous وauthenticated) فارغ الأدوار التي ينطبق عليها الملف.
elements تسلسل نصوص الأسماء الآلية للعناصر (az_text وaz_image وغيرهما) فارغ المسموح: العناصر.
all_elements boolean true، false false تحديد/إلغاء تحديد كل العناصر. وعندما تكون true، تُسمَح كل العناصر ويُتجاهَل elements.
blocks تسلسل نصوص az_block-<block plugin id>، أي القيم فارغ المسموح: الكتل.
all_blocks boolean true، false false تحديد/إلغاء تحديد كل الكتل. وعندما تكون true، تُسمَح كل الكتل، بما فيها المضافة لاحقًا.
views تسلسل نصوص az_view-<view id>-<display id>، أي القيم فارغ طرق العرض المسموحة.
all_views boolean true، false false تحديد/إلغاء تحديد كل طرق العرض. وعندما تكون true، تُسمَح كل طرق عرض Views، بما فيها المضافة لاحقًا.
page_templates تسلسل نصوص معرفات UUID لقوالب الصفحات فارغ المسموح: قوالب الصفحات.
all_page_templates boolean true، false false تحديد/إلغاء تحديد كل قوالب الصفحات. وعندما تكون true، يُسمَح كل قالب صفحة.
user_templates تسلسل نصوص معرفات UUID لقوالب المستخدم العامة فارغ المسموح: قوالب المستخدم العامة.
all_user_templates boolean true، false false تحديد/إلغاء تحديد كل قوالب المستخدم العامة. وعندما تكون true، يُسمَح كل قالب مستخدم عام.
icon_sets تسلسل نصوص ملفات *.dxpr_icon_sets.yml تعطي معرفات مجموعات الأيقونات فارغ المسموح: مجموعات الأيقونات.
all_icon_sets boolean true، false غير مضبوط (يُحتَسَب true) تحديد/إلغاء تحديد كل مجموعات الأيقونات. وعندما تكون true أو غائبة، تُسمَح كل مجموعات الأيقونات.
inline_buttons تسلسل نصوص أسماء أزرار CKEditor 5 فارغ أزرار محرر النصوص (التحرير المضمّن). نقل التحديث 8036 أسماء CKEditor 4 في هذه القائمة وفي modal_buttons.
modal_buttons تسلسل نصوص أسماء أزرار CKEditor 5 فارغ أزرار محرر النصوص (التحرير في مربع حوار).

قوالب المستخدم

كائنات الإعدادات: dxpr_builder.user_template.* (نوع الكيان dxpr_builder_user_template)

مسار الإدارة: /admin/dxpr_studio/dxpr_builder/user_templates

المفتاح النوع القيم المسموحة الافتراضي الوصف
id string الاسم الآلي مطلوب المعرف.
label label أي نص مطلوب التسمية: اسم القالب.
status boolean true، false true بلا حقل نموذج. ولا يمكن تحميل إلا القوالب المفعّلة في المحرر أو نسخها إلى قالب صفحة.
type string نوع العنصر data-azb الذي حُفِظ منه القالب، مثل section أو row أو az_block أو az_view أو custom custom النوع. يملؤه التحديث 9021 من الوسوم؛ وتنطوي قيم az_block_* وaz_view_* إلى az_block وaz_view.
template string HTML من DXPR Builder فارغ القالب ووسومه. نقل التحديث 8013 قوالب المستخدم من جدول قاعدة بيانات إلى الإعدادات.
uid integer معرف المستخدم مطلوب في النموذج UID: المالك.
global boolean true، false true (ويرسل طلب حفظ المحرر قيمته الخاصة) عام: تجعل true القالب متاحًا لكل المستخدمين (خاضعًا للملفات)؛ وتُبقي false خاصًا بالمالك.
image string محتويات صورة مشفرة Base64 فارغ الصورة: مصغّرة.
uuid string UUID مولّد معرف فريد عالميًا.

تصدير الإعدادات

صدّروا كل إعدادات DXPR Builder:

drush config:export

يصدّر ذلك الإعدادات والملفات وقوالب الصفحات وقوالب المستخدم كملفات YAML في مجلد مزامنة الإعدادات. وعندما يكون api_key_storage بقيمة key، فمفتاح المنتج ليس جزءًا من dxpr_builder.settings. بل يعيش في كيان Key المحدد ويتبع موفر ذلك المفتاح نفسه، مثل الإعدادات أو ملف أو متغير بيئة.

ما الخطوة التالية؟