Dennis · 7 فبراير 2026
Introducing Blockstudio 7
وصل Blockstudio 7. هذا أكبر إصدار في تاريخ المشروع: إعادة كتابة كاملة لقاعدة الأكواد من الصفر. أُعيد بناء كل صنف وكل خطاف وكل سطر برمجي من البداية، مع التركيز على PHP الحديث ومعايير البرمجة في WordPress وسهولة الصيانة على المدى الطويل.
لكن الأمر لا يقتصر على إعادة الهيكلة. يقدّم Blockstudio 7 ميزات رئيسية، مثل الصفحات والأنماط القائمة على الملفات، ونظام تخزين البيانات الوصفية للمنشورات، وتكامل SEO، ومحلل جديد كليًا من HTML إلى الكتل يشغّل كل ذلك. إضافةً إلى هذا، أصبح Blockstudio مجانيًا ومفتوح المصدر بالكامل.
لنستعرض كل ما هو جديد.
مجاني ومفتوح المصدر
أعمل على Blockstudio منذ عام 2020، وأصدرت عشرات الإصدارات على مر السنين. أحبّه مستخدموه، لكن العثور على ملاءمة للسوق لإطار عمل تجاري لكتل WordPress ظل تحديًا دائمًا.
ما غيّر المعادلة هو نماذج اللغة الكبيرة (LLMs). أصبحت مساعدات البرمجة بالذكاء الاصطناعي قادرة على كتابة أكواد الكتل، لكنها تحتاج إلى بنى واضحة قائمة على الملفات للعمل معها. ترميز كتل WordPress غير مرتب: تعليقات HTML متسلسلة تتضمن سمات JSON مضمّنة، ومختلطة ببنية DOM. يصعب على البشر التعامل معها، ويصعب أكثر على نماذج اللغة الكبيرة إتقانها.
صُمم نهج Blockstudio المعتمد على الملفات أولًا ليُبقي الأمور بسيطة دائمًا: block.json وقالب PHP في مجلد. بلا إدخالات في قاعدة البيانات، ولا React، ولا خطوة بناء. ومع v7، تمضي هذه الفلسفة إلى أبعد من ذلك. يتيح محلل HTML إلى الكتل كتابة HTML عادي وتحويله تلقائيًا إلى ترميز كتل صالح. يبقى كل شيء في نظام الملفات. وعمليات الكتابة الوحيدة في قاعدة البيانات هي مزامنة الصفحات المطلوبة صراحةً عبر PHP API أو CLI، وتُدار بواسطة قوالب الملفات.
إن جعل Blockstudio مفتوح المصدر هو الخطوة التالية الطبيعية. كلما تدربت نماذج اللغة الكبيرة على Blockstudio الشيفرة، تحسنت قدرتها على إنشائها. إن قاعدة شيفرة مفتوحة ووثائق مفتوحة وملف سياق الذكاء الاصطناعي مُعد مسبقًا ويمكن لأي أداة استخدامه، هي الطريقة المثلى لبناء بيئة تطوير بمساعدة WordPress الذكاء الاصطناعي.
الإضافة كاملة متاحة على GitHub ليستخدمها الجميع ويتفرعوا منها ويساهموا فيها. بلا مفاتيح ترخيص أو جدران دفع أو قيود على الميزات.
الميزات الجديدة
صفحات قائمة على الملفات
هذه إحدى أكبر الإضافات في الإصدار 7.0. يمكنك الآن تعريف صفحات WordPress كاملة كقوالب ملفات تُزامَن مع قاعدة البيانات كمحتوى كتل أصلي عند تشغيل API أو CLI لمزامنة الصفحات.
أنشئ مجلدًا يحتوي على page.json وملف قالب:
{
"name": "about",
"title": "About Us",
"slug": "about",
"postStatus": "publish"
}
<div class="about-page">
<h1>About Us</h1>
<p>Welcome to our site.</p>
</div>
شغّل wp bs pages sync ليحلل Blockstudio ملف HTML إلى كتل WordPress وينشئ الصفحة في قاعدة البيانات أو يحدّثها.
دمج الكتل باستخدام المفاتيح
عادةً ما تُستبدل تعديلات المستخدم عند مزامنة القوالب. تحل سمة key هذه المشكلة بالحفاظ على محتوى المستخدم عبر عمليات المزامنة:
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>
تحتفظ الكتل ذات المفاتيح المطابقة بمحتواها الذي عدّله المستخدم عند تحديث القالب. أما الكتل التي بلا مفاتيح فتُستبدل بالكامل.
ارتباطات الكتل
بدلًا من المفاتيح، يمكنك استخدام ارتباطات الكتلAPI في نواة WordPress لربط الكتل مباشرةً بالبيانات الوصفية للمنشورات. هذه ليست ميزة Blockstudio، بل هي WordPress API أصلية. يمرر Blockstudio ببساطة سمة metadata إلى ترميز الكتل المُنشأ. تُخزّن البيانات في البيانات الوصفية بدلًا من ترميز الكتل، لذا لا تمحو مزامنة القوالب تعديلات المستخدم مطلقًا. كما يمكن الاستعلام عن البيانات عبر WP_Query وتتوفر من خلال REST API.
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
Default Title
</h1>
يمكن استخدام النهجين معًا في القالب نفسه.
عناصر التحكم في التحرير
تدعم الصفحات blockEditingMode وtemplateLock للتحكم فيما يمكن للمستخدمين تعديله:
{
"name": "landing",
"title": "Landing Page",
"blockEditingMode": "contentOnly",
"templateLock": "all"
}
يقفل هذا بنية الصفحة مع السماح للمستخدمين بتحرير النص والوسائط. ويمكن للعناصر الفردية تجاوز إعداد الصفحة عبر سمة blockEditingMode في القالب.
تثبيت الصفحات بمعرّفات المنشورات
استخدم postId لربط قالب صفحة بمنشور WordPress موجود، ما يمنع تكرار الصفحات ويضمن تحديث القالب للمنشور الصحيح دائمًا:
{
"name": "home",
"title": "Home",
"postId": 2
}
للاطلاع على التفاصيل كاملة، راجع وثائق الصفحات.
أنماط قائمة على الملفات
مثل الصفحات، يمكنك الآن تعريف أنماط الكتل كقوالب ملفات. اكتب النمط في HTML، وسيحلله Blockstudio إلى ترميز كتل ويسجله كنمط كتل أصلي في WordPress. تظهر الأنماط في أداة إدراج الكتل ويمكن للمستخدمين وضعها في أي مكان.
{
"name": "hero-section",
"title": "Hero Section",
"categories": ["featured"],
"keywords": ["hero", "banner"]
}
<div class="hero">
<h1>Welcome</h1>
<p>Get started today.</p>
</div>
على خلاف الصفحات، لا تنشئ الأنماط سجلات في قاعدة البيانات. بل تُسجل في الذاكرة عند تحميل كل صفحة. راجع وثائق الأنماط.
محلل من HTML إلى الكتل
تعتمد الصفحات والأنماط على محلل HTML جديد يحوّل قوالب HTML القياسية إلى ترميز كتل WordPress. ويتعامل تلقائيًا مع كتل الحاويات (مثل المجموعات والأعمدة) والكتل الطرفية (مثل الفقرات والعناوين). يستخدم المحلل بنية عرض قائمة على السمات، ما يسهّل توسيعه لدعم أنواع كتل إضافية عبر مرشح blockstudio/parser/renderers:
add_filter( 'blockstudio/parser/renderers', function ( $renderers, $parser ) {
$renderers['acme/hero'] = function ( $element, $attrs, $parser ) {
$content = $parser->get_inner_html( $element );
$html = '<div class="acme-hero">' . $content . '</div>';
return array(
'blockName' => 'acme/hero',
'attrs' => $attrs,
'innerBlocks' => array(),
'innerHTML' => $html,
'innerContent' => array( $html ),
);
};
return $renderers;
}, 10, 2 );
بعد تسجيل الكتلة، يمكنك استخدامها في أي قالب صفحة أو نمط:
<block name="acme/hero" background="/hero.jpg">
<h1>Welcome to our site</h1>
</block>
التخزين
يمكن للحقول الآن تخزين قيمها في البيانات الوصفية للمنشورات أو خيارات الموقع، إلى جانب سمات الكتل. وهذه إضافة كبيرة:
{
"id": "subtitle",
"type": "text",
"label": "Subtitle",
"storage": {
"type": "postMeta"
}
}
عند تخزين القيم في البيانات الوصفية للمنشورات، يمكنك:
- الاستعلام عن المنشورات حسب قيم الحقول باستخدام
WP_Queryوmeta_query - الوصول إلى بيانات الحقول عبر REST API لإعدادات المواقع عديمة الواجهة
- مشاركة البيانات مع إضافات أخرى مثل أدوات SEO وطبقات التخزين المؤقت
يمكنك أيضًا تخزين القيم في جدول الخيارات لإعدادات عامة على مستوى الموقع:
{
"id": "phone",
"type": "text",
"label": "Phone Number",
"storage": {
"type": "option",
"optionKey": "company_phone"
}
}
راجع وثائق التخزين للاطلاع على API كاملة.
حقول مخصصة
يمكن الآن مشاركة تعريفات الحقول القابلة لإعادة الاستخدام بين كتل متعددة. عرّف مجموعة من الحقول مرة واحدة، ثم أشر إليها من أي كتلة. وهذا يزيل التكرار عندما تشترك كتل متعددة في بنية الحقول نفسها.
أنشئ field.json في مجلد blockstudio:
{
"name": "hero",
"title": "Hero Section",
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
{ "id": "description", "type": "textarea", "label": "Description" }
]
}
ثم أشر إليه من أي كتلة باستخدام البادئة custom/:
{
"blockstudio": {
"attributes": [
{ "type": "custom/hero", "idStructure": "hero_{id}" }
]
}
}
تضيف الخاصية idStructure بادئة إلى معرّف كل حقل، لذا يصبح heading هو hero_heading. ويمكنك أيضًا تجاوز خصائص الحقول الفردية لكل نسخة باستخدام المفتاح overrides.
راجع وثائق الحقول المخصصة.
Tailwind CSS v4
أُعيد بناء دعم Tailwind بالكامل من أجل v4. فبدلًا من التجميع على جانب العميل عبر CDN والحفظ على القرص عند حفظ المقالة (نهج v6)، يجمّع Blockstudio 7 Tailwind على جانب الخادم مع كل طلب للواجهة الأمامية عبر TailwindPHP. لا حاجة إلى Node.js أو CLI أو خطوة بناء.
يستخدم التجميع تخزينًا مؤقتًا قائمًا على المرشحين: يستخرج Blockstudio جميع أسماء أصناف CSS من HTML النهائي، ويرتبها ويحسب تجزئتها مع إعداد CSS، ثم يتحقق من وجود ملف مخزّن مؤقتًا. تؤدي الأصناف نفسها إلى إصابة ذاكرة التخزين المؤقت نفسها، حتى عندما يتغير HTML المحيط بها (القيم العشوائية، والطوابع الزمنية، والمحتوى الديناميكي).
يستخدم الإعداد صياغة Tailwind v4 التي تبدأ بـ CSS. عرّف السمات المخصصة وأصناف الأدوات مباشرةً في blockstudio.json أو عبر مرشح blockstudio/tailwind/css:
add_filter('blockstudio/tailwind/css', function ($css) {
return $css . '
@theme {
--color-brand: #4f46e5;
}
@layer utilities {
.container-narrow {
max-width: 48rem;
margin-inline: auto;
}
}
';
});
في محرر الكتل، يوفّر برنامج Tailwind النصي المضمّن CDN معاينة مباشرة أثناء الكتابة. ويوفر نوع الحقل classes إكمالًا تلقائيًا لكل أدوات Tailwind. تستخدم الواجهة الأمامية دائمًا CSS المجمّع على الخادم، والمُدرج كوسم نمط مضمن قبل </head>.
راجع وثائق Tailwind للاطلاع على الإعداد كاملًا.
واجهة التفاعلية API
يدعم Blockstudio الآن WordPress واجهة التفاعلية API. فعّلها في block.json:
{
"blockstudio": {
"interactivity": true
}
}
أضف توجيهات data-wp-* إلى القالب:
<div useBlockProps
data-wp-interactive="myBlock"
data-wp-context='{ "isOpen": false }'>
<button data-wp-on--click="actions.toggle"
data-wp-bind--aria-expanded="context.isOpen">
Toggle
</button>
<div data-wp-bind--hidden="!context.isOpen">
This content is toggled by the button.
</div>
</div>
وأنشئ script.js يتضمن منطق المخزن:
import { store, getContext } from '@wordpress/interactivity';
store('myBlock', {
actions: {
toggle: () => {
const context = getContext();
context.isOpen = !context.isOpen;
},
},
});
يتولى Blockstudio معالجة خريطة الاستيراد وتحميل الوحدات ومعالجة التوجيهات في كل من الواجهة الأمامية ومحرر الكتل. وتعمل الكتل التي تستخدم التوجيهات التصريحية فقط مع data-wp-context (مثل data-wp-bind--hidden أو data-wp-text) دون أي JavaScript. كما تُدعم الحالة من جانب الخادم عبر wp_interactivity_state() في الواجهة الأمامية.
راجع وثائق التفاعلية للاطلاع على الإعداد كاملًا.
تحليل محتوى SEO
كتل Blockstudio ديناميكية، لذا يكون محتوى حقولها غير مرئي لإضافات SEO افتراضيًا. يعالج Blockstudio 7 هذا الأمر بتكاملات تلقائية مع Yoast SEO وRank Math وSEOPress. تُستخرج القيم النصية من حقول text وtextarea وrichtext وwysiwyg وlink، بما فيها صفوف المكررات المتداخلة، وتُمرر إلى تحليل المحتوى في كل إضافة. ويمكن الآن لإضافات SEO تحليل محتوى كتلّك على نحو سليم من حيث كثافة الكلمات المفتاحية وسهولة القراءة ومقاييس أخرى. لا حاجة إلى أي إعداد.
الصفوف الافتراضية للحقول المكررة
تدعم حقول المكررات الآن خاصية default تتضمن مصفوفة من الصفوف المعبأة مسبقًا. عند إدراج كتلة، يُملأ حقل المكرر بالصفوف المحددة وقيمها، في المحرر والواجهة الأمامية:
{
"id": "features",
"type": "repeater",
"label": "Features",
"default": [
{ "title": "Fast", "icon": "bolt" },
{ "title": "Secure", "icon": "shield" }
],
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "icon", "type": "text", "label": "Icon" }
]
}
تعمل خاصية min أيضًا مع القيم الافتراضية على مستوى الحقل: فإذا كان للمكرر min: 3 وكانت لحقوله الداخلية قيم default، تُملأ الصفوف المُنشأة تلقائيًا بهذه القيم الافتراضية بدلًا من تركها فارغة.
التحسينات والإصلاحات
minمتكرر مع قيم الحقول الافتراضية: تستخدم الصفوف الدنيا المُنشأة تلقائيًا الآن القيم الافتراضية على مستوى الحقل في الواجهة الأمامية والمحرر- أنماط محرر Tailwind: يُحقن Tailwind CSS المُجمّع الآن في إطار المحرر إلى جانب CDN، لتعمل قواعد
@applyالمخصصة وإعدادات القالب في المحرر - ملف سياق الذكاء الاصطناعي: أُعيد بناء
blockstudio-llm.txtكملف ثابت مُجمّع من وثائق v7 الكاملة ومخططات JSON المنقّحة من التكرار (نحو 48 ألف رمز)، ليحل محل الإنشاء الديناميكي من v6 - نافذة منبثقة لحقل التعليمات البرمجية: يمكن الآن فتح حقل التعليمات البرمجية في نافذة منفصلة، مع التراجع والإعادة بشكل مستقل وتمييز صياغة JavaScript
- التجميع على جانب الخادم لـ Tailwind v4: راجع قسم Tailwind أعلاه
- الإصدار 3 من API: تُصيّر الكتل الآن على نحو صحيح في المحرر ذي الإطار، بما في ذلك محرر الموقع والمعاينات المتجاوبة
- صياغة النقطة لأسماء الأصول: اصطلاح أوضح لتسمية الملفات للاحقات الأصول (
*.inline.css،*.editor.js،*.scoped.css) - إصلاح تحذير
bs_render_block()منWP_Block_Supportsعند استخدامuseBlockProps - إصلاح عدم احترام الحقول الشرطية للقيم الافتراضية عند التحميل الأول
- إصلاح إزالة علامات الدولار من محتوى
<RichText />في الواجهة الأمامية - إصلاح عمل ميزة
populateمع التصنيفات المسجلة بواسطة إضافات أخرى - إصلاح خطأ القيمة الخالية
optionsPopulateفي سياقات WPML
التفاصيل الداخلية
إعادة كتابة كاملة
هذه ليست إعادة هيكلة أو تنقيحًا. أُعيدت كتابة كل الأصناف من الصفر. والنتيجة قاعدة أكواد أوضح وأكثر نمطية، يسهل صيانتها وتوسيعها.
PHP حديث
يتطلب Blockstudio 7 الإصدار PHP 8.2+، ويستخدم تصريحات الأنواع الحديثة في جميع أجزائه.
تغييرات غير متوافقة
يتضمن الإصدار 7.0، بوصفه تحديثًا رئيسيًا، عدة تغييرات غير متوافقة. تتوفر لمعظمها آليات بديلة متوافقة مع الإصدارات السابقة، لكن ينبغي مراجعتها قبل الترقية. للاطلاع على دليل الترحيل الكامل، راجع وثائق الترحيل v7.
أصبحت أسماء الخطافات تستخدم snake_case
أُعيدت تسمية جميع خطافات PHP من camelCase إلى snake_case، بما يتوافق مع اصطلاحات نواة WordPress:
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
return ['my-stylesheet'];
});
// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
return ['my-stylesheet'];
});
تظل أسماء camelCase القديمة مدعومة، لكننا نوصي بتحديثها.
قيمة المفتاح الافتراضية متوقفة
أصبحت القيمة الافتراضية لخاصية switch هي false بدلًا من true. في v6، كان لكل حقل مفتاح تبديل غير مرئي على الحافة اليسرى ومفعّلًا افتراضيًا. أما في v7، فالتبديل اختياري ويستخدم رمز عين ظاهرًا في تسمية الحقل. إذا كنت تعتمد على سلوك التبديل الافتراضي، فأضف "switch": true إلى تعريفات الحقول لديك.
تستخدم أسماء ملفات الأصول النقاط
تستخدم لواحق الأصول الآن النقاط بدلًا من الشرطات (style.inline.css بدلًا من style-inline.css). يظل أسلوب الشرطة القديم مدعومًا، لكن يُوصى باستخدام النقاط من الآن فصاعدًا.
بادئة الاستيراد npm
تستخدم عمليات الاستيراد بوحدات ES الآن npm: بدلًا من blockstudio/:
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";
// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";
تظل البادئة blockstudio/ مدعومة للتوافق مع الإصدارات السابقة.
الميزات المحذوفة
منطقة الإدارة ومحرر الأكواد. حُذفت صفحة إعدادات الإدارة في WordPress ومحرر أكواد الكتل المدمج. تتم جميع عمليات الإعداد الآن عبر مرشحي blockstudio.json وPHP، ما يعني أن إعدادك محفوظ في نظام التحكم بالإصدارات إلى جانب كتلّك.
كان محرر الأكواد مفيدًا في الإصدارات السابقة لمعاينة الكتل، لكنه لم يضاهِ قط بيئة تطوير حقيقية بالكامل. وعلى مر السنين، تعذّر دعم عدة ميزات للإضافة داخله. كما أنه لم يكن ليحل محل بيئة تطوير متكاملة كاملة. يتيح حذفه للإضافة التركيز بالكامل على التطوير القائم على الملفات دون تنازلات.
مفتاح الترخيص. لم تعد هناك حاجة إليه. Blockstudio مجاني ومفتوح المصدر.
مكتبة الكتل. أُزيلت مكتبة “Blockstudio Elements” المضمّنة (المعرض، وشرائح العرض، ومقارنة الصور، والتعليمات البرمجية، والأيقونة). كانت هذه كتلًا نموذجية مُعدّة مسبقًا ومضمنة مع الإضافة. إذا كنت تستخدمها، فانسخ مجلدات الكتل من v6 إلى دليل blockstudio في قالبك.
البدء
ثبّت Blockstudio 7 وأنشئ أول كتلة لك في دقائق. اطّلع على دليل البدء للحصول على شرح خطوة بخطوة، أو على دليل الترحيل من v7 إذا كنت تقوم بالترقية من v6.
المصدر كاملًا متاح على GitHub. نرحب بالبلاغات وطلبات السحب والملاحظات.