
يركز الإصدار 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` إلى مجلد، فيصبح ذلك المجلد مجموعة:

```txt
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
```

```json title="pages/docs/pages.json"
{
  "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 المستقلة بيانات الواجهة:

```md title="pages/about/index.md"
---
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 محتوى الصفحة المتزامن بهذا التخطيط.

```php title="pages/docs/layout.php"
<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>
```

تتيح أدوات المساعدة الجديدة الوصول إلى المجموعة كبيانات منظمة:

```php
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 title="pages/docs/loader.php"
<?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`.

[اقرأ وثائق Pages](https://blockstudio.dev/ar/docs/pages-and-patterns/pages/)

## مزامنة المحتوى

يقدم الإصدار 7.4 أيضًا مزامنة المحتوى، وهي سير عمل في WP-CLI للفرق التي تريد تمثيل مزيد من مشروع WordPress على هيئة ملفات.

```bash
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 القابلة للنقل، وبيانات مرفقات الملفات، وعمليات التشغيل التجريبي، ومعالجة الحذف، والكيانات المقفلة، وتقارير الحالة. أما التقاط تعريفات التصنيفات ونسخ ملفات الوسائط وإعادة كتابة معرّفات ترميز الكتل، فقد استُبعدت عمدًا من هذا الإصدار الأول.

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

[اقرأ وثائق مزامنة المحتوى](https://blockstudio.dev/ar/docs/content-sync/)

### مزامنة أكثر موثوقية

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

يتعامل مسار الصفحات أيضًا مع التفاصيل التي تجعل الوثائق المعتمدة على الملفات عملية في المشاريع الحقيقية:

- تُزامن مصادر صفحات Markdown كمحتوى كتل أصلي، بما في ذلك سمات الكتل
- تتوفر البيانات الوصفية للواجهة لمساعدات الواجهة الأمامية والتخطيطات
- تحتفظ صفحات المجموعات بهوية مستقرة عبر عمليات المزامنة
- ترتبط الصفحات المتداخلة غير التابعة لمجموعات بصفحتها الأم
- يمكن للصفحات المتداخلة غير التابعة لمجموعات أن ترث أقرب `layout.php` من الأسلاف
- تنظف مصادر المجموعات المحذوفة صفحات WordPress التي أنشأتها
- يؤدي تغيير المجموعة من `page` إلى نوع مقالة مخصص إلى ترحيل المقالات المتزامنة الموجودة بدلًا من إنشاء نسخ مكررة
- يُحفَظ ترتيب الصفحات عبر `menu_order`

## بادئات وسوم الكتل

تدعم وسوم الكتل الآن بادئات قابلة للتهيئة لمساحات الأسماء. ويمكن للمشروع تسجيل بادئة قصيرة واحدة وترك Blockstudio يحل الكتلة ضمن مساحة أسماء واحدة أو أكثر:

```php
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` الصريحة لها الأولوية عندما يحتاج المشروع إلى تجاوز لمرة واحدة. وتُترك الوسوم ذات البادئات غير المعروفة دون تغيير، كما تظل مرشحات السماح والمنع الحالية لوسوم الكتل سارية على الكتل التي تُحل عبر البادئات.

[اقرأ وثائق Block Tags](https://blockstudio.dev/ar/docs/blocks/rendering/#prefix-shorthands)

## إصلاحات وقت التشغيل والمحرر

يتضمن الإصدار 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 ببساطة حفظ مزيد من عناصر المشروع، من بنيات صفحاته ومحتواه المنتقى، في تلك الملفات ونقلها معها.
