
وصل 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 الشيفرة، تحسنت قدرتها على إنشائها. إن قاعدة شيفرة مفتوحة ووثائق مفتوحة وملف [سياق الذكاء الاصطناعي](https://blockstudio.dev/ar/docs/dev/ai/) مُعد مسبقًا ويمكن لأي أداة استخدامه، هي الطريقة المثلى لبناء بيئة تطوير بمساعدة WordPress الذكاء الاصطناعي.

الإضافة كاملة متاحة على
[GitHub](https://github.com/inline0/blockstudio) ليستخدمها الجميع ويتفرعوا منها ويساهموا فيها. بلا مفاتيح ترخيص أو جدران دفع أو قيود على الميزات.

## الميزات الجديدة

### صفحات قائمة على الملفات

هذه إحدى أكبر الإضافات في الإصدار 7.0. يمكنك الآن تعريف صفحات WordPress كاملة كقوالب ملفات تُزامَن مع قاعدة البيانات كمحتوى كتل أصلي عند تشغيل API أو CLI لمزامنة الصفحات.

أنشئ مجلدًا يحتوي على `page.json` وملف قالب:

```json title="page.json"
{
  "name": "about",
  "title": "About Us",
  "slug": "about",
  "postStatus": "publish"
}
```

```php title="index.php"
<div class="about-page">
  <h1>About Us</h1>
  <p>Welcome to our site.</p>
</div>
```

شغّل `wp bs pages sync` ليحلل Blockstudio ملف HTML إلى كتل WordPress وينشئ الصفحة في قاعدة البيانات أو يحدّثها.

#### دمج الكتل باستخدام المفاتيح

عادةً ما تُستبدل تعديلات المستخدم عند مزامنة القوالب. تحل سمة `key` هذه المشكلة بالحفاظ على محتوى المستخدم عبر عمليات المزامنة:

```html title="index.php"
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>
```

تحتفظ الكتل ذات المفاتيح المطابقة بمحتواها الذي عدّله المستخدم عند تحديث القالب. أما الكتل التي بلا مفاتيح فتُستبدل بالكامل.

#### ارتباطات الكتل

بدلًا من المفاتيح، يمكنك استخدام [ارتباطات الكتلAPI](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-bindings/) في نواة WordPress لربط الكتل مباشرةً بالبيانات الوصفية للمنشورات. هذه ليست ميزة Blockstudio، بل هي WordPress API أصلية. يمرر Blockstudio ببساطة سمة `metadata` إلى ترميز الكتل المُنشأ. تُخزّن البيانات في البيانات الوصفية بدلًا من ترميز الكتل، لذا لا تمحو مزامنة القوالب تعديلات المستخدم مطلقًا. كما يمكن الاستعلام عن البيانات عبر `WP_Query` وتتوفر من خلال REST API.

```html title="index.php"
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
  Default Title
</h1>
```

يمكن استخدام النهجين معًا في القالب نفسه.

#### عناصر التحكم في التحرير

تدعم الصفحات `blockEditingMode` و`templateLock` للتحكم فيما يمكن للمستخدمين تعديله:

```json title="page.json"
{
  "name": "landing",
  "title": "Landing Page",
  "blockEditingMode": "contentOnly",
  "templateLock": "all"
}
```

يقفل هذا بنية الصفحة مع السماح للمستخدمين بتحرير النص والوسائط. ويمكن للعناصر الفردية تجاوز إعداد الصفحة عبر سمة `blockEditingMode` في القالب.

#### تثبيت الصفحات بمعرّفات المنشورات

استخدم `postId` لربط قالب صفحة بمنشور WordPress موجود، ما يمنع تكرار الصفحات ويضمن تحديث القالب للمنشور الصحيح دائمًا:

```json title="page.json"
{
  "name": "home",
  "title": "Home",
  "postId": 2
}
```

للاطلاع على التفاصيل كاملة، راجع [وثائق الصفحات](https://blockstudio.dev/ar/docs/pages-and-patterns/pages/).

### أنماط قائمة على الملفات

مثل الصفحات، يمكنك الآن تعريف أنماط الكتل كقوالب ملفات. اكتب النمط في HTML، وسيحلله Blockstudio إلى ترميز كتل ويسجله كنمط كتل أصلي في WordPress. تظهر الأنماط في أداة إدراج الكتل ويمكن للمستخدمين وضعها في أي مكان.

```json title="pattern.json"
{
  "name": "hero-section",
  "title": "Hero Section",
  "categories": ["featured"],
  "keywords": ["hero", "banner"]
}
```

```html title="index.php"
<div class="hero">
  <h1>Welcome</h1>
  <p>Get started today.</p>
</div>
```

على خلاف الصفحات، لا تنشئ الأنماط سجلات في قاعدة البيانات. بل تُسجل في الذاكرة عند تحميل كل صفحة. راجع [وثائق الأنماط](https://blockstudio.dev/ar/docs/pages-and-patterns/patterns/).

### محلل من HTML إلى الكتل

تعتمد الصفحات والأنماط على محلل HTML جديد يحوّل قوالب HTML القياسية إلى ترميز كتل WordPress. ويتعامل تلقائيًا مع كتل الحاويات (مثل المجموعات والأعمدة) والكتل الطرفية (مثل الفقرات والعناوين). يستخدم المحلل بنية عرض قائمة على السمات، ما يسهّل توسيعه لدعم أنواع كتل إضافية عبر مرشح `blockstudio/parser/renderers`:

```php title="functions.php"
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 );
```

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

```html title="index.php"
<block name="acme/hero" background="/hero.jpg">
  <h1>Welcome to our site</h1>
</block>
```

### التخزين

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

```json title="block.json"
{
  "id": "subtitle",
  "type": "text",
  "label": "Subtitle",
  "storage": {
    "type": "postMeta"
  }
}
```

عند تخزين القيم في البيانات الوصفية للمنشورات، يمكنك:

- الاستعلام عن المنشورات حسب قيم الحقول باستخدام `WP_Query` و`meta_query`
- الوصول إلى بيانات الحقول عبر REST API لإعدادات المواقع عديمة الواجهة
- مشاركة البيانات مع إضافات أخرى مثل أدوات SEO وطبقات التخزين المؤقت

يمكنك أيضًا تخزين القيم في جدول الخيارات لإعدادات عامة على مستوى الموقع:

```json title="block.json"
{
  "id": "phone",
  "type": "text",
  "label": "Phone Number",
  "storage": {
    "type": "option",
    "optionKey": "company_phone"
  }
}
```

راجع [وثائق التخزين](https://blockstudio.dev/ar/docs/blocks/storage/) للاطلاع على API كاملة.

### حقول مخصصة

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

أنشئ `field.json` في مجلد blockstudio:

```json title="fields/hero/field.json"
{
  "name": "hero",
  "title": "Hero Section",
  "attributes": [
    { "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
    { "id": "description", "type": "textarea", "label": "Description" }
  ]
}
```

ثم أشر إليه من أي كتلة باستخدام البادئة `custom/`:

```json title="block.json"
{
  "blockstudio": {
    "attributes": [
      { "type": "custom/hero", "idStructure": "hero_{id}" }
    ]
  }
}
```

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

راجع [وثائق الحقول المخصصة](https://blockstudio.dev/ar/docs/blocks/attributes/custom-fields/).

### Tailwind CSS v4

أُعيد بناء دعم Tailwind بالكامل من أجل v4. فبدلًا من التجميع على جانب العميل عبر CDN والحفظ على القرص عند حفظ المقالة (نهج v6)، يجمّع Blockstudio 7 Tailwind على جانب الخادم مع كل طلب للواجهة الأمامية عبر [TailwindPHP](https://github.com/dnnsjsk/tailwindphp). لا حاجة إلى Node.js أو CLI أو خطوة بناء.

يستخدم التجميع تخزينًا مؤقتًا قائمًا على المرشحين: يستخرج Blockstudio جميع أسماء أصناف CSS من HTML النهائي، ويرتبها ويحسب تجزئتها مع إعداد CSS، ثم يتحقق من وجود ملف مخزّن مؤقتًا. تؤدي الأصناف نفسها إلى إصابة ذاكرة التخزين المؤقت نفسها، حتى عندما يتغير HTML المحيط بها (القيم العشوائية، والطوابع الزمنية، والمحتوى الديناميكي).

يستخدم الإعداد صياغة Tailwind v4 التي تبدأ بـ CSS. عرّف السمات المخصصة وأصناف الأدوات مباشرةً في `blockstudio.json` أو عبر مرشح `blockstudio/tailwind/css`:

```php title="functions.php"
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](https://blockstudio.dev/ar/docs/tailwind/) للاطلاع على الإعداد كاملًا.

### واجهة التفاعلية API

يدعم Blockstudio الآن [WordPress واجهة التفاعلية API](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/). فعّلها في block.json:

```json title="block.json"
{
  "blockstudio": {
    "interactivity": true
  }
}
```

أضف توجيهات `data-wp-*` إلى القالب:

```php title="index.php"
<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` يتضمن منطق المخزن:

```javascript title="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()` في الواجهة الأمامية.

راجع [وثائق التفاعلية](https://blockstudio.dev/ar/docs/blocks/interactivity/) للاطلاع على الإعداد كاملًا.

### تحليل محتوى SEO

كتل Blockstudio ديناميكية، لذا يكون محتوى حقولها غير مرئي لإضافات SEO افتراضيًا. يعالج Blockstudio 7 هذا الأمر بتكاملات تلقائية مع Yoast SEO وRank Math وSEOPress. تُستخرج القيم النصية من حقول `text` و`textarea` و`richtext` و`wysiwyg` و`link`، بما فيها صفوف المكررات المتداخلة، وتُمرر إلى تحليل المحتوى في كل إضافة. ويمكن الآن لإضافات SEO تحليل محتوى كتلّك على نحو سليم من حيث كثافة الكلمات المفتاحية وسهولة القراءة ومقاييس أخرى. لا حاجة إلى أي إعداد.

### الصفوف الافتراضية للحقول المكررة

تدعم حقول المكررات الآن خاصية `default` تتضمن مصفوفة من الصفوف المعبأة مسبقًا. عند إدراج كتلة، يُملأ حقل المكرر بالصفوف المحددة وقيمها، في المحرر والواجهة الأمامية:

```json title="block.json"
{
  "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` المخصصة وإعدادات القالب في المحرر
- **[ملف سياق الذكاء الاصطناعي](https://blockstudio.dev/ar/docs/dev/ai/)**: أُعيد بناء `blockstudio-llm.txt` كملف ثابت مُجمّع من وثائق v7 الكاملة ومخططات JSON المنقّحة من التكرار (نحو 48 ألف رمز)، ليحل محل الإنشاء الديناميكي من v6
- **نافذة منبثقة لحقل التعليمات البرمجية**: يمكن الآن فتح حقل التعليمات البرمجية في نافذة منفصلة، مع التراجع والإعادة بشكل مستقل وتمييز صياغة JavaScript
- **التجميع على جانب الخادم لـ Tailwind v4**: راجع قسم [Tailwind](#tailwind-css-v4) أعلاه
- **الإصدار 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](https://blockstudio.dev/ar/docs/dev/migration/v7/).

### أصبحت أسماء الخطافات تستخدم snake_case

أُعيدت تسمية جميع خطافات PHP من camelCase إلى snake_case، بما يتوافق مع اصطلاحات نواة WordPress:

```php title="functions.php"
// 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/`:

```javascript title="script.js"
// 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 وأنشئ أول كتلة لك في دقائق. اطّلع على [دليل البدء](https://blockstudio.dev/ar/docs/general/getting-started/) للحصول على شرح خطوة بخطوة، أو على [دليل الترحيل من v7](https://blockstudio.dev/ar/docs/dev/migration/v7/) إذا كنت تقوم بالترقية من v6.

المصدر كاملًا متاح على
[GitHub](https://github.com/inline0/blockstudio). نرحب بالبلاغات وطلبات السحب والملاحظات.
