# صفحات كاملة، معرّفة في الكود

القوالب وMarkdown، تتم مزامنتها مع WordPress بأمر واحد.

## مجموعات من الملفات

عرّف `pages.json` ودع Blockstudio يكتشف كل مصدر تحته. تتحول المسارات المتداخلة إلى صفحات متداخلة، وتُطبّق الإعدادات الافتراضية على المجموعة، ويمكن إنشاء الصفحات الأصلية المفقودة.

استخدم المجموعات للتوثيق أو قواعد المعرفة أو الصفحات الترويجية، وأضف المجلدات الخارجية تحت بادئة مسار باستخدام `loader.php`.

ضع `layout.php` أو تخطيط عرض مثل `layout.tsx` بجوار `pages.json` لإحاطة كل صفحة في المجموعة بهيكل واحد، مع `blockstudio_page_tree()` للشريط الجانبي.

[مجموعات الصفحات](https://blockstudio.dev/ar/docs/pages-and-patterns/pages/#page-collections)

pages/docs/pages.json

```
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}
```

## مزامنة صريحة

يطبّق wp bs pages sync التغييرات؛ ولا تستهلك الصفحات التي لم تتغير أي عمليات كتابة.

## مصادر Markdown

استخدم index.md مع البيانات التمهيدية، أو أقرن page.json بمحتوى Markdown.

## Markdown خام

تُعرض صفحات الملفات Markdown على URL مع إضافة .md، أو على URL المعتاد عند استخدام Accept: text/markdown، مع رابط أساسي يعود إلى HTML.

## محملات المجموعات

أضف مجلدات التوثيق الخارجية إلى مجموعة تحت بادئة مسار.

## مجموعات الموقع

يطبّق pages.json بنطاق site الإعدادات الافتراضية المشتركة على شجرة صفحات كاملة ويسردها، من دون تغيير عناوين URL أو صفوف المنشورات.

## مساعدات التنقل

تنشئ blockstudio_page_tree() و blockstudio_page_children() و blockstudio_current_page() و blockstudio_page_content() الأشرطة الجانبية وأدوات التنقل بين الصفحات والمتن.

## المجموعات وأنواع المنشورات

يمكن للمجموعات تسجيل أنواع منشورات هرمية مخصصة.

## قفل القالب

اقفل الصفحات أو الكتل المفردة باستخدام contentOnly أو all أو insert.

## اكتب HTML لتحصل على كتل

تُربط العناصر القياسية مثل `<h1>` و `<p>` و `<ul>` بالكتل الأساسية. استخدم `<block>` لأي اسم كتلة أو مستوى تداخل آخر.

يحلل Blockstudio تخطيطات الصفحات الكاملة إلى كتل WordPress حقيقية قابلة للتحرير.

[مرجع صياغة الصفحات](https://blockstudio.dev/ar/docs/pages-and-patterns/pages/)

index.php

```
<div>
  <h1 blockEditingMode="contentOnly">About Us</h1>
  <p>We build tools for WordPress developers.</p>
  <img src="/team.jpg" alt="Our team" />
</div>

<block name="core/columns">
  <block name="core/column"><h2>Our Mission</h2></block>
  <block name="core/column"><h2>Our Stack</h2></block>
</block>
```

## صفحات تعرضها المكوّنات

اضبط `render` في `page.json` على مُدخل مثل `page.tsx` وعلى مُحمّل `data.php`، وسيتولى عارض الصفحات الذي يسجّله قالبك أو ملحقك رسم الصفحة كاملة. يخزّن Sync كتلة `blockstudio/page` واحدة، ويبقى محتوى WordPress مثل الرمز القصير في موضعه.

تخضع الأصول التي يعيدها العارض للمعالجة نفسها التي تخضع لها أصول الكتل، وتُطبع مرة واحدة، لذا تحملها الصفحة المعروضة مسبقًا. يُبنى blockstudio.dev نفسه من صفحات المكوّنات.

[صفحات المكوّنات](https://blockstudio.dev/ar/docs/pages-and-patterns/pages/#component-pages)

pages/legal-notice/page.json

```
{
  "name": "legal-notice",
  "title": "Legal Notice",
  "slug": "legal-notice",
  "postStatus": "publish",
  "render": { "entry": "page.tsx", "data": "data.php" }
}
```

## مسارات بلا منشور

يقدّم `Blockstudio\Virtual_Routes::register()` مستندًا لا يستند إلى منشور، مثل مرجع للمكوّنات أو فهرس. وباستخدام `prefix` و `match`، يتولى تسجيل واحد خدمة مجموعة كاملة من عناوين URL، ويترك إرجاع `null` مهمة URL إلى WordPress.

يُعرض المسار داخل مخزن إخراج Blockstudio، فتحصل كتله على أصولها وإخراج Tailwind. وتُضاف المسارات في `urls` إلى عمليات البناء الثابتة للعرض المسبق، ويعيدها `Virtual_Routes::urls()` لإنشاء خريطة موقع.

[المسارات الافتراضية](https://blockstudio.dev/ar/docs/pages-and-patterns/pages/#virtual-routes)

functions.php

```
add_action( 'init', function () {
    Blockstudio\Virtual_Routes::register(
        'components',
        function ( $component, string $rest ) {
            get_header();
            echo my_component_page( $component );
            get_footer();
        },
        [
            'prefix' => true,
            'match'  => fn ( string $rest ) => '' === $rest ? 'index' : my_component( $rest ),
            'title'  => fn ( $component ) => my_component_title( $component ),
            'urls'   => fn () => my_component_paths(),
        ]
    );
} );
```

## زامن عندما تطلب ذلك

لا تتغير ملفات الصفحات في WordPress إلا بطلب منك. يطبّق `wp bs pages sync` كل مصدر تغيّر، ويحافظ على محتوى المحرر ذي المفاتيح، ويحذف الصفحات التي لم تعد ملفاتها موجودة.

تشمل بصمات الملفات البيانات الوصفية ومحملات الصفحات والتخطيطات والمصادر، لذا لا تستهلك الصفحات التي لم تتغير أي عمليات كتابة. تستدعي عمليات النشر `Pages::reconcile()` وتحصل على تقرير قابل للقراءة آليًا.

[سلوك المزامنة](https://blockstudio.dev/ar/docs/pages-and-patterns/pages/#sync-behavior)

الطرفية

```
# Apply changed sources, keep keyed edits
wp bs pages sync

# Replace managed content from the files
wp bs pages sync --authoritative

# Compare every page and report as JSON
wp bs pages sync --full --format=json
```

## الكتل ذات المفاتيح تحفظ المحتوى

أضف `key` إلى أي كتلة. في المزامنة التالية، تدمج الكتل ذات المفاتيح سمات القالب مع محتوى المستخدم الحالي، بينما تُستبدل الكتل بلا مفاتيح.

طوّر البنية عبر عمليات النشر مع الحفاظ على محتوى العملاء.

[كتل ذات مفاتيح](https://blockstudio.dev/ar/docs/pages-and-patterns/pages/#keyed-block-merging)

index.php

```
<h1 key="title">About Us</h1>
<block name="core/cover" key="hero" url="/hero.jpg">
  <h2>Welcome to our company</h2>
  <p>Edit this content freely.</p>
</block>
<block name="core/columns" key="team">
  <block name="core/column"><h3>Our Team</h3></block>
</block>
```

## قفل القوالب وأوضاع التحرير

يمنع `"all"` التغييرات، ويقفل `"contentOnly"` البنية مع السماح بتحرير النص، ويتيح `"insert"` التحرير وإعادة الترتيب دون إضافة عناصر أو حذفها.

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

[قفل القالب](https://blockstudio.dev/ar/docs/pages-and-patterns/pages/#template-lock)

index.php

```
<h1>Welcome to Our Product</h1>
<p>The best solution for your needs.</p>
<block name="core/cover" blockEditingMode="disabled" url="/static-banner.jpg">
  <p>Promotional banner</p>
</block>
<block name="core/group" blockEditingMode="default">
  <h2>Customizable Section</h2>
</block>
```

## قوالب محرر الموقع من الملفات

أضف `template.json` وقالبًا إلى `templates/`، أو `part.json` إلى `parts/`، وستحصل سمة الكتل على مصدري `wp_template` و `wp_template_part` مستندين إلى الملفات.

تستخدم هذه القوالب صياغة الصفحات نفسها. يظل تخصيص محرر الموقع هو المعتمد إلى أن يعيد أحدهم ضبطه، وعندها يعود المصدر من الملف.

[قوالب الموقع](https://blockstudio.dev/ar/docs/pages-and-patterns/site-templates/)

templates/front-page/index.php

```
<block name="core/template-part" slug="header" />

<div>
  <h1>Welcome</h1>
  <block name="core/post-content" />
</div>

<block name="core/template-part" slug="footer" />
```

## محتوى محدد من قاعدة البيانات في git

تصدّر مشاريع `wp bs content pull` المقالات والمصطلحات والعلاقات والبيانات الوصفية المعلنة المسموح بها إلى ملفات قابلة للنقل، ويطبّقها `push` في بيئة أخرى. تنتقل المراجع المعلنة والعناصر الأصلية وعلاقات المصطلحات على هيئة معرّفات UID ثابتة.

يمكن أن تنضم المنشورات التي تديرها مزامنة الصفحات إلى `includePageSyncManaged`. وتحمل ملفاتها `"bodyOwner": "page-sync"`، لذا تنقل Content Sync البيانات الوصفية بينما تُبقي مزامنة الصفحات المتن.

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

blockstudio.json

```
{
  "content": {
    "enabled": true,
    "id": "default",
    "path": "content",
    "postTypes": ["team_member"],
    "taxonomies": ["category"],
    "meta": {
      "include": ["_my_*"],
      "references": {
        "_thumbnail_id": { "kind": "attachment" },
        "_related_posts": { "kind": "post", "path": "*" }
      }
    },
    "media": "manifest"
  }
}
```

## كتل ذات مفاتيح

حافظ على محتوى المستخدم مع تطور القوالب.

## أوضاع التحرير

عيّن الإعدادات الافتراضية للصفحة وتجاوزها لعناصر محددة.

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

اربط الكتل بالبيانات الوصفية للمنشور كي يبقى المحتوى بعد المزامنة.

## قوالب أنواع المنشورات

يجعل templateFor الصفحة بنية الكتل الابتدائية لكل منشور جديد من نوع معيّن.

## معرّفات المنشورات المثبّتة

يعيد postId استخدام المعرّف نفسه عند حذف صفحة ومزامنتها مجددًا، لتظل القوائم والروابط تعمل.

## الهياكل الأولية والأقفال

ينشئ sync: false مع Pages::force_sync() صفحة مرة واحدة ليملكها المحررون. ويمنع Pages::lock() و unlock() مزامنة صفحة واحدة.

## عارضات المحلّل المخصصة

تحوّل مرشّحات أداة البناء والعارض وسم الكتلة إلى مصفوفة كتل لكتلة تابعة لجهة خارجية، أو تغيّر طريقة كتابة كتلة أساسية.

## ربط العناصر

اربط عنصر HTML بكتلة أخرى، واختر الكتلة من سمات العنصر، ووجّه HTML الفقرة إلى حقل محتوى.

## مسارات اكتشاف مخصصة

تضيف المرشّحات جذورًا للصفحات والأنماط وقوالب محرر الموقع، مثلًا من ملحق.

## مصادر اكتشاف منطقية

يمكن للمعاينات والتراكبات والقوالب المُنشأة تزويد Blockstudio بجرد ملفات مُركّب بدلًا من مجلد قالب واحد.

## مراجع ثابتة

تتحول مراجع المنشورات والمصطلحات والمرفقات المُعلنة إلى معرّفات UID محمولة عند السحب، وتُحلّ إلى معرّفات محلية عند الدفع.

## الحالة قبل الدفع

يعرض wp bs content status حالة كل كيان: دون تغيير أو سيُحدّث أو غير موجود في قاعدة البيانات أو متعارض أو مقفل أو يتيم، ويحذّر من مفاتيح البيانات الوصفية التي تبدو كأنها أسرار.

## عمليات دفع مُتحقّق منها ومحددة النطاق

يتحقق Push من الخطة كاملة قبل الكتابة ويتخطى الكيانات المقفلة. يعرض –dry-run الخطة، بينما يزيل –prune –yes كيانات مجموعة المحتوى هذه فقط.

## خاضعة للتحكم بالإصدارات

تتبّع ملفات الصفحات في Git وانشرها عبر البيئات.

## PHP API

يمكنك برمجيًا الوصول إلى الأشجار والعناصر الفرعية والبيانات الوصفية والمزامنة والقفل والمعرّفات.

Plus

## حزمة الإضافات الرسمية

قوالب مواقع مميزة، وتعليمات نظام للذكاء الاصطناعي، ومجتمع Discord خاص. شراء لمرة واحدة وتحديثات مدى الحياة.

- أكثر من 500+ قالب موقع
- تعليمات نظام الذكاء الاصطناعي
- تحديثات مدى الحياة
- مجتمع Discord خاص

[احصل على Plus](https://blockstudio.dev/ar/plus/)
