إنشاء صفحات قائمة على الملفات
يحدث إنشاء صفحات WordPress التقليدي داخل محرر الكتل: سحب الكتل وضبط الإعدادات والنقر على حفظ. يناسب ذلك العملاء الذين ينشئون صفحاتهم بأنفسهم، لكنه يسبب مشكلات للمطورين الذين ينشئون صفحات منظمة وخاضعة للتحكم في الإصدارات. فتخطيط الصفحة موجود في قاعدة البيانات، لا في الشفرة. ولا يمكنك مراجعته في طلب سحب، أو التراجع عنه باستخدام git، أو إعادة إنتاجه على تثبيت جديد.
تحل الصفحات القائمة على الملفات في Blockstudio هذه المشكلة. تعرّف الصفحات كملفات في سمة موقعك، واكتب قوالب HTML تتحول إلى كتل WordPress، وتحكم بدقة فيما يمكن للعملاء تعديله وما لا يمكنهم تعديله. يزامن أمر صريح هذه الملفات مع منشورات WordPress العادية، وتظل قوالبك مصدر الحقيقة.
يشرح هذا الدليل إنشاء الصفحات من البداية، مع التركيز بعمق على عناصر التحكم في القفل والتحرير التي تجعل الصفحات القائمة على الملفات عملية لمشاريع العملاء.
صفحتك الأولى
أنشئ مجلد pages في سمة موقعك، ثم أضف مجلدًا فرعيًا يضم ملفين:
theme/
└── pages/
└── about/
├── page.json
└── index.php
{
"name": "about",
"title": "About Us",
"postStatus": "publish"
}
<h1>About Us</h1>
<p>We build things for the web.</p>
شغّل أمر مزامنة الصفحات:
wp bs pages sync
يحلل Blockstudio ملف HTML إلى كتل WordPress وينشئ صفحة بعنوان
“About Us” وبالمعرّف المختصر about. افتحها في المحرر وسترى عنوانًا
وفقرة، تمامًا كما لو أضفتهما يدويًا.
عدّل index.php، وغيّر النص، ثم شغّل الأمر مجددًا. أعد تحميل المحرر
لرؤية التحديث. هذه هي الدورة الأساسية: اكتب HTML، ثم زامن عمدًا، واحصل على
الكتل.
لغة القوالب
يحوّل محلل HTML في Blockstudio عناصر HTML القياسية إلى كتل WordPress. اكتب <p> لتحصل على كتلة فقرة، واكتب <h2> لتحصل على كتلة عنوان. الربط واضح:
| HTML | الكتلة |
|---|---|
<p> |
فقرة |
من <h1> إلى <h6> |
عنوان (يتوافق المستوى مع الوسم) |
<ul>، <ol> |
قائمة |
<blockquote> |
اقتباس |
<img> |
صورة |
<div>، <section> |
مجموعة |
<hr> |
فاصل |
<details> |
تفاصيل |
<table> |
جدول |
بالنسبة إلى الكتل التي لا يقابلها عنصر HTML مباشرة، استخدم العنصر <block> مع السمة name:
<block name="core/cover" url="https://example.com/hero.jpg">
<h2>Hero Title</h2>
<p>Content over the background image.</p>
</block>
<block name="core/spacer" height="80px" />
<block name="core/buttons">
<block name="core/button" url="/contact">Get in Touch</block>
<block name="core/button" url="/work">See Our Work</block>
</block>
تُمرر السمات الموجودة على عناصر <block> إلى سمات الكتلة. وتُحوّل القيم تلقائيًا: يصبح "true" قيمة منطقية، ويصبح "3" عددًا صحيحًا، وتُفك ترميز السلاسل JSON مثل '{"type":"flex"}' إلى كائنات.
التخطيطات
تدعم المجموعات أوضاع تخطيط مختلفة باستخدام السمة layout:
<!-- Default group (stacked) -->
<div>
<p>Stacked by default.</p>
</div>
<!-- Row (horizontal flex) -->
<block name="core/group" layout='{"type":"flex","flexWrap":"nowrap"}'>
<p>Side</p>
<p>by side</p>
</block>
<!-- Stack (vertical flex) -->
<block name="core/group" layout='{"type":"flex","orientation":"vertical"}'>
<p>Stacked</p>
<p>with flex</p>
</block>
<!-- Columns -->
<block name="core/columns">
<block name="core/column">
<p>Left column.</p>
</block>
<block name="core/column">
<p>Right column.</p>
</block>
</block>
الكتل المخصصة
تعمل صيغة <block> مع أي كتلة مسجلة، بما في ذلك كتل Blockstudio الخاصة بك:
<block name="my-theme/hero" title="Welcome" background="dark" />
<block name="my-theme/testimonial" quote="Great product." author="Jane" />
تُربط السمات تلقائيًا بقيم حقل Blockstudio في الكتلة.
إنشاء صفحة هبوط
إليك صفحة هبوط كاملة تستخدم الكتل الأساسية للبنية والتخطيط:
{
"name": "landing",
"title": "Landing Page",
"slug": "landing",
"postStatus": "publish",
"templateLock": "all"
}
<block name="core/cover" url="https://images.unsplash.com/photo-1497366216548-37526070297c?w=1600">
<h1>Build faster with Blockstudio</h1>
<p>File-based blocks. Zero build step. Full editor integration.</p>
<block name="core/buttons">
<block name="core/button" url="/get-started">Get Started</block>
<block name="core/button" url="/docs">Documentation</block>
</block>
</block>
<div>
<h2>Why developers love it</h2>
<block name="core/columns">
<block name="core/column">
<h3>No build step</h3>
<p>Write PHP, CSS, and JavaScript. No webpack, no bundler, no transpiler.</p>
</block>
<block name="core/column">
<h3>File-based</h3>
<p>Every block is a folder. Every page is a template. Version control everything.</p>
</block>
<block name="core/column">
<h3>Full editor support</h3>
<p>Fields, previews, and InnerBlocks work in the block editor out of the box.</p>
</block>
</block>
</div>
<block name="core/media-text" mediaurl="https://images.unsplash.com/photo-1460925895917-afdab827c52f?w=800" mediatype="image">
<h2>Ship entire sites from your IDE</h2>
<p>Define pages, blocks, and patterns as files. Blockstudio handles the rest.</p>
</block>
<div>
<h2>Frequently asked questions</h2>
<details>
<summary>Do I need to learn React?</summary>
<p>No. Templates are PHP. Fields are JSON. Interactivity is optional.</p>
</details>
<details>
<summary>Does it work with my existing theme?</summary>
<p>Yes. Drop a blockstudio folder into any theme and start creating blocks.</p>
</details>
</div>
<div>
<block name="core/buttons">
<block name="core/button" url="/get-started">Start Building</block>
</block>
</div>
تضم هذه الصفحة واجهة رئيسية للغلاف، وشبكة ميزات من ثلاثة أعمدة، وقسمًا للوسائط والنص، وأقسام أسئلة شائعة قابلة للطي، ودعوة إلى إجراء. كل ذلك في ملف HTML واحد. تعني templateLock: "all" في page.json أن العميل لا يستطيع تغيير أي شيء. يشرح القسم التالي كيفية إتاحة مزيد من التعديل.
التحكم في المحرر
هنا تظهر القوة الحقيقية للصفحات القائمة على الملفات. يمنحك Blockstudio عنصرَي تحكم مستقلين: قفل القالب ووضع تحرير الكتل. ويتيحان لك تحديد أجزاء الصفحة التي يمكن للعملاء تعديلها بدقة. اقفل البنية مع السماح لهم بتحرير النص. جمّد بعض الأقسام واترك أقسامًا أخرى مفتوحة بالكامل. أنشئ صفحة لا يستطيع العميل فيها سوى الكتابة داخل ثلاثة عناوين محددة.
قفل القالب
تتحكم الخاصية templateLock في page.json بالتحرير البنيوي: أي إمكانية إضافة الكتل أو إزالتها أو إعادة ترتيبها.
"all" (الافتراضي)
{
"name": "terms",
"templateLock": "all"
}
أشد أنواع القفل صرامة. لا يمكن للعملاء إضافة الكتل أو إزالتها أو نقلها، كما لا يمكنهم تعديل محتواها (إلا عند دمجه مع blockEditingMode). وهذا هو الإعداد الافتراضي عند عدم تحديد قيمة.
متى يُستخدم: الصفحات القانونية، وشروط الخدمة، وسياسات الخصوصية. أي صفحة ينبغي ألا يتغير محتواها إلا عبر الشفرة.
"insert"
{
"name": "about",
"templateLock": "insert"
}
لا يمكن للعملاء إضافة الكتل أو إزالتها، لكن يمكنهم نقل الكتل الموجودة وتعديل محتواها. يظل عدد الكتل ثابتًا، لكن ترتيبها قابل للتغيير.
متى يُستخدم: الصفحات التي تريد فيها مجموعة أقسام ثابتة مع السماح للعميل بإعادة ترتيبها. مثل صفحة أعمال يظل فيها عدد الأقسام محددًا مسبقًا، بينما يختار العميل ترتيبها.
"contentOnly"
{
"name": "homepage",
"templateLock": "contentOnly"
}
يمكن للعملاء تحرير النص، لكن لا يمكنهم إضافة الكتل أو إزالتها أو نقلها. والفرق عن "all" هو أن "all" يمنع أيضًا تحرير المحتوى، بينما يسمح "contentOnly" به صراحةً.
متى يُستخدم: الخيار الأكثر شيوعًا للصفحات الموجهة للعملاء. يتحكم المطور في التخطيط، ويملأ العميل النص.
false
{
"name": "blog",
"templateLock": false
}
من دون أي قفل. يتمتع العملاء بتحكم كامل: يمكنهم إضافة أي كتلة أو إزالتها أو نقلها أو تعديلها. يوفر القالب بنية أولية، لكن الصفحة تصبح بعد ذلك تحت تصرف العميل.
متى يُستخدم: صفحات فهرس المدونة، وصفحات المحتوى الحرة، أو أي صفحة ينبغي أن يتمتع فيها العميل بحرية تحرير كاملة.
وضع تحرير الكتل
يتحكم templateLock في البنية (الإضافة والإزالة والنقل)، بينما يتحكم blockEditingMode في التفاعل مع كل كتلة على حدة: أي إمكانية تحديد الكتل أو ضبطها أو تحريرها.
عيّن قيمة افتراضية على مستوى الصفحة في page.json:
{
"name": "landing",
"templateLock": "all",
"blockEditingMode": "disabled"
}
"default"
تحرير كامل. يمكن تحديد الكتل وتغيير إعداداتها وتحرير محتواها. هذه هي تجربة المحرر المعتادة.
"contentOnly"
الكتل قابلة للتحرير، لكن محتواها النصي فقط. لا يمكنك فتح إعدادات الكتلة أو تغيير الألوان أو ضبط الحشو أو تعديل أي سمة أخرى غير المحتوى. يعرض شريط أدوات الكتلة خيارات تنسيق النص فقط.
"disabled"
الكتل غير تفاعلية تمامًا. تظهر في المحرر، لكن لا يمكن النقر عليها أو تحديدها أو تعديلها بأي شكل. يرى العميل المحتوى، لكنه لا يستطيع التفاعل معه.
تجاوزات لكل عنصر
هنا يبدأ الأمر بالتشويق. يعيّن blockEditingMode على مستوى الصفحة قيمة افتراضية لكل كتلة في الصفحة، لكن يمكنك تجاوزها لعناصر منفردة في القالب:
{
"name": "landing",
"templateLock": "all",
"blockEditingMode": "disabled"
}
<block name="core/cover" url="https://example.com/hero.jpg">
<h1 blockEditingMode="contentOnly">Edit This Heading</h1>
<p blockEditingMode="contentOnly">Edit this paragraph too.</p>
</block>
<div>
<h2>Features</h2>
<p>This paragraph cannot be edited (inherits "disabled").</p>
<p blockEditingMode="contentOnly">But this one can.</p>
</div>
<block name="core/buttons">
<block name="core/button" url="/contact">This button is frozen</block>
</block>
القيمة الافتراضية للصفحة هي "disabled"، لذا تبدأ كل كتلة بوضع غير تفاعلي. ثم تفعّل عناصر محددة "contentOnly"، لتصبح نصوصها وحدها قابلة للتحرير. والنتيجة صفحة يستطيع فيها العميل الكتابة في حقلي نص بالضبط (عنوان القسم الرئيسي وفقرة تحته) وفقرة ميزة واحدة. أما كل ما عدا ذلك فمقفل.
ينطبق هذا على أي عنصر من HTML (<h1>، <p>، <div>، وغيرها) وعلى عناصر <block>. ويمكنك أيضًا تعيين blockEditingMode="default" لعناصر محددة لمنحها صلاحية تحرير كاملة:
<block name="core/buttons" blockEditingMode="default">
<block name="core/button" url="/contact">Fully editable button</block>
</block>
يمكن للعميل الآن تغيير نص الزر وURL والأنماط وأي إعداد آخر. وتظل بقية الصفحة مجمدة.
تسلسل الوراثة من العناصر السلف
هناك تفصيل مهم حول تفاعل التجاوزات لكل عنصر مع كتل الحاويات. إذا كانت القيمة الافتراضية للصفحة هي "disabled" وعيّنت blockEditingMode="contentOnly" لعنوان داخل مجموعة، فيجب أن يكون الوصول إلى العنوان ممكنًا. لكن مجموعته الأصلية هي "disabled"، ما يعني تعذّر الدخول إليها أصلًا.
يتولى Blockstudio ذلك تلقائيًا. عندما يكون لكتلة فرعية تجاوز لوضع التحرير، تُضبط جميع كتلها السلف على "contentOnly" ليظل الوصول إلى الكتلة الفرعية ممكنًا. لا تحتاج إلى ضبط الأوضاع يدويًا على الحاويات الأصلية. ما عليك سوى تعيين التجاوز للكتلة التي تريد جعلها قابلة للتحرير، وسيفتح المسار إليها.
<!-- page default: "disabled" -->
<div>
<!-- this group is auto-set to "contentOnly" because it contains an override -->
<div>
<!-- this group is also auto-set to "contentOnly" -->
<p blockEditingMode="contentOnly">Deeply nested but still editable.</p>
</div>
</div>
يرفع تسلسل الوراثة من العناصر السلف الحاويات إلى "contentOnly" فقط، ولا يرفعها أبدًا إلى "default". وهذا يعني أن مجموعات العناصر السلف تصبح قابلة للتنقل (يمكنك الدخول إليها)، لكنها لا تصبح قابلة للتحرير بالكامل (لا يمكنك تغيير إعداداتها).
مصفوفة الخيارات
يمنحك الجمع بين templateLock وblockEditingMode طيفًا من مستويات التحكم. إليك أكثر التركيبات فائدة:
يتحكم المطور في كل شيء
{ "templateLock": "all" }
لا حاجة إلى blockEditingMode. تمنع القيمة الافتراضية templateLock: "all" جميع التغييرات. استخدم هذا للصفحات التي تُدار بالكامل عبر الكود.
يحرر العميل كل النصوص
{ "templateLock": "contentOnly" }
يمكن للعميل تحرير النص في أي كتلة، لكن لا يمكنه تغيير بنية الصفحة. خيار بسيط ومرن.
يحرر العميل نصوصًا محددة فقط
{
"templateLock": "all",
"blockEditingMode": "disabled"
}
يُستخدم مع blockEditingMode="contentOnly" على عناصر محددة في القالب. هذا هو الخيار الأدق: لا يستطيع العميل تحرير سوى الكتل التي تحددها بالضبط.
يعيد العميل ترتيب الأقسام الثابتة
{ "templateLock": "insert" }
يمكن للعميل إعادة ترتيب الأقسام وتحرير المحتوى، لكن لا يمكنه إضافة كتل أو حذفها. مناسب للصفحات التي تضم مجموعة ثابتة من الأقسام يمكن ترتيبها بمرونة.
يتمتع العميل بالتحكم الكامل
{ "templateLock": false }
القالب نقطة انطلاق، ويمكن للعميل فعل أي شيء بعد ذلك.
الحفاظ على تعديلات العميل
افتراضيًا، عند تحديث ملف قالب، يستبدل Blockstudio محتوى الصفحة بالكامل. فإذا حرر العميل عنوانًا في المحرر، يختفي هذا التعديل بعد المزامنة التالية. وهذا مناسب للصفحات التي يتحكم فيها المطور، لكن الصفحات التي يساهم العملاء في محتواها تحتاج إلى طريقة للحفاظ على عملهم.
المفاتيح
أضف سمة key إلى أي عنصر لتمييزه كي يُدمج بدلًا من استبداله:
<block name="core/cover" key="hero" url="https://example.com/hero.jpg">
<h1>Default Hero Title</h1>
<p>Default hero description.</p>
</block>
<div key="features">
<h2>Features</h2>
<p>Feature introduction text.</p>
</div>
<div>
<h2>Unkeyed Section</h2>
<p>This gets replaced on every sync.</p>
</div>
عندما يتغير القالب وتُعاد مزامنة الصفحة:
- تحتفظ الكتل ذات المفاتيح بمحتوى العميل (النص والكتل الداخلية والتنسيق). وتظل سمات القالب البنيوية (مثل
urlللغلاف) تُحدّث. - تُستبدل الكتل بلا مفاتيح بالكامل بنسخة القالب.
يحمي المفتاح الكتلة بأكملها وجميع عناصرها الفرعية. لا تحتاج إلى تعيين مفاتيح للفقرات الفردية داخل مجموعة ذات مفتاح؛ فمفتاح المجموعة يحمي كل ما بداخلها.
يجب أن تكون المفاتيح فريدة
يجب أن تكون المفاتيح فريدة على مستوى القالب بأكمله. إذا اشترك عنصران في المفتاح نفسه، فسيُعامل العنصر الثاني على أنه بلا مفتاح (ويصدر تحذير PHP). استخدم أسماء وصفية: "hero"، "features"، "cta"، "testimonial-section".
تطوير القوالب
تتيح لك المفاتيح إضافة أقسام جديدة إلى القالب دون المساس بمحتوى العميل الحالي:
<h1 key="title">Welcome</h1>
<div key="services">
<h2>Our Services</h2>
<p>We do great work.</p>
</div>
<h1 key="title">Welcome</h1>
<div key="services">
<h2>Our Services</h2>
<p>We do great work.</p>
</div>
<div key="testimonials">
<h2>What Clients Say</h2>
<p>Default testimonial text.</p>
</div>
عند المزامنة، يحتفظ العنوان والخدمات بتعديلات العميل. ويظهر قسم الشهادات الجديد بمحتوى القالب الافتراضي. وإذا أزلت لاحقًا كتلة ذات مفتاح من القالب، فستُحذف من الصفحة.
سير عمل العميل بالكامل
إليك كيفية جمع كل ذلك في مشروع حقيقي:
{
"name": "homepage",
"title": "Home",
"slug": "home",
"postStatus": "publish",
"templateLock": "all",
"blockEditingMode": "disabled"
}
<block name="core/cover" key="hero" url="https://example.com/hero.jpg">
<h1 blockEditingMode="contentOnly">Your Company Name</h1>
<p blockEditingMode="contentOnly">Your tagline goes here.</p>
<block name="core/buttons">
<block name="core/button" url="/contact">Contact Us</block>
</block>
</block>
<div key="features">
<h2 blockEditingMode="contentOnly">What We Do</h2>
<block name="core/columns">
<block name="core/column">
<h3 blockEditingMode="contentOnly">Service One</h3>
<p blockEditingMode="contentOnly">Describe this service.</p>
</block>
<block name="core/column">
<h3 blockEditingMode="contentOnly">Service Two</h3>
<p blockEditingMode="contentOnly">Describe this service.</p>
</block>
<block name="core/column">
<h3 blockEditingMode="contentOnly">Service Three</h3>
<p blockEditingMode="contentOnly">Describe this service.</p>
</block>
</block>
</div>
<block name="core/media-text" key="about" mediaurl="https://example.com/team.jpg" mediatype="image">
<h2 blockEditingMode="contentOnly">About Us</h2>
<p blockEditingMode="contentOnly">Tell your story here.</p>
</block>
<div key="cta">
<h2 blockEditingMode="contentOnly">Ready to get started?</h2>
<block name="core/buttons">
<block name="core/button" url="/contact">Get in Touch</block>
</block>
</div>
تحتوي هذه الصفحة على أربعة أقسام ذات مفاتيح. يستطيع العميل تحرير العناوين والفقرات المحددة بـblockEditingMode="contentOnly"، وتبقى تعديلاته محفوظة بعد تحديثات القالب. ويتحكم المطور في التخطيط والصور وعناوين URL للأزرار والبنية العامة. وإذا أضاف المطور لاحقًا قسمًا للشهادات بين «about» و«cta»، فسيظهر عند المزامنة التالية دون التأثير في أي نص للعميل.
ربط الكتل: بديل للمفاتيح
قدّم WordPress 6.5 ميزة ربط الكتل API، التي تربط سمات الكتل بالبيانات الوصفية للمنشور. بدلًا من تخزين المحتوى القابل للتحرير في ترميز الكتلة (حيث تحميه المفاتيح)، يُخزّن المحتوى في wp_postmeta (حيث لا تستطيع مزامنات القوالب المساس به).
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
Default Title
</h1>
<p metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_description"}}}}'>
Default description.
</p>
يجب تسجيل مفاتيح البيانات الوصفية في PHP:
register_post_meta( 'page', 'hero_title', array(
'show_in_rest' => true,
'single' => true,
'type' => 'string',
'default' => 'Default Title',
) );
لربط الكتل ميزتان على المفاتيح: يمكن الاستعلام عن البيانات باستخدام WP_Query عبر meta_query، كما تتاح في REST API. أما المقابل فهو ضرورة تسجيل كل مفتاح بيانات وصفية في PHP، وأن عمليات الربط لا تعمل إلا مع سمات الكتل الفردية (وليس المحتوى المتداخل المعقد).
استخدم المفاتيح لأقسام المحتوى الغني التي تهم فيها بنية الكتلة (مثل مجموعة تضم عناوين وفقرات وصورًا). واستخدم عمليات الربط للقيم النصية الفردية التي تحتاج أيضًا إلى الاستعلام عنها أو عرضها في مواضع أخرى.
قوالب أنواع المنشورات
استخدم templateFor لتعيين بنية كتلة افتراضية لكل المنشورات الجديدة من نوع محدد:
{
"name": "product-template",
"title": "Product Template",
"templateFor": "product",
"templateLock": "insert"
}
<h1>Product Name</h1>
<block name="core/columns">
<block name="core/column">
<img src="" alt="Product image" />
</block>
<block name="core/column">
<p>Product description goes here.</p>
<block name="core/buttons">
<block name="core/button" url="#">Buy Now</block>
</block>
</block>
</block>
<div>
<h2>Specifications</h2>
<table>
<thead>
<tr><th>Feature</th><th>Value</th></tr>
</thead>
<tbody>
<tr><td>Weight</td><td>1.2 kg</td></tr>
</tbody>
</table>
</div>
يبدأ كل منشور جديد من نوع «product» بهذه البنية. ويتيح templateLock: "insert" للمحررين إعادة ترتيب الأقسام وتحرير المحتوى، لكن لا يتيح لهم إضافة كتل أو إزالتها.
نصائح
زامن عند نقطة نشر مقصودة. شغّل wp bs pages sync بعد
تغيير مصادر الصفحة أو نشرها. لا تؤدي زيارات الواجهة الأمامية ولوحة الإدارة إلى مزامنة
الصفحات. ويمكن لأدوات النشر PHP استدعاء Blockstudio\Pages::reconcile()
وفحص تقريره القابل للقراءة آليًا.
ثبّت معرّفات المنشورات المهمة. استخدم postId في page.json للصفحات المشار إليها في القوائم أو الروابط الثابتة أو الأنظمة الخارجية. من دون التثبيت، تحصل الصفحة التي تُحذف ثم تُنشأ مجددًا على معرّف جديد، ما يؤدي إلى تعطّل تلك الإشارات.
استخدم sync: false للهياكل الأولية. إذا أردت إنشاء صفحة مرة واحدة ثم تسليمها بالكامل إلى العميل، فعيّن "sync": false وأنشئها باستخدام Blockstudio\Pages::force_sync(). عندئذ تتجاهلها التسوية العادية.
اقفل وافتح عبر PHP. استدعِ Blockstudio\Pages::lock('about') لمنع مزامنة صفحة محددة (وهو مفيد أثناء فترات تحرير العميل المكثفة). واستدعِ Blockstudio\Pages::unlock('about') لإعادة تفعيل المزامنة.
محركات القوالب. إلى جانب PHP، يمكن كتابة القوالب باستخدام Twig (يتطلب Timber) أو Blade (يتطلب illuminate/view). يفيد ذلك في الحلقات والمرشحات، لكن تُجمّع قوالب الصفحات أثناء المزامنة الصريحة، لا أثناء طلب الواجهة الأمامية. التزم بـPHP إذا كان تجميع المصدر نفسه يحتاج إلى مساعدات تقتصر على PHP.
تتجاهل المزامنة القسرية المفاتيح. يؤدي استدعاء Pages::force_sync('about') إلى استبدال محتوى الصفحة بالكامل، متجاهلًا المفاتيح وفحوصات وقت التعديل. استخدمه عندما تريد عمدًا إعادة الصفحة إلى حالة القالب.
الخطوات التالية
- مرجع الصفحات: جميع خصائص
page.json، وPHP API، وخوارزمية الدمج باستخدام المفاتيح بالتفصيل. - نظرة عامة على الصفحات والأنماط: محلل HTML ومرجع صياغة الكتل ومُصيّرات العرض المخصصة وربط العناصر.
- الأنماط: صياغة القوالب نفسها لأنماط الكتل القابلة لإعادة الاستخدام بدلًا من الصفحات.