الإعدادات
يتضمن Blockstudio واجهة إعدادات قوية API تتيح ضبط الخيارات عبر ملف blockstudio.json داخل مجلد القالب و/أو باستخدام المرشحات. بالإضافة إلى ذلك، يستطيع المستخدمون المصرح لهم تغيير الإعدادات مرئيًا من منطقة الإدارة.
عبر JSON
إذا وُجد ملف blockstudio.json داخل مجلد القالب، فسيُستخدم لضبط الخيارات الافتراضية للموقع الحالي. يتوفر مخطط JSON للتحقق من صحة الملف والمساعدة في الإكمال التلقائي عند استخدام بيئة تطوير متكاملة.
هذا الملف اختياري. عند عدم وجوده، يستخدم Blockstudio الإعدادات المحفوظة في منطقة الإدارة إلى جانب الإعدادات الافتراضية المدمجة. يجري اكتشاف إضافة الملف أو تغييره أو حذفه تلقائيًا، لذا لا حاجة إلى مسح ذاكرة التخزين المؤقت أو إعادة التحميل يدويًا.
الخصائص المتاحة:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"users": {
"ids": [],
"roles": []
},
"assets": {
"enqueue": true,
"reset": {
"enabled": false,
"fullWidth": []
},
"minify": {
"css": false,
"js": false
},
"process": {
"scss": false
}
},
"cache": {
"enabled": true,
"path": "blockstudio/cache"
},
"themeDefaults": {
"titleTag": false,
"suppressDirectoryUpdates": false
},
"performance": {
"profile": "compat",
"wordpress": {
"headNoise": false,
"embeds": false,
"xmlrpc": false,
"editor": false,
"frontendAssets": false,
"media": false,
"heartbeat": false
},
"preload": {
"links": "off"
},
"media": {
"lazy": false,
"skeleton": false,
"metadata": false,
"rootMargin": "300px"
},
"measurement": {
"enabled": false,
"queryMonitor": false,
"headers": false,
"timings": false
}
},
"content": {
"enabled": false,
"id": "default",
"path": "content",
"includePageSyncManaged": false,
"authors": "ignore",
"postTypes": [],
"meta": {
"include": [],
"exclude": ["_edit_lock", "_edit_last", "_wp_old_slug"],
"references": {}
},
"taxonomies": [],
"media": "manifest"
},
"editor": {
"formatOnSave": false,
"assets": [],
"markup": false
},
"tailwind": {
"enabled": false,
"config": "",
"output": "inline"
},
"blockTags": {
"enabled": false,
"allow": [],
"deny": [],
"prefixes": {}
},
"ui": {
"enabled": false
},
"blockEditor": {
"disableLoading": false,
"enhance": false,
"cssClasses": [],
"cssVariables": [],
"blocks": {
"allow": [],
"deny": [],
"directory": true,
"categories": {
"allow": [],
"deny": [],
"rename": {},
"order": []
},
"styles": {
"deny": {}
},
"legacyWidgets": {
"hide": []
}
},
"patterns": {
"core": true,
"remote": true,
"theme": true,
"blockstudio": true,
"categories": {
"allow": [],
"deny": [],
"rename": {},
"order": []
}
},
"media": {
"openverse": true,
"imageSizes": {
"allow": [],
"deny": []
}
}
},
"dev": {
"grab": {
"enabled": false
},
"perf": false,
"canvas": {
"enabled": false,
"adminBar": true
}
},
"githooks": {
"commit": false
},
"phpstan": {
"preset": "base",
"configuration": "",
"roots": ["."],
"excludePaths": [],
"maxFiles": 10000
},
"ai": {
"enableContextGeneration": false
}
}
عبر المرشحات
يمكنك بدلًا من ذلك استخدام مرشح blockstudio/settings/${setting} لضبط الخيارات عبر PHP بمزيد من المرونة.
add_filter('blockstudio/settings/assets/enqueue', '__return_false');
add_filter('blockstudio/settings/editor/formatOnSave', '__return_true');
add_filter('blockstudio/settings/ui/enabled', '__return_true');
add_filter('blockstudio/settings/block_editor/patterns/remote', '__return_false');
تتجاوز الخيارات المضبوطة عبر مرشح blockstudio/settings/${setting} الخيارات المضبوطة عبر ملف blockstudio.json. ويمكن استخدام الطريقتين معًا.
تتيح قيم وقت التشغيل أيضًا مرشحات blockstudio/performance/${setting} ومرشح blockstudio/performance/config نهائيًا واحدًا. يجب أن يعيد الأخير كائن إعدادات صالحًا.
كيفية تراكب المصادر
يُحمّل كل مصدر وتُدمج محتوياته، بدءًا من الأقل أولوية:
- الإعدادات الافتراضية المدمجة
- الإعدادات المحفوظة عبر UI الإدارة (الخيار
blockstudio_settings) blockstudio.jsonفي القالب- مرشحات
blockstudio/settings/*
لا يتجاوز blockstudio.json إلا المفاتيح التي يحددها. كان يستبدل الإعدادات المحفوظة بالكامل، ما يعني أن قيمة محفوظة في الإدارة وغير مرتبطة به تتوقف عن التطبيق بمجرد ظهور الملف؛ أما الآن فيُضاف فوقها. والجانب الآخر هو أن القيمة القديمة المحفوظة عبر UI الإدارة تظل مطبقة حتى يحدد الملف ذلك المفتاح أو تُزال القيمة المحفوظة. إذا تصرف إعداد على نحو يخالف ما يحدده الملف، فتحقق من الطبقة المحفوظة باستخدام wp bs settings أو Settings::get_raw()، الذي يعيد فقط ما حدده المصدر النشط JSON أو مصدر الخيارات صراحةً.
قراءة الإعدادات من PHP
يحمّل Blockstudio\Settings المصدر النشط، ويبلّغ عن JSON غير الصالح، ويعيد التحميل تلقائيًا عند تغيّر blockstudio.json:
use Blockstudio\Settings;
$enabled = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$roles = Settings::get_array('users/roles');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);
foreach (Settings::errors() as $error) {
error_log($error);
}
استخدم Settings::get_raw() عندما يحتاج التكامل إلى القيم المعلنة صراحةً في مصدر JSON النشط أو مصدر الخيارات فقط. يعيد Settings::fingerprint() معرّفًا حتميًا للإعدادات الفعلية. يمكن للعمليات طويلة الأمد استدعاء Settings::reload() صراحةً لقراءة تغييرات الملف فورًا. وفي الوصول العادي، يُفحص الملف مرة واحدة في الثانية كحد أقصى ضمن الطلب أو العملية طويلة الأمد PHP، بما في ذلك التعديلات التي لا تغيّر الحجم. يسري تغيير المسار المُعدّ عند القراءة التالية. وعندما لا يكون ملف JSON نشطًا، لا تتأخر إعدادات قاعدة البيانات المحفوظة بسبب هذه المهلة.
يتوفر ملف تعريف الأداء بعد حله عبر Blockstudio\Runtime_Settings::current(). وهو يدعم مسارات مفصولة بشرطة مائلة أو بنقطة:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
الإعدادات المتاحة
users
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
ids |
مصفوفة | [] |
معرّفات المستخدمين الذين لديهم صلاحية التحرير |
roles |
مصفوفة | [] |
أدوار المستخدمين التي لديها صلاحية التحرير |
assets
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
enqueue |
boolean | true |
إضافة أصول الكتل تلقائيًا إلى قائمة الانتظار |
reset.enabled |
boolean | false |
إزالة أنماط الكتل الأساسية وتطبيق إعادة ضبط أدوات المحرر |
reset.fullWidth |
array | [] |
أنواع المنشورات التي تستخدم تخطيط المحرر بعرض كامل |
minify.css |
boolean | false |
تصغير مخرجات CSS |
minify.js |
boolean | false |
تصغير مخرجات JS |
process.scss |
boolean | false |
معالجة ملفات SCSS |
output |
string | source |
مكان كتابة الأصول المجمّعة: source أو cache |
inlineLimit |
integer | 0 |
عدد بايتات أصول كتل CSS الخارجية التي تُطبع ضمن الصفحة |
تكون القيمة الافتراضية لـoutput هي source، التي تنشئ مجلد _dist بجوار كل كتلة. اضبطها على cache لكتابة الأصول المجمّعة في مجلد ذاكرة التخزين المؤقت Blockstudio بدلًا من ذلك، بحيث تظل شجرة مصدر الكتلة نظيفة وقابلة للنشر من نسخة مستودع غير قابلة للتغيير. تُوجّه المصادر Blockstudio إلى ذاكرة التخزين المؤقت على أي حال، ولا يمكنها الكتابة فيها بصرف النظر عن هذا الإعداد.
تكون inlineLimit معطّلة عند 0، لذا يحتفظ كل ملف أنماط خارجي بوسم <link> الخاص به. عيّنها إلى عدد من البايتات لطباعة أصغر ملفات أنماط الكتل الخارجية للصفحة ضمن الصفحة بدلًا من ذلك، ما دام مجموعها لا يتجاوز ذلك العدد. 40000 هو الحد الذي يستخدمه قلب WordPress للقاعدة نفسها. راجع تضمين أوراق الأنماط الصغيرة.
عند تفعيل reset.enabled، ينسخ Blockstudio أيضًا قيم body_class الأمامية بعد تنقيحها إلى لوحة المحرر. استخدم blockstudio/editor/canvas/body_class لضبط قائمة الفئات المخصصة للمحرر فقط.
cache
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
enabled |
منطقي | true |
تفعيل ذاكرات التخزين المؤقت المدعومة بالملفات Blockstudio |
path |
سلسلة نصية | "blockstudio/cache" |
مسار ذاكرة التخزين المؤقت، نسبةً إلى WP_CONTENT_DIR أو مسار مطلق |
namespaceGrace |
عدد صحيح | 86400 |
عدد الثواني التي تبقى فيها مساحة أسماء ذاكرة مؤقتة متقاعدة قبل جمعها |
تُكتب ملفات ذاكرة التخزين المؤقت افتراضيًا في wp-content/blockstudio/cache خارج مجلد التحميلات. يُحل المسار النسبي path انطلاقًا من WP_CONTENT_DIR، أما المسار المطلق فيُستخدم كما هو. ويدعم ذلك المضيفين الذين يوفرون وحدة تخزين مؤقتة مخصصة قابلة للكتابة.
عند تفعيلها، يستخدم Blockstudio هذا الجذر الواحد لحمولات البناء، وبيانات تسجيل الكتل المعدّة مسبقًا، وأصول المحرر المحلولة، وTailwind CSS، ومستندات العرض، وأجزاء الجزر، وعمليات العرض المسبق الثابتة، وفهارس الرسوم البيانية، وقوائم الانتظار، والتشخيصات. يُعزل كل كائن بحسب الشبكة والموقع وهوية وقت التشغيل الكاملة والنطاق. وتشمل هويات وقت التشغيل Blockstudio، والإعدادات، وWordPress، وPHP، والقالب النشط، والإضافات النشطة، ومصادر الاكتشاف المنطقية، وسياق المضيف، وتجزئات التبعيات الصريحة التي توفرها العملية المالكة.
تؤدي تغييرات المحتوى والمصطلحات والمستخدمين والبيانات الوصفية إلى إبطال خيارات الحقول المعبأة، لا إلى اكتشاف الكتل البنيوي أو الأصول المجمّعة. تُحدَّث الخيارات بشكل منفصل ضمن قفل ثابت لمسار البناء. تُدمج دفعة من عمليات الكتابة، مثل مزامنة الترجمة أو الاستيراد: تُحدَّث الخيارات فورًا عند أول كتابة بعد فترة هدوء، ثم تنعكس آخر كتابة في الدفعة مرة واحدة بعد مرور ثلاثين ثانية، ويمكن ضبط هذه المدة عبر blockstudio/cache/populate_debounce. لا تُحتسب البيانات الوصفية التي WordPress تكتبها لأغراض تنظيمية، مثل قفل تحرير المقالة، كتغيير؛ وتضيف blockstudio/cache/populate_ignored_meta_keys عناصر أخرى إلى هذه القائمة. يستعلم المحرر دائمًا عن الخيارات الحالية، لذا تؤثر هذه المدة فقط في الخيارات المخزنة مؤقتًا التي تُقرأ وقت العرض. وتظل ملفات المصدر وإعدادات البناء تُبطل ذاكرة التخزين المؤقت البنيوية بالطريقة المعتادة. لا تؤدي الكتابة فوق الخيارات إلى إعادة فحص دليل ذاكرة التخزين المؤقت عند كل تغيير للمحتوى؛ إذ يواصل التنظيف الدوري إزالة الملفات المؤقتة اليتيمة. تظل هويات وقت التشغيل الخاصة بكل لغة معزولة؛ ووجود أدلة متعددة لمساحات أسماء ذاكرة التخزين المؤقت في موقع متعدد اللغات لا يُعد بحد ذاته دليلًا على عدم إصابة ذاكرة التخزين المؤقت.
لا يؤدي نشاط سجل SQLite داخل دليل بيانات db الكتلة إلى التخلص من بيانات الكتلة الوصفية المخزنة مؤقتًا. تظل التغييرات في db.php أو ملفات المصدر الخاضعة للمراقبة أو بنية ملفات المصدر والأدلة الفرعية لدليل البيانات تُبطل ذاكرة التخزين المؤقت.
لا ينتخب سوى باني واحد لإعادة بناء وقت التشغيل بالتزامن. وتنتظر الطلبات الأخرى مدة تصل إلى خمس ثوانٍ، ثم تعيد استخدام بيانات آخر كتلة سليمة إذا كانت ملفات المصدر والأصول المجمّعة المطلوبة لا تزال موجودة. أما الطلب البارد الذي لا يتوفر له محتوى آمن فيعيد HTTP 503 مع Retry-After بدلًا من بدء عملية بناء أخرى. يضبط المرشح blockstudio/cache/build_wait_budget مدة الانتظار بالمللي ثانية لكل من إعادة البناء البنيوي وتحديث الخيارات. ويحدّث المضيف الذي لا يدعم أقفال الملفات الاستشارية الخيارات دون حماية، وينشرها مع ذلك، كي تصل إصابة إلى الطلب التالي.
يجمع WP-Cron ملفات .build.lock القديمة الخاصة بالمفاتيح بعد خمولها، والتي تركتها الإصدارات السابقة، عبر مساحات أسماء ذاكرة التخزين المؤقت لهذا الموقع. ويبدأ ذلك بعد خمس دقائق من الترقية، ويزيل ما يصل إلى 10,000 قفل في الدقيقة ضمن مهلة عشر ثوانٍ. يعرض wp bs cache status العدد المتبقي، ويعالج wp bs cache cleanup التراكم فورًا، ويمسح wp bs cache clear ذاكرة تخزين وقت التشغيل المؤقتة. إذا تأخرت دفعة مجدولة أكثر من عشر دقائق بسبب عدم تشغيل cron، تفحص الطلبات عددًا محدودًا من الأقفال مرة كل ساعة كيلا يتوقف الإفراغ. وتُترك الأقفال الحديثة أو الممسوكة دون مساس، ولا تُجمع الأقفال الجديدة ذات المسارات الثابتة مطلقًا. بعد إفراغ التراكم، تجمع الدفعة نفسها مساحات أسماء ذاكرة التخزين المؤقت المتروكة بعد انقضاء namespaceGrace، بمعدل مرة واحدة في الساعة كحد أقصى لكل موقع، وتُبقي على مهمة يومية لذلك. تُحتسب فترة السماح من أول فحص يكتشف تقاعد مساحة الأسماء، لا من أحدث ملف فيها؛ ولا تُجمع أبدًا مساحة أسماء تظل مستخدمة لأي من نطاقاتها.
لا يستدعي تنظيف ذاكرة التخزين المؤقت الداخلية مرشحات حذف المرفقات WordPress.
ينبغي للمضيفين الذين عطّلوا WP-Cron مواصلة تشغيل عامل cron المجدول المعتاد؛ ولا تحذف ملفات الأقفال النشطة عشوائيًا لإفراغ التراكم.
يغيّر مرشح إعداد blockstudio/settings/cache/path القيمة المضبوطة. ولحل المسار الخاص ببيئة النشر، يرشّح blockstudio/cache/dir المجلد الأساسي المحلول:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
يمكن للمضيفين الذين تختلف هوية المستأجر لديهم عن معرّفات الشبكة/المدونة WordPress ترشيح blockstudio/cache/site_key. تُنقّح النتيجة وتُستخدم كجزء من مسار مجلد فقط. ويظل blockstudio/cache/context الموضع المناسب لمتغير وقت تشغيل قابل للتسلسل يجب أن يغيّر هويات الكائنات.
themeDefaults
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
titleTag |
منطقي | false |
تفعيل دعم وسم العنوان في القالب WordPress |
suppressDirectoryUpdates |
منطقي | false |
استبعاد القوالب الفرعية والأصلية النشطة من نتائج تحديث المجلدات |
تواصل الأنماط استخدام Blockstudio\Patterns API الحالي؛ ولا تضيف هذه الإعدادات الافتراضية واجهات بديلة للصفحات أو الأنماط.
performance
يُبقي ملف تعريف compat سلوك WordPress العام دون تغيير. ويتيح كل من speed وstrict الإعدادات الافتراضية الأمامية الاختيارية نفسها؛ ويمكن لكل إعداد فرعي تجاوز قيمة ملف التعريف.
إعدادات التفعيل الاختياري هي بوابات تسجيل. عندما تكون ميزة اختيارية false، لا يربط Blockstudio عمليات رد الواجهة الأمامية أو الإدارة أو المحرر أو REST أو المهام المجدولة الخاصة بهذه الميزة. يؤدي تعطيل التقديم المبكر أو الإحماء المجدول بعد استخدامه إلى تنظيف الموارد التي يملكها مرة واحدة؛ وتظل الطلبات اللاحقة خاملة.
| الخيار | النوع | القيمة الافتراضية للتوافق | القيمة الافتراضية للسرعة/التشدد | الوصف |
|---|---|---|---|---|
profile |
سلسلة | "compat" |
غير منطبق | compat أو speed أو strict |
wordpress.headNoise |
قيمة منطقية | false |
true |
إزالة اكتشاف الترويسة العام وإخراج الرموز التعبيرية |
wordpress.embeds |
قيمة منطقية | false |
true |
إزالة اكتشاف oEmbed وبرامج المضيف النصية |
wordpress.xmlrpc |
قيمة منطقية | false |
true |
تعطيل XML-RPC وردود الإشعار |
wordpress.editor |
قيمة منطقية | false |
true |
تعطيل واجهات اكتشاف المحرر عن بُعد |
wordpress.frontendAssets |
قيمة منطقية | false |
true |
إزالة أصول الواجهة الأمامية العامة في النواة |
wordpress.media |
قيمة منطقية | false |
true |
تطبيق الإعدادات الافتراضية لإخراج الصور |
wordpress.heartbeat |
قيمة منطقية | false |
true |
الحد من معدل Heartbeat خارج المحررات |
preload.links |
سلسلة | "off" |
"intent" |
استباق تحميل المستندات من المصدر نفسه بعد تفاعل المستخدم |
media.lazy |
قيمة منطقية | false |
true |
استخدام محمّل الصور الخاص بـ Blockstudio |
media.skeleton |
قيمة منطقية | false |
true |
إظهار الهيكل العظمي المدمج للتحميل |
media.metadata |
قيمة منطقية | false |
true |
التصريح باستخدام assets/media.json |
media.rootMargin |
سلسلة | "300px" |
"300px" |
هامش التقاطع للمحمّل الكسول |
measurement.enabled |
قيمة منطقية | false |
false |
تفعيل واجهات قياس وقت التشغيل |
measurement.queryMonitor |
قيمة منطقية | false |
false |
تضمين الاستعلامات التي تستغرق 50ms على الأقل |
measurement.headers |
قيمة منطقية | false |
false |
إرسال ترويسات ملف التعريف وتجزئة الإعدادات |
measurement.timings |
قيمة منطقية | false |
false |
إرسال ترويسة وقت التشغيل المنقضي |
staticPrerender.enabled |
قيمة منطقية | false |
false |
تفعيل التخزين المؤقت الآمن المجهول لـ HTML |
staticPrerender.ttl |
عدد صحيح | 86400 |
86400 |
الحد الأقصى لعمر المستند المخزّن مؤقتًا بالثواني |
staticPrerender.invalidate |
سلسلة | "signature" |
"signature" |
استخدام هوية signature أو الهوية التزايدية لـ graph |
staticPrerender.earlyServe |
قيمة منطقية | false |
false |
تقديم النتائج الآمنة قبل بدء WordPress |
staticPrerender.serveLoggedIn |
قيمة منطقية | false |
false |
السماح للمستخدمين باستهلاك النتائج المخزّنة مؤقتًا، دون إنشائها |
staticPrerender.dynamicPaths |
مصفوفة | [] |
[] |
بادئات المسارات التي يجب أن تظل ديناميكية |
staticPrerender.replayHeaders |
مصفوفة | ["Link"] |
["Link"] |
ترويسات الاستجابة المخزّنة مع النتائج والمُرسلة عند إصابتها في ذاكرة التخزين المؤقت |
staticPrerender.warm.enabled |
قيمة منطقية | false |
false |
تفعيل قائمة الانتظار المجدولة الدائمة للإحماء |
staticPrerender.warm.interval |
عدد صحيح | 3600 |
3600 |
الفاصل الزمني للإحماء بالثواني |
staticPrerender.warm.concurrency |
عدد صحيح | 2 |
2 |
الحد الأقصى للمهام التي تعالجها دورة إحماء واحدة |
staticPrerender.warm.transport |
سلسلة | "http" |
"http" |
استخدام http أو عارض يوفّره المضيف وهو internal |
يظل العرض المسبق الثابت معطّلًا ما لم يُفعّل صراحةً. لا يسجّل المفتاح الرئيسي المعطّل أي خطافات لطلبات العرض المسبق، كما أن مفتاحَي earlyServe وwarm.enabled المعطّلين لا يسجّلان أي خطافات للإدارة أو cron. يستخدم وضع التوقيع هوية مفعّلة منخفضة التكلفة في الطلبات العادية. أما وضع الرسم البياني فهو مخصص للإنشاءات الصريحة: إذ يسجّل تبعيات المصدر لكل صفحة، بحيث لا يؤدي تغيير صفحة واحدة إلى إبطال مستندات غير مرتبطة بها. راجع العرض المسبق الثابت لمعرفة تفاصيل الإحماء والنشر والتقديم المبكر والسلامة.
تتوفر القياسات برمجيًا:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
عند تفعيل الترويسات، يرسل Blockstudio X-Blockstudio-Performance-Profile وX-Blockstudio-Performance-Config، واختياريًا X-Blockstudio-Performance-Time. ويتلقى الإجراء blockstudio/performance/measurement_enabled إعدادات وقت التشغيل التي تم حلّها.
تتحكم خيارات media في bs_media_image() وبيان assets/media.json ومُحمّل الواجهة الأمامية الكسول. راجع الوسائط لمعرفة تفاصيل المساعد ومنشئ البيان وسلوك المُحمّل.
content
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
enabled |
منطقي | false |
تفعيل إعداد مزامنة المحتوى |
id |
سلسلة | "default" |
نطاق مجموعة المحتوى المخزن في الكيانات المتزامنة |
path |
سلسلة | "content" |
مجلد ملفات المحتوى بالنسبة إلى القالب |
includePageSyncManaged |
منطقي | false |
تضمين المنشورات التي تديرها مزامنة الصفحات دون امتلاك محتواها |
authors |
سلسلة | "ignore" |
معالجة المؤلف (ignore أو login لمستخدم موجود) |
postTypes |
مصفوفة | [] |
أنواع المنشورات المسموح بها |
meta.include |
مصفوفة | [] |
أنماط glob لمفاتيح البيانات الوصفية المراد مزامنتها |
meta.exclude |
مصفوفة | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
أنماط glob لمفاتيح البيانات الوصفية المستثناة |
meta.references |
كائن | {} |
مراجع البيانات الوصفية المعلنة التي يُعاد تحويلها بين المعرّفات ومعرّفات UID |
taxonomies |
مصفوفة | [] |
التصنيفات المسجلة المسموح بها للمصطلحات والعلاقات |
media |
سلسلة | "manifest" |
سلوك مراجع المرفقات (manifest أو none) |
تُدار مزامنة المحتوى عبر wp bs content، وتُصدّر المنشورات المسموح بها والبيانات الوصفية للمنشورات والمراجع المعلنة إلى ملفات قابلة للنقل. راجع مزامنة المحتوى لمعرفة سير العمل وتنسيق الملفات.
editor
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
formatOnSave |
منطقي | false |
تنسيق block.json عند الحفظ |
assets |
مصفوفة | [] |
أصول إضافية لتحميلها في المحرر |
markup |
منطقي | false |
تفعيل تحرير الترميز |
tailwind
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
enabled |
منطقي | false |
تفعيل تجميع Tailwind CSS |
config |
سلسلة | "" |
إعداد يبدأ بـ CSS لـ Tailwind v4 |
راجع Tailwind CSS لمعرفة سلوك التجميع وتنسيق الإعداد الذي يبدأ بـ CSS.
blockTags
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
enabled |
منطقي | false |
تفعيل عرض وسوم bs: على مستوى الصفحة ضمن محتوى المنشورات ومناطق الأدوات |
allow |
مصفوفة | [] |
قائمة سماح لأنماط أسماء الكتل؛ تدعم أحرف البدل fnmatch() |
deny |
مصفوفة | [] |
قائمة حظر لأنماط أسماء الكتل؛ لها الأولوية على allow |
prefixes |
كائن | {} |
بادئة لتحديد نطاق الأسماء المختصرة؛ كل قيمة نطاق اسم أو مصفوفة مرتبة |
يكون عرض الوسوم على مستوى القالب مفعّلًا دائمًا؛ وتتحكم هذه الخيارات في الاستبدال على مستوى الصفحة. راجع العرض لمعرفة صياغة الوسوم وقواعد حلّها.
ui
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
enabled |
منطقي | false |
تسجيل مكونات bsui/* UI المضمّنة وتطبيقات العرض التوضيحي app/* |
blockEditor
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
disableLoading |
منطقي | false |
تعطيل تحميل الكتل في المحرر |
enhance |
منطقي | false |
تفعيل إمكانات التحويم والتحديد في محرر Blockstudio |
cssClasses |
مصفوفة | [] |
عناوين URL لأوراق الأنماط لاستخراج أصناف CSS منها للاقتراح التلقائي في حقل الأصناف |
cssVariables |
مصفوفة | [] |
عناوين URL لأوراق الأنماط لاستخراج متغيرات CSS منها للاقتراح التلقائي في حقل الأكواد |
blockEditor.blocks
استخدم blockEditor.blocks لتحديد سياسة إدراج الكتل على مستوى المشروع. يقبل allow وdeny أسماء الكتل وأنماط أحرف البدل مثل core/*.
{
"blockEditor": {
"blocks": {
"allow": ["core/*", "my-theme/*"],
"deny": ["core/embed", "core/freeform"],
"directory": false,
"categories": {
"rename": {
"text": "Writing",
"design": "Layout"
},
"order": ["my-theme", "text", "media"]
},
"legacyWidgets": {
"hide": ["archives", "calendar"]
}
}
}
}
يلغي blocks.styles.deny تسجيل الأنماط المسجلة عبر سجل أنماط الكتل WordPress’ الخاص بـ PHP:
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
استخدم blockEditor.patterns لتعطيل مصادر الأنماط العامة وتصفية فئات الأنماط.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
استخدم blockEditor.media لتحديد سياسة أداة إدراج الوسائط العامة.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
grab.enabled |
منطقي | false |
تفعيل أداة التقاط العناصر في الواجهة الأمامية |
perf |
منطقي | false |
تفعيل محلّل الأداء عند تحميل كل صفحة |
canvas.enabled |
منطقي | false |
تفعيل اللوحة |
canvas.adminBar |
منطقي | true |
إظهار شريط إدارة WordPress عند عرض اللوحة |
githooks
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
commit |
منطقي | false |
إنشاء خطاف ما قبل الالتزام للتحليل فقط عند تشغيل blockstudio-githooks sync |
راجع خطاف الالتزام المُدار لمعرفة ما ينفذه الخطاف المُنشأ وكيفية إبقائه متزامنًا.
phpstan
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
preset |
نص | "base" |
إعداد التحليل المسبق عند عدم تحديد أحد في سطر الأوامر: base أو theme أو extreme-theme أو wordpress-render |
configuration |
نص | "" |
إعداد PHPStan المشروع المُضمّن إلى جانب الإعداد المسبق، ويُحدّد من blockstudio.json |
roots |
مصفوفة | ["."] |
جذور السمات التي يحللها الأمر المعتمد |
excludePaths |
مصفوفة | [] |
استثناءات إضافية للماسح نسبةً إلى كل جذر مُعدّ |
maxFiles |
عدد صحيح | 10000 |
الحد الأقصى لعدد الملفات التي يفحصها ماسح السمات |
blockTags |
كائن | {} |
تعيينات العناصر، والأسماء البديلة للوسوم، وscanPhp لقاعدة وسم الكتلة |
تتحكم هذه الإعدادات في الأمر الأساسي blockstudio-phpstan. راجع PHPStan لمعرفة الإعدادات المسبقة والطبقات وكيفية التبني.
ai
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
enableContextGeneration |
منطقي | false |
إنشاء ملف سياق موحّد للكتل والإعدادات والمخططات والوثائق لاستخدامه مع أدوات LLM |
راجع تكامل AI لفهرس الوثائق والنص المُنشأ كاملًا.
فعّل مكونات UI المضمّنة عديمة الواجهة وركّبها، وقد قُدّمت في Blockstudio 7.3.