Цели страници, дефинирани в код
Шаблони и Markdown, синхронизирани с WordPress с една команда.
Колекции от файлове
Дефинирайте pages.json и оставете Blockstudio да открие всеки изходен файл под него. Вложените пътища стават вложени страници, колекцията получава зададените стойности по подразбиране, а липсващите родителски страници могат да бъдат генерирани.
Използвайте колекции за документация, бази от знания или целеви страници, а външни папки добавяйте под префикс на пътя с loader.php.
Поставете layout.php или оформление за визуализатора, например layout.tsx, до pages.json, за да обгърнете всяка страница от колекцията в обща обвивка, със blockstudio_page_tree() за страничната лента.
{
"collection": "docs",
"title": "Documentation",
"postType": "bs_docs",
"defaults": {
"postStatus": "publish",
"templateLock": "contentOnly"
}
}---
title: Installation
order: 10
---
# Installation
Install Blockstudio from this Markdown page.<?php $current = blockstudio_current_page(); ?>
<main class="docs-layout">
<aside>
<?php foreach (blockstudio_page_tree('docs') as $item) : ?>
<?php $is_current = ($item['post_id'] ?? null) === ($current['post_id'] ?? null); ?>
<a
href="<?php echo esc_url($item['permalink'] ?? '#'); ?>"
<?php echo $is_current ? 'aria-current="page"' : ''; ?>
>
<?php echo esc_html($item['title']); ?>
</a>
<?php endforeach; ?>
</aside>
<article>
<?php echo blockstudio_page_content(); ?>
</article>
</main>Изрична синхронизация
wp bs pages sync прилага промените; непроменените страници не изискват никакви записи.
Източници Markdown
Използвайте index.md с frontmatter или съчетайте page.json със съдържание Markdown.
Суров Markdown
Markdown файловите страници отговарят на адреса си с добавено .md или на обичайния URL при Accept: text/markdown, с канонична връзка обратно към HTML чрез URL.
Зареждащи модули за колекции
Добавяйте външни папки с документация към колекция под префикс на пътя.
Колекции от сайтове
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.
<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, и loader data.php; тогава визуализаторът на страници, регистриран от темата или плъгина ви, изобразява цялата страница. Синхронизацията съхранява един блок blockstudio/page, а съдържание WordPress, например shortcode, остава в своя слот.
Ресурсите, върнати от визуализатора, преминават през същата обработка като ресурсите на блоковете и се отпечатват само веднъж, така че предварително визуализираната страница ги съдържа. Самата blockstudio.dev е изградена от страници на компоненти.
{
"name": "legal-notice",
"title": "Legal Notice",
"slug": "legal-notice",
"postStatus": "publish",
"render": { "entry": "page.tsx", "data": "data.php" }
}add_action(
'blockstudio/pages/renderers',
static function (): void {
Blockstudio\Page_Renderers::register(
'react',
array(
'extensions' => array( 'tsx' ),
'layouts' => array( 'layout.tsx' ),
'render' => 'my_theme_render_page',
)
);
}
);Маршрути без публикация
Blockstudio\Virtual_Routes::register() предоставя документ, зад който няма публикация, например справочник за компоненти или каталог. С prefix и match една регистрация обслужва цяла група URL адреси, а връщането на null оставя URL на WordPress.
Маршрутът се изобразява в изходния буфер на Blockstudio, така че блоковете му получават ресурсите си и изхода на Tailwind. Пътищата в urls се включват в компилациите за статично предварително визуализиране, а Virtual_Routes::urls() ги връща за карта на сайта.
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$report = Blockstudio\Pages::reconcile();
if (0 === $report['failed']) {
// Once the release is live and verified:
Blockstudio\Pages::store_successful_source_identity(
$report['sourceIdentity']
);
}Блоковете с ключове запазват съдържанието
Добавете key към всеки блок. При следващата синхронизация блоковете с ключове обединяват атрибутите на шаблона със съществуващото потребителско съдържание, а блоковете без ключове се заменят.
Променяйте структурата между внедряванията, като запазвате съдържанието на клиентите.
<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>{
"name": "about",
"title": "About Us",
"slug": "about",
"templateLock": "contentOnly"
}Заключване на шаблони и режими на редактиране
"all" предотвратява промените, "contentOnly" заключва структурата, като позволява редактиране на текста, а "insert" позволява редактиране и пренареждане без добавяне или премахване на елементи.
Заменете всеки елемент с blockEditingMode, за да разрешите избирателно редактиране на заключена страница или да деактивирате отделен блок.
<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>{
"name": "landing",
"title": "Landing Page",
"slug": "landing",
"templateLock": "contentOnly",
"blockEditingMode": "contentOnly"
}Шаблони на Site Editor от файлове
Добавете template.json и шаблон към templates/ или part.json към parts/, за да получи блоковата ви тема източници за wp_template и wp_template_part, базирани на файлове.
Те използват същия синтаксис като страниците. Персонализация в Site Editor продължава да има предимство, докато някой не я нулира; тогава отново се използва източникът от файла.
<block name="core/template-part" slug="header" />
<div>
<h1>Welcome</h1>
<block name="core/post-content" />
</div>
<block name="core/template-part" slug="footer" />{
"slug": "front-page",
"title": "Front Page",
"description": "Homepage template"
}{
"slug": "header",
"title": "Header",
"area": "header"
}Избрано съдържание от базата данни в git
wp bs content pull експортира публикации, термини, връзки и декларирани метаданни от разрешения списък в преносими файлове, а push ги прилага в друга среда. Декларираните препратки, родители и връзки към термини се пренасят като стабилни UID.
Публикациите, управлявани чрез синхронизиране на страници, могат да се обединят с includePageSyncManaged. Файловете им съдържат "bodyOwner": "page-sync", така че Content Sync прехвърля метаданните, докато синхронизирането на страници запазва основното съдържание.
{
"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"
}
}wp bs content pull --dry-run
wp bs content pull
wp bs content status
wp bs content push --dry-run
wp bs content push --prune --yesБлокове с ключове
Запазвайте потребителското съдържание, докато шаблоните се развиват.
Режими на редактиране
Задавайте стойности по подразбиране за страници и ги замествайте за отделни елементи.
Свързване на блокове
Свързвайте блокове с метаданните на публикация, за да се запази съдържанието при синхронизация.
Шаблони за типове публикации
templateFor задава началната структура от блокове за всяка нова публикация от даден тип.
Фиксирани ID на публикации
postId възстановява същото ID, когато дадена страница бъде изтрита и синхронизирана отново, така че менютата и връзките да продължат да работят.
Начални шаблони и заключвания
sync: false със Pages::force_sync() създава страница еднократно, която редакторите да управляват. Pages::lock() и unlock() изключват отделна страница от синхронизирането.
Персонализирани визуализатори на парсера
Филтрите за конструктор и визуализатор преобразуват таг на блок в масив от блокове на външен блок или променят начина, по който се записва основен блок.
Съотнасяне на елементи
Съотнесете елемент HTML към друг блок, изберете блока според атрибутите на елемента и насочете абзацния HTML към поле за съдържание.
Персонализирани пътища за откриване
Филтрите добавят коренови директории за страници, шаблони и шаблони на Site Editor, например от плъгин.
Логически източници за откриване
Предварителните прегледи, наслагванията и генерираните теми могат да предоставят на Blockstudio съставен списък с файлове вместо една папка на тема.
Стабилни препратки
Декларираните препратки към публикации, термини и прикачени файлове се преобразуват в преносими UID при изтегляне и се разрешават до локални ID при изпращане.
Състояние преди изпращане
wp bs content status отчита всяка единица като непроменена, ще бъде актуализирана, липсваща в базата данни, в конфликт, заключена или осиротяла и предупреждава за мета ключове, които изглеждат като тайни.
Проверени изпращания с ограничен обхват
Push проверява целия план преди запис и пропуска заключените единици. –dry-run показва плана, а –prune –yes премахва само единиците от този набор съдържание.
С контрол на версиите
Проследявайте файловете на страниците в Git и ги внедрявайте в различни среди.
PHP API
Достъпвайте програмно дървета, дъщерни елементи, метаданни, синхронизация, заключване и ID.
Официалният комплект за разширения
Премиум шаблони за сайтове, системни инструкции за AI и частна общност в Discord. Еднократна покупка, актуализации за цял живот.
- 500+ шаблона за сайтове
- Системни инструкции за AI
- Актуализации за целия период
- Частна общност на Discord