Dennis · 21 يونيو 2026
Blockstudio 7.4
يركز الإصدار 7.4 من Blockstudio على جعل المشاريع المعتمدة على الملفات أكثر قابلية للنقل. فبعد أن جعل الإصدار 7.2 المشاريع الكبيرة أسهل في الفحص والتوزيع، وأضاف الإصدار 7.3 طبقة UI فوق ذلك، يركز الإصدار 7.4 على نقل مزيد من عناصر المشروع وصفحاته ومحتواه المنتقى من قاعدة البيانات إلى ملفات خاضعة للتحكم بالإصدارات.
الميزة الأبرز هي مجموعات الصفحات: طريقة لتوجيه Blockstudio إلى مجلد يضم مصادر الصفحات وإنشاء بنية صفحات WordPress متداخلة كاملة منه. ويمكن أن يكون المصدر PHP أو Twig أو Blade أو HTML أو Markdown، أو أداة تحميل موثوقة تعيد صفحات من مصدر محلي آخر.
باختصار:
- مجموعات الصفحات: يمكن لـ
pages.jsonتعريف مجموعة كاملة من الصفحات المتداخلة، والقيم الافتراضية، وسلوك نوع المقالة، والتخطيطات، وأدوات التحميل، وبيانات المجموعة الوصفية. - صفحات Markdown: يعمل
index.mdكمحتوى للصفحة، إما معpage.jsonأو بمفرده مع البيانات الوصفية في الواجهة. - تخطيطات صفحات الواجهة الأمامية: يمكن لـ
layout.phpإحاطة محتوى الصفحة المتزامن واستخدام أدوات مساعدة مثلblockstudio_page_tree()وblockstudio_page_content(). - مصادر الوثائق الخارجية: يمكن لأدوات تحميل المجموعات إنشاء صفحات من ملفات محلية أو من Markdown/HTML مُعادَين.
- مخرجات Markdown الخام: يمكن تقديم مصادر صفحات Markdown بصيغة
.mdأو عبرAccept: text/markdown. - أنواع المقالات المخصصة للمجموعات: يمكن للمجموعات إدارة عناوين URL نظيفة، وتحديث قواعد إعادة الكتابة تلقائيًا، ومسارات Markdown الخام، وترحيل الصفحات إلى أنواع المقالات المخصصة دون حلول التفافية على مستوى القالب.
- مزامنة المحتوى: تتيح
wp bs content pullوwp bs content pushوwp bs content statusللمشروع نقل المقالات والعناصر التصنيفية والعلاقات ومراجع البيانات الوصفية المعلنة والمسموح بها إلى ملفات قابلة للنقل. - بادئات وسوم الكتل: يمكن حل بادئات المشروع مثل
<theme-card>عبر مساحات أسماء مرتبة دون أسماء بديلة لكل كتلة. - مزامنة أكثر موثوقية: تُكتشف تغييرات الصفحات عبر ملفات البيان وأدوات التحميل والتخطيطات والبيانات الوصفية والملفات المصدرية.
- إصلاحات وقت التشغيل والمحرر: تظل الخيارات الديناميكية حديثة، وتحافظ فئات كتل الاستعلام على حالها أثناء التصيير البرمجي، ويعمل
bsui/selectبصورة أفضل في النماذج المزدحمة، وتصل خصائص RichText إلى المحرر، ويستمر حفظ حذف صفوف المكررات التي تحتوي على RichText بعد الحفظ.
الصفحات المعتمدة على الملفات
يعتمد معظم الإصدار 7.4 على الصفحات المعتمدة على الملفات.
مجموعات الصفحات
قبل الإصدار 7.4، كانت الصفحات المعتمدة على الملفات في معظمها ميزة على مستوى المجلد: أنشئ page.json، وأضف index.php أو index.twig، ثم يزامن Blockstudio تلك الصفحة وحدها إلى WordPress.
لا يزال ذلك ممكنًا. ويضيف الإصدار 7.4 نمطًا ثانيًا للهياكل الأكبر.
أضف ملف بيان pages.json إلى مجلد، فيصبح ذلك المجلد مجموعة:
pages/
docs/
pages.json
layout.php
index.md
guide/
install/
index.md
reference/
page.json
index.md
{
"collection": "docs",
"title": "Documentation",
"postType": "bs_docs",
"postTypeArgs": {
"label": "Docs",
"rewrite": {
"slug": "docs"
},
"supports": ["title", "editor", "page-attributes"]
},
"defaults": {
"postStatus": "publish",
"templateLock": "contentOnly"
}
}
يُكتشف كل مصدر صفحة داخل المجموعة ويُطبّع ويُزامن ويُربط حسب المسار. تصبح الصفحة في guide/install ابنةً لـ guide؛ وإذا كانت صفحة guide مفقودة، ينشئ Blockstudio صفحة حاوية مولدة كي يظل التسلسل الهرمي لـ WordPress مطابقًا لبنية نظام الملفات.
يمكن للمجموعات استخدام نوع المقالة الأصلي page أو نوع مقالة خاص بها. عندما تعلن المجموعة عن نوع مقالة غير موجود بعد، يسجله Blockstudio انطلاقًا من postTypeArgs. كما تصبح postType في ملف البيان القيمة الافتراضية لكل صفحة في المجموعة، فلا تحتاج المشاريع إلى تكرارها في defaults.
تستخدم أنواع مقالات المجموعات اسم المجموعة المختصر بوصفه أساس URL العام. وتحل مجموعة docs صفحة الجذر عند /docs/، وصفحة لها path: "getting-started" عند /docs/getting-started/، والمسارات المتداخلة تحت الأساس نفسه. وتعيد عناوين URL المكررة مثل /docs/docs/ التوجيه إلى الموقع المعتمد. وتُحدّث قواعد إعادة الكتابة تلقائيًا عند تغير توجيه نوع مقالة المجموعة، لذا لا يتطلب إنشاء مجموعة جديدة حفظ إعدادات الروابط الدائمة يدويًا.
هذا ما يجعل الوثائق الخارجية وأدلة المنتجات وقواعد المعرفة ومكتبات الصفحات تبدو طبيعية في WordPress: يظل المصدر في ملفات، لكن النتيجة تظل محتوى WordPress حقيقيًا قابلًا للتحرير.
Markdown كمحتوى للصفحة
أصبح Markdown الآن مصدرًا أساسيًا للصفحات.
تستخدم صفحات Markdown المستقلة بيانات الواجهة:
---
name: about
title: About
slug: about
postStatus: publish
---
# About
This Markdown content is synced as native WordPress blocks.
يمكنك أيضًا إقران page.json بـ index.md عندما تريد فصل الإعدادات عن المحتوى في ملفات مختلفة. ويمكن للبيانات الوصفية في واجهة index.md تجاوز الحقول المطابقة في page.json، كما تُحفظ مفاتيح الواجهة غير المعروفة ضمن البيانات الوصفية.
يُحوّل Markdown إلى HTML ثم يُمرر عبر محلل الصفحات نفسه المستخدم مع PHP وقوالب Twig وBlade، لذا يكون المحتوى النهائي ترميز كتل أصليًا.
التخطيطات وأدوات مساعدة الصفحات
يمكن أن تتضمن المجموعات ملف layout.php. وفي الواجهة الأمامية، يحيط Blockstudio محتوى الصفحة المتزامن بهذا التخطيط.
<main class="docs-layout">
<aside>
<?php foreach (blockstudio_page_tree('docs') as $item) : ?>
<a href="<?php echo esc_url($item['permalink'] ?? '#'); ?>">
<?php echo esc_html($item['title']); ?>
</a>
<?php endforeach; ?>
</aside>
<article>
<?php echo blockstudio_page_content(); ?>
</article>
</main>
تتيح أدوات المساعدة الجديدة الوصول إلى المجموعة كبيانات منظمة:
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();
يوفر ذلك العناصر اللازمة لبناء هيكل كامل للوثائق: تنقل من شجرة الصفحات، وبيانات الصفحة الوصفية من واجهة البيانات، ومحتوى كتل WordPress المتزامن بوصفه منطقة المحتوى الرئيسية.
أدوات التحميل وMarkdown الخام
يمكن أن تتضمن المجموعات ملف loader.php محليًا موثوقًا. ويمكنه إعادة الصفحات مباشرة، أو توجيه Blockstudio إلى أدلة محلية إضافية لاكتشاف محتواها.
<?php
return [
'pages' => [
[
'name' => 'docs-api',
'title' => 'API',
'path' => 'api',
'content' => "# API\n\nGenerated markdown content.",
'contentType' => 'markdown',
],
],
];
يفيد ذلك عندما يكون المصدر قد أُنشئ مسبقًا في مكان آخر: مجلد وثائق حزمة، أو تصدير Markdown، أو خطوة بناء تعيد قائمة من الصفحات.
يمكن أيضًا تقديم المصدر الخام بصيغة Markdown لصفحات Markdown. اطلب الصفحة بلاحقة .md، أو أرسل Accept: text/markdown. تُحذف بيانات الواجهة من الاستجابة كي تحصل الأدوات على متن المستند المقروء. وينطبق ذلك أيضًا على أنواع مقالات المجموعات، بما فيها عناوين URL مثل /docs.md و/docs/getting-started.md.
مزامنة المحتوى
يقدم الإصدار 7.4 أيضًا مزامنة المحتوى، وهي سير عمل في WP-CLI للفرق التي تريد تمثيل مزيد من مشروع WordPress على هيئة ملفات.
wp bs content pull
wp bs content push --dry-run
wp bs content status
يحتفظ Blockstudio بالفعل بالكتل والحقول والقوالب والأنماط والصفحات المعتمدة على الملفات ضمن مشروعك. وتضيف مزامنة المحتوى محتوى محددًا من قاعدة البيانات إلى سير العمل الذي يعطي الأولوية للملفات: يمكن سحب المقالات والعناصر التصنيفية والعلاقات والبيانات الوصفية المعلنة والمسموح بها إلى ملفات، ومراجعتها في git، ودفعها إلى بيئة أخرى.
صُممت هذه العملية لتكون صريحة. فعليك تفعيلها في blockstudio.json، والسماح بأنواع المقالات والتصنيفات التي تريد إدارتها، وتحديد مراجع البيانات الوصفية التي ينبغي إعادة كتابتها بين البيئات.
عند السحب، يكتب Blockstudio المقالات والعناصر التصنيفية والعلاقات والبيانات الوصفية المسموح بها في ملفات ضمن قالبك. وعند الدفع، يتحقق من الخطة قبل الكتابة، ويعيد ربط مراجع post وterm وattachment المعلنة بمعرّفات قاعدة البيانات المحلية. ولا يخمّن أن الأعداد الصحيحة العشوائية هي معرّفات.
نطاق الإصدار 7.4 محافظ عن قصد: المقالات، والعناصر التصنيفية، والعلاقات بينها، والبيانات الوصفية المسموح بها، ومعرّفات UID القابلة للنقل، وبيانات مرفقات الملفات، وعمليات التشغيل التجريبي، ومعالجة الحذف، والكيانات المقفلة، وتقارير الحالة. أما التقاط تعريفات التصنيفات ونسخ ملفات الوسائط وإعادة كتابة معرّفات ترميز الكتل، فقد استُبعدت عمدًا من هذا الإصدار الأول.
يوفر ذلك للفرق طريقة واضحة لإدارة المحتوى المنتقى بإصدارات، مثل أعضاء الفريق ودراسات الحالة والمواقع ومدخلات الوثائق أو السجلات المنظمة الأخرى، من دون تحويل قاعدة بيانات الإنتاج بأكملها إلى عملية ترحيل. وهو مخصص لمجموعات المحتوى التي يمكن مراجعتها كملفات: عشرات أو مئات الصفوف، وفي بعض المشاريع بضعة آلاف منخفضة العدد عندما يكون المحتوى منظمًا وقليل التغيير. وليس بديلًا عن النسخ الاحتياطية لقاعدة البيانات أو مزامنة التجارة الإلكترونية والطلبات أو التحليلات أو السجلات أو إرسالات النماذج أو غيرها من البيانات كبيرة الحجم.
مزامنة أكثر موثوقية
يكتشف Blockstudio الآن التغييرات عبر مصادر الصفحات وملفات بيان المجموعات وملفات أدوات التحميل وملفات التخطيطات والبيانات الوصفية والمسارات ذات الصلة. وإذا تغير أي منها، تُحدّث صفحة WordPress المتزامنة.
يتعامل مسار الصفحات أيضًا مع التفاصيل التي تجعل الوثائق المعتمدة على الملفات عملية في المشاريع الحقيقية:
- تُزامن مصادر صفحات Markdown كمحتوى كتل أصلي، بما في ذلك سمات الكتل
- تتوفر البيانات الوصفية للواجهة لمساعدات الواجهة الأمامية والتخطيطات
- تحتفظ صفحات المجموعات بهوية مستقرة عبر عمليات المزامنة
- ترتبط الصفحات المتداخلة غير التابعة لمجموعات بصفحتها الأم
- يمكن للصفحات المتداخلة غير التابعة لمجموعات أن ترث أقرب
layout.phpمن الأسلاف - تنظف مصادر المجموعات المحذوفة صفحات WordPress التي أنشأتها
- يؤدي تغيير المجموعة من
pageإلى نوع مقالة مخصص إلى ترحيل المقالات المتزامنة الموجودة بدلًا من إنشاء نسخ مكررة - يُحفَظ ترتيب الصفحات عبر
menu_order
بادئات وسوم الكتل
تدعم وسوم الكتل الآن بادئات قابلة للتهيئة لمساحات الأسماء. ويمكن للمشروع تسجيل بادئة قصيرة واحدة وترك Blockstudio يحل الكتلة ضمن مساحة أسماء واحدة أو أكثر:
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
$prefixes['theme'] = ['theme-components', 'bsui'];
return $prefixes;
});
بعد ذلك، يمكن لـ <theme-card> الحل إلى theme-components/card، ويمكن لـ <theme-button> الرجوع إلى bsui/button، كما يمكن لـ <theme-ui-feature-matrix> الحل إلى theme-components/ui-feature-matrix.
تظل tag_aliases الصريحة لها الأولوية عندما يحتاج المشروع إلى تجاوز لمرة واحدة. وتُترك الوسوم ذات البادئات غير المعروفة دون تغيير، كما تظل مرشحات السماح والمنع الحالية لوسوم الكتل سارية على الكتل التي تُحل عبر البادئات.
إصلاحات وقت التشغيل والمحرر
يتضمن الإصدار 7.4 أيضًا مجموعة من الإصلاحات التي ظهرت الحاجة إليها أثناء الاستخدام الفعلي للمشاريع.
- تظل الخيارات المعبأة ديناميكيًا عبر الاستعلامات حديثة عند تغيّر المقالات أو العناصر التصنيفية أو المستخدمين أو البيانات الوصفية ذات الصلة، كما تجلب قوائم تحديد الاستعلام
populate.fetch: trueخيارات مباشرة لعمليات البحث الفارغة في المحرر. - تحافظ وسوم الكتل
core/queryوcore/commentsالمُنشأة برمجيًا علىclassNameفي ترميز الحاوية المُنشأ. - تحافظ المكونات الشكلية للقوالب على الخصائص بصيغة camelCase، فتصل خصائص مثل
allowedFormatsوwithoutInteractiveFormattingإلى مكوّن المحرر بدلًا من إسقاطها مسبقًا. - يتعامل
bsui/selectمع بيانات الخيارات والقوائم الممتدة على نحو أكثر موثوقية، خصوصًا داخل عناصر تحكم المحرر الأكثر كثافة. - يتعرف
blockstudio/phpstanعلى الحقول المعلنة داخل حاوياتtabs، بحيث يتحقق القالب وTwig/Blade ووسوم الكتل من بنية الحقول نفسها التي يستخدمها Blockstudio في المشاريع. - يستمر حفظ حذف صف من المكرر يحتوي على RichText. ولم تعد قيم RichText القديمة تعيد الصف المحذوف.
لماذا يهم هذا الإصدار
محور الإصدار 7.4 هو قابلية النقل.
تحوّل مجموعات الصفحات مواقع الوثائق كاملة إلى مجلدات من الملفات المصدرية. وتجعل صفحات Markdown كتابة هذا المحتوى وقراءته مجددًا أمرًا سهلًا. وتمتد مزامنة المحتوى بالنموذج نفسه القائم على الملفات أولًا إلى المحتوى المنتقى من قاعدة البيانات، بحيث يمكن أن تعيش المقالات والعناصر التصنيفية والعلاقات في git وأن تنتقل بين البيئات. وتحافظ بادئات وسوم الكتل على سهولة قراءة مكتبات الكتل الكبيرة في القوالب.
لا يزال Blockstudio معتمدًا على الملفات. ولا تزال الكتل مجلدات والصفحات ملفات. يتيح الإصدار 7.4 ببساطة حفظ مزيد من عناصر المشروع، من بنيات صفحاته ومحتواه المنتقى، في تلك الملفات ونقلها معها.