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

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

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

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

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

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

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

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 حقيقية قابلة للتحرير.

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 نفسه من صفحات المكوّنات.

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() لإنشاء خريطة موقع.

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() وتحصل على تقرير قابل للقراءة آليًا.

الطرفية
# 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 إلى أي كتلة. في المزامنة التالية، تدمج الكتل ذات المفاتيح سمات القالب مع محتوى المستخدم الحالي، بينما تُستبدل الكتل بلا مفاتيح.

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

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 لجعل صفحة مقفلة قابلة للتحرير جزئيًا أو تعطيل كتلة بعينها.

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 مستندين إلى الملفات.

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

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 البيانات الوصفية بينما تُبقي مزامنة الصفحات المتن.

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 خاص