Dennis · 23 юли 2026 г.
Blockstudio 7.5
Blockstudio 7.5 допълва файлово ориентирания работен процес на Blockstudio с персонализирани типове полета, шаблони на Site Editor във файлове, блокови острови, съхранение на базата данни Storh, логически източници за откриване, комбинируеми тагове на блокове и по-бързи пътища за внедряване и работа.
Повторно използваемите персонализирани полета вече позволяват на проектите да дефинират веднъж група от съществуващи полета и да я използват повторно с type: "custom/{name}". Персонализираните типове полета решават друг проблем. Те позволяват на тема или плъгин да регистрира нов тип поле с пространство от имена, да предостави собствена контрола за редактиране и да съхранява стойността като обикновени данни Blockstudio.
Накратко:
- Логически източници за откриване: средите за изпълнение могат да предоставят съставен логически опис на темата, включително произход и идентичност на кеша, докато Blockstudio запазва отговорността за откриването, намирането на съседни файлове, генерираните ресурси, Canvas и поведението на Tailwind.
- Регистър на типовете полета PHP: темите и разширенията могат да регистрират типове полета с пространство от имена, като
acme/dimensionsсbs_register_field_type()или филтъраblockstudio/field_types. - Регистър на контролите в редактора: персонализираните скриптове за редактора могат да извикват
window.blockstudio.registerFieldType()и да визуализират съответната контрола React в обичайното поле Blockstudio UI. - Структурирани стойности: персонализираните полета могат да съхраняват низове, числа, булеви стойности, масиви или обекти, без стойностите на обектите да се преобразуват чрез нормализиране на полетата с опции.
- Поддръжка на съхранение: персонализираните полета в метаданните на публикациите и тези, базирани на опции, могат да декларират типа на стойността си и схемата REST, включително стойности на обекти и масиви.
- Интеграция с платформата: персонализираните типове полета работят в групи, раздели, повтарящи се полета, повторно използваеми персонализирани полета, шаблони и пътища към шаблони на разширения.
- Шаблони за редактора на сайта: темите могат да определят източници
wp_templateиwp_template_partот файлове с шаблониtemplate.json,part.jsonи Blockstudio. - Изолирани блокове: блоковете могат първо да визуализират обвивка, безопасна за кеширане, а след зареждането на страницата да зареждат фрагменти за конкретната заявка или да ги извличат пакетно.
- Съхранение в база данни Storh:
bs.dbможе да използва индексирано хранилище с отделен файл за всеки запис в качените файлове, като запазва публичните целочислени идентификатори и миграцията от JSONC към Storh чрез WP-CLI. - Подобрения в анализатора и bsui: за абзаците с richtext, създадени чрез съпоставяне, е нужен по-малко персонализиран код за анализатора;
InnerBlocksможе да използва токенизиранallowedBlocks; изходът на вложенияbs_render_block()съвпада с визуализацията във фронтенда в предварителните прегледи на редактора; аbsui/buttonвече предлага икони и по-лесни възможности за стилизиране. - Комбинируеми тагове за блокове: таговете с префикс могат да се разрешават чрез друг префикс (
<theme-ui-input>къмbsui/input), а таговете с префикс и псевдоним се визуализират и в изхода на шаблоните за блокове, не само в съдържанието на страниците. - Кешове, независими от хоста: кешовете на средата за изпълнение и редактора вече по подразбиране са извън качените файлове, поддържат конфигурируеми местоположения и премахват остарелите записи, така че дългосрочните проекти да не трупат кеш файлове.
- Постепенно съгласуване на страниците: инструментите за внедряване могат да съгласуват пълния опис на страниците от файлове, да пропускат непроменените публикации, да посочват точно настъпилите промени и да запазват проверена идентичност на източника след активиране.
- По-бързо визуализиране при загрят кеш: валидните кешове на средата за изпълнение се зареждат преди откриването; едновременните заявки без кеш публикуват един атомарен резултат; а Tailwind поддържа кеш с размер за целия сайт и повторно използваемо състояние на компилатора.
- Безопасно пакетно визуализиране: инструментите за експортиране могат да нулират състоянието за визуализиране, ограничено до заявката, между документите, без да изграждат отново откриването, и да събират зависимостите от източниците по време на визуализирането на блоковете.
Нови функции
Версия 7.5 добавя широк набор от нови възможности за откриване, шаблони и съхранение.
Логически източници за откриване
Blockstudio обикновено открива файлове във физическите директории на темата. Във версия 7.5 се добавя източник от по-ниско ниво API за среди за изпълнение, които съставят тема от наслагвания, предварителни прегледи, генерирани файлове, отдалечени монтирания или други комбинирани описи.
Интеграцията може да предостави завършено логическо дърво на файловете, като Blockstudio запазва отговорността за поведението на блоковете, полетата, страниците, шаблоните, редактора на сайта, Canvas, ресурсите и Tailwind:
use Blockstudio\Inventory_Discovery_Source;
add_filter(
'blockstudio/discovery/sources',
function (array $sources, string $context): array {
if ('blocks' !== $context) {
return $sources;
}
return [
new Inventory_Discovery_Source(
'preview:feature-card',
'/runtime-preview/feature-card/blockstudio',
[
'card/block.json' => [
'path' => '/theme/blockstudio/card/block.json',
'provenance' => ['layer' => 'parent'],
],
'card/index.php' => [
'path' => '/runtime-preview/feature-card/blockstudio/card/index.php',
'provenance' => ['layer' => 'preview'],
],
],
'preview-fingerprint'
),
];
},
10,
2
);
Логическите пътища остават стабилни дори когато съседните файлове идват от различни физически корени. Идентификаторите и отпечатъците на източниците определят идентичностите на кешовете на средата за изпълнение и Tailwind; наблюдаваните входни данни ги инвалидизират, а произходът определя къде могат да се записват генерираните файлове. Файловата система остава източникът по подразбиране за обичайните теми.
Шаблони за редактора на сайта, базирани на файлове
Страниците и шаблоните вече позволяват на екипите да съхраняват структурите на съдържанието във файлове. Версия 7.5 разширява този модел и към самия редактор на сайта.
theme/
templates/
front-page/
template.json
index.php
parts/
header/
part.json
index.php
{
"slug": "front-page",
"title": "Front Page"
}
<div class="site-shell">
<block name="core/template-part" slug="header" />
<main>
<h1>Welcome</h1>
<block name="core/post-content" />
</main>
</div>
Blockstudio компилира източника със същия анализатор, който се използва за страниците и шаблоните, след което предоставя резултата на WordPress като обичаен шаблон или част от шаблон за редактора на сайта. Редакторът на сайта вижда шаблона, фронтендът може да го визуализира, а WordPress продължава да управлява персонализациите.
Последното е важно. Шаблоните, базирани на файлове, са резервният източник. Ако потребител запази шаблон в редактора на сайта, WordPress създава обичайна персонализация в базата данни от тип wp_template или wp_template_part и тази версия има предимство. Нулирайте персонализацията и отново ще се покаже най-новата версия от файла.
Постепенно внедряване на страници
Във версия 7.5 към страниците, базирани на файлове, е добавено съгласуване при внедряване API. От 7.6.2 насам единствените входни точки за синхронизиране са изричните API и wp bs pages sync; обикновените заявки никога не прилагат промени от източника:
$report = Blockstudio\Pages::reconcile([
'authoritative' => true,
'plan_valid' => true,
'source' => [
'commit' => $commit,
'dirtyHash' => $dirtyHash,
],
]);
Процесът открива пълния опис на желаните страници, сравнява съдържанието и отпечатъците на механизма за синхронизиране и отчита създадените, актуализираните, непроменените, премахнатите и неуспешните страници. При еднакви отпечатъци страниците не предизвикват запис на публикацията или нейните метаданни. Управляваните страници, които липсват, се премахват само ако откриването завърши без грешки.
Съгласуването връща детерминистична идентичност на източника, но не отбелязва внедряването като успешно. Инструментите за внедряване съхраняват тази идентичност едва след като съответните файлове и маршрути са активни и проверени. При обичайното зареждане на WP-CLI се регистрират кешираните типове публикации и пренаписванията на колекциите, без откриване и синхронизиране на всяка страница.
Изолирани блокове
Повечето блокове Blockstudio се визуализират на сървъра. Това е подходящо за WordPress, но създава познат проблем с кеширането: един персонализиран блок може да затрудни кеширането на цялата страница.
Изолираните блокове разделят това ограничение на ниво блок.
{
"name": "acme/cart-count",
"blockstudio": {
"island": "dynamic"
}
}
При първия отговор динамичният изолиран блок визуализира само заместител, безопасен за кеширане. След това браузърът изпраща една пакетна заявка за всички готови динамични изолирани блокове на страницата, а Blockstudio визуализира фрагментите в реалния контекст на заявката на посетителя.
Така кешът на цялата страница може да съхранява обвивката ѝ, докато броят на артикулите в количката, контролите на акаунта, UI с ограничен достъп или други елементи, специфични за потребителя, остават актуални.
<div class="cart-count-placeholder">Loading cart...</div>
<div class="cart-count">
<?php echo esc_html(acme_cart_count()); ?>
</div>
За блокове, които вече визуализират съдържание HTML, безопасно за кеширане, и се нуждаят само от сигнал за монтиране във фронтенда, използвайте хидратиран изолиран блок:
{
"name": "acme/tabs",
"blockstudio": {
"island": "hydrate"
}
}
Хидратираните изолирани блокове не изпращат заявка REST. Те се визуализират нормално и получават събитие blockstudio:island:hydrate във фронтенда.
Динамичните изолирани блокове работят и чрез програмните пътища за визуализиране:
bs_render_block([
'name' => 'acme/cart-count',
'data' => ['productId' => 42],
]);
И чрез тагове за блокове:
<bs:acme-cart-count product-id="42" />
Крайната точка има съзнателно ограничен обхват. Тя визуализира само регистрирани блокове Blockstudio, които са динамични и изрично обозначени като динамични изолирани блокове. Атрибутите се филтрират според схемата на блока и списъка с разрешени атрибути за изолираните блокове, а всеки маркер съдържа подпис, генериран от обслужващия сайт WordPress.
Съхранение в база данни Storh
Слоят за бази данни на Blockstudio вече поддържа таблици, SQLite, JSONC, метаданни на публикациите и персонализирани типове публикации. Във версия 7.5 се добавя storage: "storh" за проекти, които искат файлово хранилище с по-безопасни едновременни записи и индекси, извлечени от схемата, но не желаят активните записи да се записват до файловете с изходния код на блоковете.
return [
'storage' => 'storh',
'fields' => [
'title' => ['type' => 'string', 'required' => true],
'status' => ['type' => 'string'],
'count' => ['type' => 'integer'],
],
];
Записите на Storh се съхраняват в качените файлове:
wp-content/uploads/blockstudio/db/my-theme-my-block/default/
Публичният API остава непроменен. bs.db(), REST и Db::get() продължават да връщат целочислени стойности id. Вътрешно Blockstudio съпоставя тези идентификатори с идентификаторите на документи UUIDv7 в Storh, така че съществуващият код на клиента не се нуждае от промени.
Всяко поле, декларирано в схемата, се индексира за филтриране по равенство; за числовите полета и полетата с дати се създават индекси за диапазон, а изричните указания за уникалност се запазват. За проекти, започнали с начални файлове JSONC, новата миграция CLI запазва изходния файл и записва еквивалентно хранилище Storh:
wp bs db migrate my-theme/app subscribers --to=storh
Това дава на JSONC по-ясна роля като прост формат за начални данни и конфигурация, който може да се добави към хранилището с код, докато Storh става по-доброто хранилище във файловата система по подразбиране за записваеми данни в производствена среда.
Подобрения в анализатора и bsui
Във версия 7.5 са доизпипани и по-малки неща, които често излизат наяве, когато проектът започне да разчита повече на шаблони, базирани на файлове, и включен UI.
Съпоставянето на елементи вече може да обработва често срещания случай с абзац richtext без персонализиран конструктор. Ако <p> се съпостави с регистриран блок Blockstudio, който не е основен, и има атрибут richtext content, обикновеният вътрешен текст се копира в този атрибут. Вложените тагове и съпоставените дъщерни елементи продължават да се анализират като вътрешни блокове.
InnerBlocks приема токенизиран allowedBlocks в шаблоните:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Поддържаните токени са namespace/*, category:<slug> и @theme. Те се разширяват на сървъра, преди шаблонът да бъде изпратен до редактора, така че пътят за визуализиране във фронтенда остава непроменен.
Програмните вграждания също се държат по-предвидимо. bs_render_block() и bs_block() вече визуализират вградените блокове като HTML, разрешени от фронтенда, дори когато са извикани от предварителен преглед на друг блок в редактора. Така вложените блокове не излагат сурови псевдокомпоненти <RichText /> или <InnerBlocks /> в маркировката на предварителния преглед.
За включения UI bsui/button вече поддържа атрибут icon и iconPosition. Включените вътрешни стилове bsui/* се извеждат в каскаден слой @layer bsui, а вариантите на бутоните могат да се разширяват с blockstudio/ui/button/variants-style и съществуващия филтър blockstudio/blocks/attributes.
Таговете за блокове също могат да се комбинират по-сложно. Един префикс може да се разрешава чрез друг, така че <theme-ui-input /> с префикс на проект theme върху префикс на пространство от имена ui да се разрешава до bsui/input. Регистрираните тагове с префикс и псевдоним вече се визуализират и в изхода на шаблоните за блокове, не само в съдържанието на страниците, така че шаблонът може да ги извежда директно, вместо да извиква bs_render_block().
Персонализираните конструктори на блокове, регистрирани чрез blockstudio/block_tags/builders, също участват последователно в анализа на тагове и съпоставени елементи. След това продължават да се изпълняват изричните филтри за визуализиране и те могат да заменят конструктора.
По-бързи заявки със загрят кеш и експортиране
Кешовете на средата за изпълнение и редактора вече по подразбиране се намират в wp-content/blockstudio/cache вместо в качените файлове. Местоположението може да се променя чрез cache.path или blockstudio/cache/dir, така че трайното кеширане остава достъпно на хостове, които блокират файловете PHP в качените файлове. Кешовете на средата за изпълнение, ресурсите на редактора и Tailwind също автоматично премахват остарелите записи, така че дългосрочните проекти вече не трупат безкрайно кеш файлове на диска.
При заявките към фронтенда със загрят кеш валидният регистър на средата за изпълнение вече се зарежда преди изграждането на източниците за откриване. Така се пропускат рекурсивното откриване на източници, изграждането на блокове, анализирането на полета и повторното обхождане на дървото за ключове на кеша. Заявките в производствена и тестова среда се доверяват на валидиран моментен изглед на наблюдаваните файлове за 20 секунди по подразбиране, докато локалните среди и средите за разработка продължават да проверяват при всяка заявка.
Създаването на студен кеш се изпълнява от една заявка. Тя изгражда и публикува атомарно полезния товар, докато едновременните заявки изчакват готовия резултат. Tailwind вече съхранява до 1,000 компилирани записа за 30 дни по подразбиране и използва повторно състоянието от изграждането на компилатора при загрят кеш, така че наборът от маршрути за цял сайт вече не се върти в малък кеш.
Инструментите за дългосрочно експортиране могат да извикват Blockstudio\Batch_Render::reset() между документите. Това изчиства броячите, ресурсите, изолираните блокове, оформлението и генерирането на Tailwind, ограничени до заявката, без да изгражда откриването наново. Филтърът blockstudio/render/dependencies предоставя пътищата към шаблоните и ресурсите, използвани от всеки визуализиран блок, за изграждане на графи на зависимостите.
Надеждност и съвместимост
Няколко поправки допълват изданието:
- Промените в дефинициите на полетата чрез
blockstudio/blocks/attributesвече определят валидирането на опциите при визуализиране, както и схемата на редактора. Типизираните числови и булеви стойности на опциите също се разрешават последователно. - Обвивките на блоковете в редактора използват същите генерирани класове като визуализациите във фронтенда, а Canvas може да копира конфигурираните класове на тялото на страницата от фронтенда чрез новия филтър
blockstudio/editor/canvas/body_class. - Content Sync валидира целия план на източника преди разрушителни записи, ограничава операциите за изчистване до конфигурирания набор от съдържание и отчита грешките при запис на файлове, без да актуализира състоянието на синхронизация за съответния обект.
- Composer пакетите, включени в активни теми или родителски теми, свързани чрез символни връзки, намират ресурсите на редактора в публичната директория на темата URL.
- Страниците с ключ от файл запазват стойностите на полета Blockstudio, управлявани от редактора, мигрират стария вложен формат на ключа при синхронизиране и приемат числовата нула за валиден ключ.
- Динамичните изолирани блокове проверяват подписите преди филтрите за атрибутите на заявката, игнорират неподписания контекст на заявката, възстановяват сесията на влезлите посетители от същия домейн и избягват сблъсъци в кеша между анонимни потребители.
- Крайните точки за необработени страници Markdown вече спазват видимостта на публикациите и защитата с парола.
- Контролите на редактора обработват по-надеждно празни условия, стойности за превключване на всички квадратчета, асинхронно опресняване на опциите, динамично подреждане на визуализирането и състоянието на RichText или WYSIWYG в повтарящите се полета.
Персонализирани типове полета
Още за представените по-горе персонализирани типове полета.
Защо са нужни персонализирани типове полета?
Blockstudio трябва да е полезен веднага след инсталиране, но реалните проекти често имат контроли, специфични за областта: инструменти за избор на токени за отстояние, цветови роли на системата за дизайн, адаптивни размери, източници на икони, селектори на продукти или редакторски контроли, които съпоставят стойност със структурирани данни.
Преди версия 7.5 тези проекти можеха или да комбинират няколко вградени полета, или да разклонят редактора. Версия 7.5 предлага поддържана междинна възможност: Blockstudio управлява жизнения цикъл на полето, а проектът — контролата.
add_action('init', function () {
wp_register_script(
'acme-field-dimensions',
get_stylesheet_directory_uri() . '/fields/dimensions.js',
['blockstudio-blocks', 'wp-components', 'wp-element'],
'1.0.0',
true
);
bs_register_field_type('acme/dimensions', [
'attribute' => 'object',
'default' => [],
'editor_script' => 'acme-field-dimensions',
'storage' => [
'type' => 'object',
'rest_schema' => [
'type' => 'object',
'additionalProperties' => ['type' => 'string'],
],
],
]);
});
const { createElement: el } = wp.element;
const { TextControl } = wp.components;
window.blockstudio.registerFieldType('acme/dimensions', {
component(props) {
const value =
props.value &&
typeof props.value === 'object' &&
!Array.isArray(props.value)
? props.value
: {};
const sides = props.sides || ['top', 'right', 'bottom', 'left'];
return el(
'div',
{},
sides.map((side) =>
el(TextControl, {
key: side,
label: side,
value: value[side] || '',
onChange(nextValue) {
props.onChange({
...value,
[side]: nextValue,
});
},
}),
),
);
},
});
След това полето може да се използва в block.json като вградено поле:
{
"blockstudio": {
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"label": "Margin",
"sides": ["top", "bottom"],
"default": {
"top": "md",
"bottom": "md"
}
}
]
}
}
Обичайни стойности в шаблоните
Запазената стойност е достъпна в PHP, Twig и Blade като всеки друг атрибут Blockstudio.
<div class="<?php echo esc_attr('mt-' . ($a['margin']['top'] ?? '')); ?>">
<?php echo esc_html($a['title'] ?? ''); ?>
</div>
Същите пътища към обекти работят и в шаблоните на разширения:
{
"blockstudio": {
"extend": "core/group",
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"set": [
{
"attribute": "class",
"value": "mt-{attributes.margin.top} mb-{attributes.margin.bottom}"
}
]
}
]
}
}
Бележки за съвместимостта
Съществуващите вградени типове полета остават непроменени. Съществуващите групи от повторно използваеми полета custom/{name} също остават непроменени. Имената на персонализираните типове полета трябва да са с малки букви и пространство от имена, например acme/dimensions; пространствата от имена custom/ и blockstudio/ остават резервирани.
Ако PHP регистрира тип поле, но скриптът му за редактора не регистрира съответната контрола, Blockstudio запазва стойността и показва в редактора известие, което не може да се редактира. Ако даден тип поле не е регистриран в PHP, Blockstudio го пропуска от генерираните атрибути WordPress.
Актуализация за поддръжка на 7.5.1
7.5.1 премахва предупреждение за преобразуване от масив към низ, което се издава при подготовката на стойностите от множествен избор за визуализиране. Запазените и визуализираните стойности вече бяха правилни, но в дневниците за отстраняване на грешки можеше да се появява по едно предупреждение за всяко визуализиране на поле.
Съпътстващата актуализация blockstudio/phpstan v0.1.7 също разпознава полета, вложени в анонимни групи, в PHP, Twig, Blade и подразбиращите се форми на атрибутите на шаблона. Съществуващите проекти могат да получат тази поправка на пакета чрез composer update blockstudio/phpstan.