انتقل إلى المحتوى

Dennis · 14 مارس 2026

Blockstudio 7.1

Blockstudio 7.1 هو أول إصدار يتضمن ميزات جديدة منذ إعادة كتابة v7. أعاد v7 بناء الأساس، ويضيف الإصدار 7.1 مكوّنات تحوّل الكتل إلى ما هو أكثر: طبقة قاعدة بيانات، ووظائف خادم، ومهام مجدولة، وCLI. يمكن الآن لمجلد الكتل أن يكون تطبيقًا كاملًا.

إليك كل ما هو جديد.

المكوّنات

لطالما وُجد توتر بين الكتل التي يستخدمها المحررون في أداة الإدراج والكتل التي يستخدمها المطورون لبناء أشياء أخرى. بطاقة، أو شارة، أو أداة إحصاءات، أو حقل إدخال نموذج. تحتاج هذه العناصر إلى مسار البناء الكامل لـ Blockstudio (السمات والقوالب والأصول وTailwind)، لكن لا داعي لظهورها في أداة الإدراج.

يقدّم الإصدار 7.1 المكوّنات لحل هذه المشكلة. عيّن "component": true في block.json، وستمر الكتلة عبر مسار البناء بالكامل، لكنها لن تُسجّل في سجل أنواع الكتل الخاص بـ WordPress. لن تظهر في أداة الإدراج أو في بيانات المحرر المرسلة إلى JavaScript، لكنها ستظل متاحة بالكامل للعرض البرمجي.

JSON
{
  "name": "my-theme/card",
  "title": "Card",
  "blockstudio": {
    "component": true,
    "attributes": [
      { "id": "title", "type": "text" },
      { "id": "description", "type": "textarea" }
    ]
  }
}

اعرضها من PHP:

PHP
bs_render_block([
  'name' => 'my-theme/card',
  'data' => ['title' => 'My Card', 'description' => 'Card content.'],
]);

أو باستخدام صياغة الوسم الجديدة HTML:

HTML
<bs:my-theme-card title="My Card" description="Card content." />

وسوم الكتل

يمكن الآن تضمين الكتل كوسوم HTML باستخدام صيغتين قابلتين للتبادل:

HTML
<bs:acme-hero title="Welcome" />
<block name="acme/hero" title="Welcome" />

تنتج الصيغتان المخرجات نفسها. وتعمل كلتاهما مع كتل Blockstudio وكتل WordPress الأساسية. داخل قوالب الكتل، تُعرض تلقائيًا دون الحاجة إلى تفعيلها. وهذا يعني أنه يمكنك تركيب تخطيطات كاملة من كتل أخرى مباشرةً في قالبك:

Twig
<div class="my-page">
  <bs:mytheme-card title="Featured" />
  <block name="core/separator" />
  <bs:core-heading level="2">Section Title</bs:core-heading>
  <block name="core/group">
    <block name="core/paragraph">Inside a core group block.</block>
    <bs:mytheme-cta variant="primary" />
  </block>
</div>

يمكن تداخل الصيغتين بحرية. تُعرض كتل Blockstudio عبر مسار البناء الكامل (القوالب وTailwind والأصول). أما الكتل الأساسية فتُعرض عبر WordPress باستخدام أدوات العرض نفسها التي تشغّل الصفحات والأنماط.

لعرض مستوى الصفحة (محتوى المنشور ومناطق الأدوات)، فعّله في blockstudio.json:

JSON
{ "blockTags": { "enabled": true } }

تتحكم قائمتا السماح والمنع في الكتل التي يمكن عرضها عبر الوسوم، باستخدام أنماط أحرف البدل. تُمرَّر سمتا data-* وhtml-* إلى عنصر HTML الجذر للكتلة المعروضة. ويمكن تسجيل أدوات عرض مخصصة عبر المرشح blockstudio/block_tags/renderers.

في الخلفية، يحلّل الوسوم ماسح سلاسل جديد وخفيف الوزن محل DOMDocument بالكامل. ويتعامل مع الوسوم المتداخلة عبر تتبع العمق، وكتل الحاويات العودية، والصيغ المختلطة في مرور واحد. في الاختبارات المعيارية، يحلل 1,000 وسم مسطح في 2.4ms و100 مستوى من التداخل في 3.7ms، بسرعة تفوق باستمرار DOMDocument وWordPress ‏WP_HTML_Tag_Processor. ويتولى المحلل نفسه أيضًا تحليل عناصر HTML الخام في الصفحات والأنماط، مستبدلًا المحلل المعتمد على DOMDocument الذي كان يتولى سابقًا معالجة <p> و<div> وعناصر HTML الأخرى.

أنواع حقول جديدة

كتلة

نوع حقل جديد block يتيح لك الإشارة إلى كتلة Blockstudio أخرى كسمة. تتوسع حقول الكتلة المشار إليها ضمن السطر باستخدام idStructure وoverrides، تمامًا مثل الحقول المخصصة. والفرق أن الوصول إلى القيمة في القالب يعيد مخرجات الكتلة المعروضة.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "card",
        "type": "block",
        "block": "mytheme/card",
        "idStructure": "card_{id}"
      }
    ]
  }
}

إذا كانت لدى mytheme/card حقلا heading وcontent، فستظهر في الشريط الجانبي للكتلة المضيفة حقلا card_heading وcard_content. وفي القالب، يعرض {{ a.card }} البطاقة المعروضة. يعمل ذلك مع الكتل العادية والمكوّنات.

وسم HTML

تحتوي كل سمة على كتل ينبغي أن يتغير مستوى عنوانها حسب السياق: H1 في الصفحة الرئيسية وH2 في الصفحات الداخلية. بدلًا من إنشاء حقل تحديد بخيارات ثابتة في كل مرة، أصبح هناك نوع حقل مخصص html-tag يتضمن إعدادات مسبقة.

JSON
{
  "id": "tag",
  "type": "html-tag",
  "default": "h2",
  "tags": "heading",
  "exclude": ["h5", "h6"]
}

الإعدادات المسبقة: heading ‏(h1-h6)، وtext ‏(العناوين إضافة إلى p وspan وdiv)، وstructural ‏(div وsection وarticle وaside وmain وheader وfooter وnav)، وall. أو مرّر مصفوفة مخصصة. يزيل exclude وسومًا محددة من أي إعداد مسبق.

Twig
<{{ a.tag }}>{{ a.title }}</{{ a.tag }}>

قاعدة البيانات

هذه هي الميزة المحورية في هذا الإصدار. أضف ملف db.php إلى أي مجلد كتلة، وسيُنشئ Blockstudio خمس نقاط نهاية CRUD من نوع REST، ويتحقق من صحة كل عملية كتابة وفق المخطط، ويدير واجهة التخزين الخلفية تلقائيًا، ويوفر عميل JavaScript ‏(bs.db()) وPHP ‏API ‏(Db::get()). لا حاجة إلى ملفات ترحيل أو أصناف وحدات تحكم أو تسجيل مسارات.

PHP
return [
    'subscribers' => [
        'storage'    => 'table',
        'capability' => [
            'create' => true,
            'read'   => true,
            'update' => 'edit_posts',
            'delete' => 'manage_options',
        ],
        'fields' => [
            'email' => [
                'type'     => 'string',
                'format'   => 'email',
                'required' => true,
                'validate' => function ($value) {
                    if (str_ends_with($value, '@spam.com')) {
                        return 'This domain is blocked.';
                    }
                    return true;
                },
            ],
            'name' => ['type' => 'string', 'maxLength' => 100],
            'plan' => ['type' => 'string', 'enum' => ['free', 'pro']],
        ],
    ],
];

ينتج عن هذا المخطط وحده API يعمل بالكامل، مع نقاط نهاية للإنشاء والقائمة والجلب والتحديث والحذف، وكلها تتحقق من صحة المدخلات.

التخزين

خمس واجهات تخزين خلفية، لكل منها استخدامات تناسبها:

  • table: جدول MySQL مخصص تديره dbDelta(). تؤدي إضافة حقول إلى المخطط إلى إضافة أعمدة عند تحميل الصفحة التالية. الخيار الافتراضي للإنتاج.
  • sqlite: ملف SQLite واحد في مجلد db/ الخاص بالكتلة. استعلامات SQL حقيقية، ووضع WAL للقراءات المتزامنة، وقابلية نقل كاملة. انسخ المجلد لنسخ قاعدة البيانات.
  • jsonc: كائن JSON واحد في كل سطر بملف مسطح. مقروء للبشر، ويمكن تتبع إصداراته، ومتوافق مع git.
  • meta: مصفوفة JSON في بيانات المنشور WordPress، مرتبطة بمنشور محدد.
  • post_type: يصبح كل سجل منشورًا من نوع WordPress ضمن نوع منشور مخصص. تُخزّن الحقول كمدخلات منفردة في بيانات المنشور، ويمكن الاستعلام عنها بالكامل باستخدام WP_Query.

العملاء

على جانب JavaScript، يوفر لك bs.db() عميل CRUD متكاملًا:

JavaScript
const db = bs.db('my-theme/block', 'subscribers');
const record = await db.create({ email: 'a@b.com', plan: 'pro' });
const pros = await db.list({ plan: 'pro' });
await db.update(record.id, { plan: 'free' });
await db.delete(record.id);

تأتي معه ثلاث أدوات مساعدة:

  • bs.cache: ذاكرة تخزين مؤقت للاستعلامات داخل الذاكرة، مع get وset وinvalidate وclear. مشتركة بين جميع استدعاءات الاستعلام والتغيير.
  • bs.query(key, fn, options): تغلف أي دالة غير متزامنة بالتخزين المؤقت وإزالة تكرار الطلبات وstaleTime القابلة للضبط. تعيد الاستدعاءات المتعددة بالمفتاح نفسه أثناء تنفيذ الطلب الوعد نفسه.
  • bs.mutate(options): تتولى التغييرات التفاؤلية مع التراجع التلقائي. مرّر كائن حالة تفاعليًا وإجراءً (create أو update أو delete) وبيانات تفاؤلية. يُحدَّث UI فورًا. وإذا فشل استدعاء الخادم، تعود الحالة إلى اللقطة السابقة للتغيير.

تغطي هذه الأدوات معًا دورة القراءة والكتابة كاملة: bs.query للقراءات المخزنة مؤقتًا، وbs.mutate للكتابات التفاؤلية، وbs.cache للتحكم اليدوي.

على جانب PHP، توفر الفئة Db العمليات نفسها:

PHP
use Blockstudio\Db;

$db = Db::get('my-theme/block', 'subscribers');
$db->create(['email' => 'a@b.com', 'plan' => 'pro']);
$db->list(['plan' => 'pro']);

التحقق من الصحة

تُعاد أخطاء التحقق من الصحة في مصفوفات أخطاء لكل حقل، مستوحاة من تنسيق fieldErrors في Zod. يمكن أن تفشل قواعد متعددة للحقل نفسه، ويُسهّل هذا الهيكل ربط الأخطاء بحقول النموذج في الواجهة الأمامية:

JSON
{
  "data": {
    "status": 400,
    "errors": {
      "email": ["Must be a valid email address.", "This domain is blocked."],
      "plan": ["Must be one of: free, pro."]
    }
  }
}

تُنفذ دوال رد النداء المخصصة validate على الخادم لمعالجة ما لا تغطيه القواعد المضمنة: حظر النطاقات، والتحقق بين الحقول، وعمليات البحث الخارجية.

البيانات الخاصة بالمستخدم

لبيانات كل مستخدم على حدة، مثل قوائم المهام والمفضلة والمسودات، عيّن userScoped إلى true وسيتولى Blockstudio الباقي. سيضيف عمود user_id، ويضبطه تلقائيًا عند الإنشاء، ويقصر كل استعلام على المستخدم الحالي. ويتحقق من الملكية عند التحديث والحذف. لا حاجة إلى حقل user_id يدوي أو خطاف before_create أو تصفية في RPC. سطر إعداد واحد. وعند استخدام تخزين post_type، يربط userScoped بـ post_author بدلًا من عمود منفصل.

PHP
return [
    'storage'    => 'sqlite',
    'userScoped' => true,
    'fields'     => [ /* ... */ ],
];

الاستطلاع الفوري

عيّن 'realtime' => true في المخطط، وسيستطلع العميل التغييرات تلقائيًا. عند حدوث تغيير على الخادم، يُحدَّث مخزن Interactivity API وتُعاد معالجة UI دون أي تغييرات في JavaScript لديك. اضبطه باستخدام 'realtime' => ['key' => 'todos', 'interval' => 5000] لتحديد مفاتيح الحالة والفواصل الزمنية المخصصة. يستخدم الاستطلاع مقارنة التجزئة لتقليل حجم الطلبات، ويتوقف مؤقتًا عندما تكون علامة تبويب المتصفح مخفية.

الأمان والخطافات وقابلية النقل

تُحمى نقاط النهاية العامة برأس CSRF من X-BS-Token يُحقن تلقائيًا. استخدم 'open' عندما تحتاج إلى وصول بلا مصادقة فعلًا، مثل خطافات الويب الواردة.

تُنفذ خطافات دورة الحياة قبل كل عملية كتابة وبعدها. عرّفها ضمن db.php أو على مستوى عام عبر إجراءات WordPress.

يمكن للحقول تعريف مفتاح component لعرض النماذج المستند إلى المخطط عبر bs_db_form().

مع تخزين SQLite أو JSONC، يوجد التطبيق بأكمله في مجلد واحد: الشفرة والمنطق والتحكم في الوصول والبيانات. انسخ المجلد لنشره.

RPC

أحيانًا لا تكفي CRUD. فقد تحتاج إلى منطق خادم مخصص، مثل تبديل حالة مهمة أو إرسال إشعار أو تجميع الإحصاءات. لهذا الغرض توجد rpc.php. عرّف دالة PHP، واستدعها من الواجهة الأمامية باستخدام bs.fn()، وسيتولى Blockstudio نقطة نهاية REST والمصادقة والحماية من CSRF وتسلسل JSON. يستوحي هذا الأسلوب فكرته من tRPC: تُعرّف الإجراءات على الخادم ويستدعيها العميل بالاسم.

PHP
return [
    'subscribe' => function (array $params): array {
        $email = sanitize_email($params['email']);
        return ['success' => true];
    },
];
JavaScript
const result = await bs.fn('subscribe', { email: 'user@example.com' });

تكتشف السكربتات المضمنة (script-inline.js) اسم الكتلة تلقائيًا من السمة data-block في وسم السكربت، فلا حاجة إلى تمريره يدويًا. أما سكربتات الوحدات فتمرره كوسيط ثالث.

تشمل خيارات التحكم في الوصول public (مع CSRF) و'open' (دون حماية) وسلاسل الصلاحيات أو المصفوفات. كما يتوفر التحكم في طريقة HTTP لكل دالة، وخطافات دورة الحياة، والاستدعاء بين الكتل من كل من JS وPHP.

Cron

تُعرّف المهام الخلفية في ملف cron.php. عيّن جدولًا زمنيًا ودالة رد نداء، وسيسجلها Blockstudio لدى Cron الخاص بـ WordPress عند التهيئة. عند إلغاء تفعيل الإضافة، تُلغى جدولة كل شيء بشكل سليم.

PHP
return [
    'cleanup' => [
        'schedule' => 'daily',
        'callback' => function () {
            $db = Db::get('my-theme/app', 'logs');
            // delete old entries
        },
    ],
    'sync' => [
        'schedule' => 'hourly',
        'callback' => function () {
            // pull from external API
        },
    ],
];

تتوفر جميع جداول WordPress المضمنة، إلى جانب الفواصل الزمنية المخصصة عبر المرشح cron_schedules.

CLI

يغطي أمر wp bs الجديد مجموعة ميزات Blockstudio بالكامل: الكتل وقاعدة البيانات وRPC وcron والإعدادات وتجميع Tailwind وتجميع SCSS والحقول المخصصة وإدارة الأصول.

سطر الأوامر
wp bs blocks list --components
wp bs db schemas
wp bs db create my-theme/app subs --email=a@b.com
wp bs db list my-theme/app subs --plan=pro --format=json
wp bs rpc call my-theme/app subscribe --email=a@b.com
wp bs cron run my-theme/app cleanup
wp bs tailwind compile --file=template.html
wp bs scss compile --file=style.scss
wp bs fields list
wp bs assets list --type=global
wp bs settings get tailwind/enabled

تدعم جميع الأوامر --format=json للبرمجة النصية.

تحسينات الحقول المتكررة

textMinimized لحقول الكائنات

تتعامل صفوف الحقول المتكررة المطوية الآن مع قيم حقول الكائنات على نحو سليم. سابقًا، كان توجيه textMinimized إلى حقل رابط يعرض [object Object]. أما الآن، فيقرأ Blockstudio الخاصية الفرعية الصحيحة تلقائيًا حسب نوع الحقل: title للروابط، وvalue للألوان والتدرجات، وicon للأيقونات. ويمكنك أيضًا تعيين خاصية key صراحةً لقراءة أي خاصية فرعية تريدها.

JSON
{
  "type": "repeater",
  "textMinimized": { "id": "href", "fallback": "Add a link" },
  "attributes": [{ "id": "href", "type": "link" }]
}

RichText وMediaPlaceholder

يعمل مكوّنا القالب الآن داخل حقول التكرار، مع استخدام تدوين الأقواس المربعة لاستهداف الصف الصحيح. يمكنك تحرير العناوين والفقرات ومناطق رفع الوسائط مباشرةً في كل صف من صفوف الحقل المتكرر.

Twig
{% for item in a.items %}
  <div class="card">
    <MediaPlaceholder attribute="items[{{ loop.index0 }}].image" />
    <RichText tag="h2" attribute="items[{{ loop.index0 }}].heading" />
    <RichText tag="p" attribute="items[{{ loop.index0 }}].content" />
  </div>
{% endfor %}

شروط الحقول المخصصة باستخدام idStructure

عند استخدام حقل مخصص مع idStructure، تُعاد كتابة معرّفات الشروط ضمن تعريف الحقل تلقائيًا لتطابق الأسماء الموسعة. إذا كانت مجموعة حقول حجم الخط مشروطة بـ enable، ووسّعتها باستخدام idStructure: "title_font_{id}"، فسيشير الشرط الآن إلى title_font_enable على نحو صحيح بدلًا من enable الأصلي.

تتوفر أيضًا الشروط على مستوى المرجع. أضف conditions إلى مرجع الحقل المخصص لتطبيقها على كل حقل موسع دفعة واحدة.

وسيطات التعبئة الديناميكية

يمكن لوسيطات التعبئة الآن الإشارة إلى سمات كتل أخرى باستخدام صياغة {attributes.*}. عند تغير السمة المشار إليها، يعيد حقل التحديد جلب خياراته تلقائيًا. اربط حقول التحديد معًا: أحدها لاختيار نوع المنشور، والآخر لتحميل المنشورات من ذلك النوع.

JSON
{
  "id": "selected_post",
  "type": "select",
  "populate": {
    "type": "query",
    "query": "posts",
    "arguments": {
      "post_type": "{attributes.post_type}"
    }
  }
}

غيّر post_type إلى “page” لتحميل الصفحات في حقل التحديد الثاني. وغيّره إلى “post” لتحميل المنشورات. يعمل ذلك مع أي نوع تعبئة وأي سمة.

Composer

يعمل Blockstudio الآن عند تحميله من أي مكان ضمن wp-content/، وليس من مجلد الإضافات فقط. تُحل عناوين URL للأصول عبر ثابت BLOCKSTUDIO_URL بدلًا من plugins_url()، لذا تعمل التثبيتات المضمنة في السمات مباشرةً:

PHP
require_once __DIR__ . '/vendor/autoload.php';
require_once __DIR__ . '/vendor/blockstudio/blockstudio/blockstudio.php';

نُظّفت الاعتماديات وقت التشغيل في composer.json. لم تعد الحزم ذات النطاقات (TailwindPHP وScssPhp وMinify) المضمنة أصلًا في lib/ مدرجة كاعتماديات وقت التشغيل. لم يبقَ سوى php >= 8.2 وplugin-update-checker.

تبدأ طرق التثبيت الثلاث كلها (ملف zip للإضافة، والإضافة عبر Composer، والتضمين في السمة عبر Composer) بالنتيجة نفسها: تفعيل WordPress بالكامل، وتسجيل الكتل، وعرض الواجهة الأمامية.

راجع توثيق Composer للاطلاع على تعليمات الإعداد.

محلل الأداء

أضف ?blockstudio-perf إلى أي صفحة URL، وستظهر لوحة تصحيح أخطاء في الأسفل تعرض أوقات عرض كل كتلة، وتقسيم المراحل، ومعدلات إصابة الذاكرة المؤقتة. تُرسل بيانات التوقيت أيضًا في رؤوس Server-Timing، ويمكن رؤيتها في علامة تبويب الشبكة ضمن DevTools في المتصفح.

JSON
{ "dev": { "perf": true } }

فعّله بشكل دائم عبر الإعدادات لتحليل كل تحميل للصفحات. لا يظهر إلا للمستخدمين الذين سجلوا الدخول ولديهم صلاحية edit_posts.

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

إصلاحات الأخطاء

  • تحذيرات الإهمال في PHP 8.4: أُصلحت تحذيرات الإهمال الخاصة بـ strpos() وstr_replace()، الناتجة عن تمرير null إلى add_submenu_page().

المزيد

  • حقول الشفرة SCSS: تدعم حقول الشفرة language: "scss". وتُجمّع القيم عبر ScssPhp في المحرر والواجهة الأمامية.
  • كتل WordPress القياسية: يمكن أن تحتوي مجلدات Blockstudio على مخرجات @wordpress/create-block إلى جانب كتل Blockstudio. وتُسجّل تلقائيًا دون الحاجة إلى شفرة إضافة منفصلة.

إذا أردت رؤية النمط المتكامل أثناء العمل، يشرح دليل الكتل المتكاملة بناء تطبيق قائمة مهام خاص بكل مستخدم ونموذج اشتراك عام في نشرة إخبارية من الصفر.