Dennis · 27 липня 2026 р.
Blockstudio 7.6
Blockstudio 7.6 дає змогу переглядати проєкт і відображати його з PHP, а типові параметри виробничого фронтенду переносить до blockstudio.json: інвентар API, автономне відображення, допоміжні функції шаблонів для медіа та Tailwind, профілі продуктивності, єдиний каталог кешу, попереднє статичне відображення з раннім обслуговуванням, суворіші профілі аналізу та згенеровані інструменти проєкту для агентів програмування.
Основну частину випуску забезпечують два виклики. Canvas::inventory() повертає всі сторінки, блоки, патерни, шаблони Site Editor, частини шаблонів і приклади UI, зареєстровані в проєкті. Render::document() повертає готовий HTML для будь-якого з них і саме ті ресурси, які використовувалися під час відображення.
Оновлення 7.6.2: звірка сторінок із файлів більше не виконується під час звичайних запитів WordPress. Для застосування змін джерела запустіть
wp bs pages syncабо викличтеBlockstudio\Pages::reconcile(). Маршрутизація колекцій і типові параметриtemplateForвикористовують збережену конфігурацію середовища виконання, а явна звірка не виконує попередній великий багатомовний запит OR-meta. Короткочасний параметрthemeDefaults.syncPagesInDevelopmentвилучено, оскільки синхронізація сторінок більше не запускається з хуків запитів. ТеперPages::init()використовується лише під час завантаження; інтеграції, які передавалиforce, мають використовуватиPages::reconcile()або CLI. Відкриття Canvas і далі виконує одну автентифіковану явну звірку переліку вмісту для редагування.
7.6.12 оновлення: Таблиці стилів редактора тепер отримують префікси за один прохід перезапису, а не через компіляцію SASS для кожного ресурсу, тож холодна збірка редактора на сайті з багатьма блоками більше не ризикує вичерпати помірний ліміт пам’яті. Кешовану попередньо відрендерену сторінку, таблицю стилів Tailwind з хешем вмісту якої було видалено, рендерять повторно, а не віддають без стилів — і через кеш PHP, і через модуль Early Serve. Атрибути блоків, записані на верхньому рівні, тепер зчитуються під час рендерингу, а не відкидаються, тож схема Blockstudio, зареєстрована в
WP_Block_Type, застосовується і до програмних записувачів.
7.6.11 оновлення: Під час установлення артефактів графа документ маршруту тепер атомарно замінюється, якщо копія у сховищі змінилася за тим самим ключем; ідентичні документи залишаються без змін, а про просунуті, замінені, пропущені та збережені маршрути повідомляє
Static_Prerender_Early_Serve::last_promotion().
7.6.10 оновлення: Тепер під час влучань у кеш середовища виконання виявляють видалені скомпільовані ресурси навіть у період затримки обробки змін. Плоскі кеші середовища виконання версій до 7.6 атомарно поміщають у карантин і видаляють пакетами з обмеженим розміром cron. Глобальні об’єкти UI у комплекті виводяться один раз на сторінку. Early Serve у режимі графа може обслуговувати маршрути, відрендерені наживо й відсутні в розгорнутій карті маршрутів, із кешу ідентичностей. Tailwind може за бажанням виводити файл кешу з хешем вмісту разом із
tailwind.output: "link"; вбудований вивід залишається типовим.
Коротко:
- Інвентар проєкту:
Canvas::inventory()повертає всі зареєстровані записи разом із джерелами та стабільним порядком відображення. - Цільовий вибір: зазначення блоків і сторінок обмежує пошук, синхронізацію, рендеринг і компіляцію цими записами.
- Автономний рендеринг:
Blockstudio\Renderповертає готовий HTML для блока, композиції або цілого документа. - UI сімейства компонентів:
Blockstudio\Uiоб’єднує бібліотеку в комплекті в одне публічне сімейство на компонент, кожне з прикладом. - Стабільні розміри зображень:
bs_media_image()рендерить ресурси теми з реальними розмірами згенерованогоassets/media.json. - Tailwind помічники класів:
bs_tw_merge()іbs_tw_variants()поєднують класи в PHP з урахуванням конфліктів. - Профілі продуктивності:
performance.profileодразу вмикає типові налаштування виробничого фронтенду; дочірні значення мають пріоритет. - Типізований доступ до налаштувань:
Settings::get_bool()та споріднені функції зчитуютьblockstudio.jsonіз реальними типами й повідомляють про помилки розбору. - Єдиний каталог кешу: кожен згенерований файл розміщується в
cache.pathі має ключ ідентичності середовища виконання. - Статичний попередній рендеринг: анонімні HTML можна кешувати, інвалідовувати через граф залежностей і віддавати до запуску WordPress.
- Набори правил аналізу:
theme,extreme-themeіwordpress-renderрозширюютьblockstudio/phpstanза межі шаблонів блоків. - Керований хук коміту:
blockstudio-githooks syncстворює та керує хуком pre-commit, який запускає налаштований набір правил. - Контракт проєкту:
blockstudio-agentsстворюєAGENTS.mdз описом того, що створюють автори проєкту, які функції ввімкнені та що вимагає його набір правил. - Покажчик документації: файл контексту для AI тепер містить покажчик усіх документів, їх призначення та ідентифікаторів, за які вони відповідають.
- Канонічні теги блоків: окрема команда переписує скорочення префіксів і псевдонімів у
<bs:namespace-slug>; передбачено пробний запуск. - Сумісність типово ввімкнена: ніщо з переліченого не змінює сайт, доки його не зазначено в
blockstudio.json.
Читання та рендеринг проєкту
Інвентар проєкту
Canvas::inventory() повертає все, що проєкт зареєстрував, одним звичайним масивом,
нічого не рендерячи.
use Blockstudio\Canvas;
$result = Canvas::inventory();
foreach ($result['inventory']['blocks'] as $block) {
echo $block['name'] . "\n";
}
Записи згруповано за типом: pages, blocks, patterns, templates,
parts і ui. order визначає стабільний порядок відображення для всіх типів,
sources зіставляє кожен запис із шляхами до його джерел, а warnings і errors
збирають проблеми у вигляді структурованих записів.
Записи блоків містять id, name, title, source, path, provenance і
готовий до рендерингу declaration. Для записів сторінок source залишається стабільною ідентичністю,
а path — шаблоном для рендерингу.
Цільовий вибір
Зазначення записів обмежує обсяг роботи відразу, замість фільтрування після її виконання.
$changed = Canvas::inventory([
'blocks' => ['mytheme/hero'],
'pages' => ['about'],
]);
Це повертає один блок і одну сторінку. patterns, templates, parts і ui
повертаються порожніми, а їхні джерела не зчитуються, не синхронізуються, не рендеряться й
не компілюються.
Правила чіткі:
- Якщо ключів типів немає, завантажуються всі типи.
true,nullабо"*"завантажує всі записи відповідного типу.- Рядок або список шукає точний збіг за ідентифікатором, назвою, слагом, шляхом або шляхом до джерела.
- Порожній рядок, порожній список або
falseне завантажує жодного запису цього типу. - Щойно задано ключ будь-якого типу, пропущені типи залишаються без змін.
Ідентифікатори, яких більше не існує, повертаються в deleted, а не спричиняють помилку,
і кінцева точка оновлення Canvas REST застосовує те саме правило до параметрів blocks та
pages.
Canvas::documents() приймає той самий вибір і додає по одному відрендереному документу
на запис. Вибрані сторінки рендеряться у відновленому контексті фронтенду, тож умовні запити,
класи body, шорткоди, макети, перенаправлення та зворотні виклики постановки в чергу бачать цю сторінку,
а не запит, який її запустив.
Автономний рендеринг
Blockstudio\Render повертає відрендерений HTML як рядок за допомогою того самого
конвеєра, що й фронтенд.
use Blockstudio\Render;
$html = Render::composition([
'root' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
'layers' => [
['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
],
]);
В основі лежить одна форма оголошення з чотирма ключами: name, attributes,
content і children. root, data, inner, innerBlocks, layers і
example — це зручні варіанти введення, які Render::normalize() зводить до цієї форми.
Дочірні елементи рендеряться рекурсивно, а в разі некоректного введення виникає виняток із назвою
проблемного блока.
Render::document() обгортає вивід у повний окремий документ HTML.
$document = Render::document('mytheme/hero', [
'title' => 'Hero preview',
]);
echo $document['html'];
body — це лише вивід блока, html — зібраний документ, blocks —
назви блоків, що увійшли до нього, а assets розділяє розмітку на head,
footer, styles, scripts, modules, interactivity, ui і tailwind.
Ресурси обмежені тим, що було відрендерено, тому ресурси лише для редактора не з’являються.
Render::document_from_html() обгортає HTML, відрендерений деінде, а
Render::content() рендерить серіалізований вміст блоків без документа. Викликайте
Blockstudio\Batch_Render::reset() між документами в межах одного процесу PHP;
Canvas::documents() уже робить це.
Сімейства компонентів UI
Blockstudio\Ui надає бібліотеку UI у комплекті окремим записом на кожен публічний
компонент замість списку внутрішніх частин.
Ui::inventory() повертає по одному запису на сімейство із кореневим блоком, назвою та
потрібними блоками реалізації. Ui::examples() додає детерміноване оголошення для кожного сімейства: типові значення збережено, обов’язкові дочірні шари вкладено в батьківські, а для порожніх полів наведено стабільний приклад тексту. Це оголошення канонічне, тому його можна безпосередньо передати в Render::document().
У Canvas використано таке саме групування. Бібліотека UI у комплекті з’являється як тип ui: по одному прикладу на сімейство, а реєстрації блоків реалізації не відображаються в blocks.
Сімейства спроєктовано для комбінування: список вибору відкривається в діалоговому вікні, а його список накладається на тригер; меню й комбобокси прив’язуються до фіксованих координат вікна перегляду, які не змінюються під час прокручування; модальні вікна накопичуються й закриваються по одному натисканням Escape; кожен нижній колонтитул поєднує той самий елемент закриття з варіантом оформлення. Як працюють ці стики та які інваріанти забезпечують їхню роботу, описано в розділі про композицію; у /ui/examples композиції можна переглянути наживо.
Помічники шаблонів
Стабільні розміри зображень
bs_media_image() рендерить ресурси теми з реальними шириною та висотою й зарезервованим
співвідношенням сторін, тож зображення поза медіатекою більше не зсувають макет.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
]);
Результат — це figure.blockstudio-media із вбудованим aspect-ratio навколо
img із реальними width, height, loading і decoding. Розміри
беруться зі згенерованого assets/media.json, який створює
Blockstudio\Media_Metadata_Builder під час збірки або вручну.
src приймає шлях відносно теми, абсолютний шлях або повний URL, а
attachmentId призначений для зображень із медіатеки. eager вимикає відкладене завантаження
для зображень у верхній частині сторінки, а sources виводить <picture>.
Коли ввімкнено performance.media.lazy, справжній URL переміщується до data-src за
заповнювачем правильного розміру.
Помічники класів Tailwind
bs_tw_merge() і bs_tw_variants() поєднують класи Tailwind у шаблонах PHP,
використовуючи рушій, що вже входить до складу Blockstudio.
bs_tw_merge('px-2 text-sm', 'px-4') повертає text-sm px-4: конфліктний
px-2 відкидається, а перемагає пізніше значення. Вкладені масиви значень класів
також підтримуються.
bs_tw_variants() повертає невелику викличну функцію для варіантів компонента:
$button = bs_tw_variants([
'base' => 'inline-flex items-center',
'variants' => [
'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
],
'defaultVariants' => ['size' => 'sm'],
]);
echo $button(['size' => 'lg', 'class' => 'rounded']);
Це виводить inline-flex items-center h-12 px-6 rounded. Підтримуються базові класи,
варіанти, типові варіанти, складені варіанти та class або className
для окремого виклику.
Конфігурація для виробничого середовища
Профілі продуктивності
performance.profile вмикає типові налаштування фронтенду для виробничого середовища в одному місці.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}
compat є типовим і нічого не змінює. speed та strict вмикають
той самий набір: генератор, емодзі, стрічка, вивід даних для виявлення та сусідніх записів видаляються з head; виявлення oEmbed і скрипти хоста вилучаються; XML-RPC, pingbacks
і виявлення віддаленого редактора вимикаються; загальні ресурси фронтенду core видаляються;
застосовуються типові налаштування виводу зображень; Heartbeat обмежується поза редакторами; документи з того самого джерела попередньо завантажуються за наведенням або наміром фокусування; використовується завантажувач зображень Blockstudio.
Кожне дочірнє значення перевизначає профіль, як це робить preload.links вище. Спершу варто перевірити видалення ресурсів фронтенду core, оскільки залежна від них сторінка матиме видимі проблеми. Runtime_Settings::current() показує остаточно застосований профіль.
themeDefaults охоплює два завдання, які теми інакше виконують вручну: titleTag та
suppressDirectoryUpdates, щоб приховати активну дочірню й батьківську теми серед доступних оновлень.
Типізований доступ до налаштувань
Blockstudio\Settings зчитує конфігурацію з реальними типами, а не повертає
будь-яке значення, що зберігалося в JSON.
use Blockstudio\Settings;
$lazy = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);
$roles = Settings::get_array('users/roles');
foreach (Settings::errors() as $error) {
error_log($error);
}
Про некоректний JSON повідомляється через Settings::errors(), а не підставляються типові значення. Settings::get_raw() повертає лише те, що оголосило активне джерело,
що дає змогу відрізнити значення false від того, якого ніколи не задавали.
Settings::fingerprint() повертає стабільну ідентичність ефективних налаштувань,
а під час доступу дані перезавантажуються, якщо змінюється blockstudio.json.
Єдиний каталог кешу
Тепер кожен згенерований файл розміщується в cache.path, типовим значенням якого є
wp-content/blockstudio/cache.
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Дані збірки, відомості про реєстрацію блоків, ресурси редактора, скомпільований Tailwind CSS,
документи рендерингу, фрагменти островів, статичні HTML, індекси графів, черги прогрівання та
діагностичні дані зберігаються в цьому кореневому каталозі. Відносний шлях обчислюється від
WP_CONTENT_DIR, а абсолютний можна спрямувати на окремий том.
Об’єкти зберігаються спочатку в каталозі поточної мережі й сайту, а потім — за ідентичністю середовища виконання: відбитком версій Blockstudio, WordPress і PHP, ефективних налаштувань, активної теми й плагінів, джерел виявлення та задіяних файлів джерела. Щойно вхідні дані змінюються, залежні від них об’єкти стають новими, а старі видаляються.
Холодні збірки виконуються в режимі одного запиту: один запит створює й атомарно публікує результат, а решта чекають. Якщо оновлення не вдається, продовжує обслуговуватися останній справний об’єкт, а помилка залишається видимою. Команда Blockstudio\Runtime_Cache::purge('tailwind') очищає одну область.
Статичний попередній рендеринг
Статичний попередній рендеринг кешує повні анонімні документи HTML і може віддавати їх до запуску WordPress. Типово функцію вимкнено.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}
Умови придатності
Кешувати можна лише повні анонімні документи HTML. Запити, відмінні від GET, рядки запиту,
адміністрування, REST, Ajax, cron, стрічки, пошук, попередній перегляд, запити з nonce,
персоналізовані файли cookie та будь-які шляхи в dynamicPaths оминають кеш.
Відповідь може повністю відмовитися від кешування за допомогою маркера <!-- blockstudio:no-cache -->.
Під час зіставлення шляхів враховуються межі: /account охоплює /account/orders, але
не /accounting.
Режими підпису та графа
invalidate визначає, як закінчується термін дії записів. Типовий режим signature заповнює
відповідь із ключем ідентичності після анонімного промаху й оновлює її після змін на рівні сайту, що підходить для звичайного сайту.
Режим graph призначений для явних засобів збірки й розгортання. Він записує залежності кожної сторінки від власних джерел, тож план перебудовує лише зачеплені URL-адреси.
use Blockstudio\Static_Prerender_Runtime;
$plan = Static_Prerender_Runtime::build_plan($sourceUrls);
foreach ($plan['affectedUrls'] as $url) {
$result = render_with_dependencies($url);
Static_Prerender_Runtime::persist_built_response(
$url,
$result['html'],
$result['files'],
$result['virtualHashes']
);
}
Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));
Раннє обслуговування
Коли ввімкнено earlyServe, Blockstudio керує невеликою картою маршрутів для сайту та модулем advanced-cache.php, який передає вміст придатного запиту з кешу ще до запуску WordPress,
плагінів або теми.
Він ніколи не перезаписує чужу карту, модуль або оголошення WP_CACHE. Перш ніж замінити карту, артефакт графа перевіряє кожен файл HTML, на який є посилання, тож невдале розгортання з частковим рендерингом залишає активним попередній граф. Записи Multisite ізольовано за хостом, домашнім шляхом та ідентифікатором сайту.
Прогрівання та стан
Для щоденної роботи призначено три команди WP-CLI:
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
status показує активну ідентичність, кількість файлів і байтів, записи графа, стан черги, а також лічильники влучань, промахів, збірок і збоїв для кожної області.
Аналіз та інструменти для агентів
Набори правил аналізу
blockstudio/phpstan отримує три рівні додатково до аналізу блоків, а також одну
команду для запуску рівня, вибраного проєктом.
| Набір правил | Що додає |
|---|---|
base |
Аналіз наявних схем, шаблонів, хуків, налаштувань і API. |
theme |
Корені тем, заголовки стилів, ресурси, обмеження селекторів, типові значення полів, межі повторювачів. |
extreme-theme |
PHPStan max, небезпечний PHP, екранування, Tailwind, JavaScript і перевірки Interactivity. |
wordpress-render |
Перевірка активного рендерингу, яку надає викликач, поверх extreme-theme. |
Типові значення беруться з blockstudio.json, тому інтерактивний запуск, CI і хуки коміту
використовують спільну конфігурацію:
{
"phpstan": {
"preset": "theme",
"roots": ["."],
"excludePaths": ["fixtures/**"],
"maxFiles": 10000
}
}
vendor/bin/blockstudio-phpstan --root . -- --no-progress
Коди завершення: 0 у разі успіху, 1 за наявності діагностичних повідомлень і 2 за некоректного використання. Обгортка створює конфігурацію в системному тимчасовому каталозі, тож згенеровані конфігурація, базовий файл чи кеш не потрапляють до проєкту; ліміт пам’яті PHPStan збільшується до 1G.
Він також містить постачальника BC Math, тож перевіркам JavaScript більше не потрібен
ext-bcmath.
Керований хук коміту
Один параметр і одна команда перетворюють налаштований набір правил на умову для коміту.
{
"githooks": {
"commit": true
}
}
vendor/bin/blockstudio-githooks sync
Синхронізація створює хук і запис про керування ним у спільному каталозі Git,
спрямовує core.hooksPath до керованого каталогу та запускає раніше налаштований хук pre-commit. Під час коміту хук визначає корінь репозиторію й проєкту, тож пов’язані копії та шляхи з пробілами працюють.
Хук запускає лише vendor/bin/blockstudio-phpstan; він ніколи
не форматує й не переписує файли. Якщо встановити commit у false і знову синхронізувати або
запустити blockstudio-githooks remove, записаний шлях до хука відновиться,
а видалено буде лише файли, якими керує Blockstudio.
Контракт проєкту
blockstudio-agents створює AGENTS.md з описом розташування блоків, того, що в цьому проєкті є сторінкою, увімкнених функцій і того, що відхилить аналізатор.
vendor/bin/blockstudio-agents
Документ формується на основі проєкту, а не шаблону. Контракт теми із заголовком style.css,
блоками й сторінками на основі файлів відрізняється від контракту плагіна, який лише
реєструє блоки, та містить кількість елементів, каталоги, простори імен і мови шаблонів, знайдені сканером. blockstudio.json визначає, які функції вказувати,
тому в проєкті без статичного попереднього рендерингу про нього не згадується.
Розділ про коректність зчитується пошарово з власних файлів правил вибраного набору, тож нове правило в наборі оновлює всі згенеровані на його основі контракти.
Керування файлами працює так само, як і для хука коміту. Файл без маркера згенерованого вмісту не замінюється, якщо тільки --force не вказує інакше; область приміток наприкінці зберігається під час повторного створення; --check повертає код 1, якщо контракт застарів; --stdout виводить його, не торкаючись файлової системи.
Покажчик документації
blockstudio-llm.txt тепер є покажчиком, а не зведеним текстом. Кожен опублікований документ згадується один раз у своєму розділі й підрозділі разом із маршрутом, файлом джерела, коротким описом призначення та ідентифікаторами, за які він відповідає: шляхами налаштувань, назвами хуків, функціями й класами PHP та командами.
## Docs / Dev / Inspection Tools
### Canvas
route: /docs/dev/canvas
file: docs/docs/dev/canvas.md
purpose: A visual workspace and public inventory API for Blockstudio content.
settings: dev/canvas/enabled, ui
hooks: blockstudio/settings/dev/canvas/admin_bar, blockstudio/settings/dev/canvas/enabled
php: Blockstudio\Canvas, Canvas::documents(), Canvas::inventory()
Агент читає індекс, знаходить єдиний документ, якому належить потрібний йому ідентифікатор, і відкриває цей документ. Попередня конкатенація обсягом пів мегабайта, як і раніше, генерується та публікується за адресою /blockstudio-llm-full.txt; просто тепер її не видають першою.
Канонічні теги блоків
Окрема команда переписує скорочення префіксів і псевдонімів у канонічне написання <bs:namespace-slug>, яке вказує справжню назву блоку та визначається без завантаженого фільтра проєкту.
Якщо префікс brand відповідає theme-components, а префікс ui — bsui,
це скорочення:
<brand-card>
<ui-input />
</brand-card>
означає те саме, що й:
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Префікси й точні псевдоніми й надалі працюють і не вважаються застарілими. Команда не завантажує WordPress і нічого не записує без --apply:
php vendor/blockstudio/blockstudio/bin/migrate-block-tags.php \
--root="$PWD" \
--prefix-map=/tmp/prefixes.json \
--known-blocks=/tmp/blocks.json \
--report=/tmp/tag-migration.json \
--dry-run
--prefix-map зіставляє кожен префікс із його просторами імен, а --known-blocks перелічує зареєстровані назви блоків. У звіті наведено зіставлення застарілих назв із канонічними, кількість входжень, хеші кожного файлу й окремі списки невідомих тегів, неоднозначних псевдонімів і динамічних тегів. --apply відмовляється записувати зміни, доки вони залишаються, якщо не передано --allow-unresolved.
Обробляються парні, вкладені та самозакривні елементи розмітки, зокрема буквальні теги в рядках PHP. Змінюються лише назви тегів, повторний запуск нічого не змінює, а приклади в коментарях, блоках коду, <pre> чи <code> лише потрапляють до звіту.
Типова поведінка
Саме встановлення версії 7.6 нічого не змінює.
За замовчуванням профіль продуктивності має значення compat. Вивід у head, oEmbed, XML-RPC,
Heartbeat, параметри зображень, попереднє завантаження посилань, відкладене завантаження та фронтендний <title> залишаються такими, якими їх задали WordPress і тема.
За замовчуванням вимкнено: усі ключі performance.staticPrerender,
performance.measurement, performance.media і themeDefaults, а також
githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled і
blockTags.enabled. Поки статичне попереднє рендерення вимкнено, файли не створюються, а drop-in не встановлюється.
Canvas і Render працюють пасивно. Вони читають наявні реєстри й відображають лише те, що запитує викликач; жоден із них не підключається до виводу фронтенду й не реєструє маршрути. Для екрана адміністратора Canvas, як і раніше, потрібні dev.canvas.enabled та edit_posts.
Для суворішого аналізу потрібно явно вказати його. Встановлення blockstudio/phpstan вмикає лише базове розширення, а канонічна команда запускає base, якщо в проєкті не вказано пресет.
Згенеровані файли з’являються лише після запуску відповідної команди. githooks.commit нічого не робить, доки не запустити blockstudio-githooks sync, а AGENTS.md — доки не виконати blockstudio-agents.
Перехід із версії 7.5
Вимоги не змінилися: PHP 8.2 або новіша, WordPress 6.7 або новіша.
composer require blockstudio/blockstudio
Кеші перебудовуються один раз. Ідентифікатор середовища виконання містить версію Blockstudio, тому перший запит після оновлення буде без прогрітого кешу, а старі об’єкти буде видалено. Старий кеш Tailwind у wp-content/uploads/blockstudio/tailwind/cache можна видалити; замість цього сніпет, який шукав там файли через glob, має викликати Blockstudio\Runtime_Cache::purge('tailwind').
Пласку директорію wp-content/blockstudio/cache/runtime, що залишилася від версій до 7.6, автоматично перейменовують, щоб прибрати її з активного шляху, а потім видаляють обмеженими за обсягом проходами WP-Cron. Тому великі застарілі дерева lock-файлів не потрібно видаляти під час запиту розгортання.
У згенерованих файлів є відповідальні за них. assets/media.json має зберігатися в системі контролю версій або створюватися на етапі збирання. Карта маршрутів, drop-in advanced-cache.php і декларація WP_CACHE існують, лише коли ввімкнено earlyServe, а хук перед комітом — лише після синхронізації. Усе інше згенероване зберігається в cache.path, і його можна безпечно видалити.
Нічого не видалено й не перейменовано. bs_render_block(), bs_block(),
Blockstudio\Pages і Blockstudio\Patterns залишаються канонічними файловими джерелами вмісту.
Відкат виконується окремо для кожної функції. performance.profile повертає до compat,
staticPrerender.enabled — до false, githooks.commit — до false разом із sync, а cache.enabled — до false; кожен такий крок скасовує один рівень змін.
Рекомендований порядок впровадження:
- Установіть для
performance.profileзначенняspeed, а потім перевірте вивід у head, стрічки та плагіни, які залежать від oEmbed або XML-RPC. - Згенеруйте
assets/media.json, перенесіть шаблони вbs_media_image(), а потім увімкнітьperformance.media.lazy. - Увімкніть
performance.staticPrerender, залишившиearlyServeвимкненим, перевірте запити за допомогоюwp bs prerender status, а потім увімкнітьearlyServe. - Запускайте
blockstudio-phpstan --preset theme, доки звіт не буде чистим, і лише тоді додайте пресет доgithooks.commit.
Де знайти подробиці
- Canvas та його інвентар і документAPI
- Рендеринг, UI Компоненти і UI Композиція
- Налаштування та продуктивність
- Продуктивність, Кешування та Статичне попереднє рендерення
- Tailwind CSS
- PHPStan: пресети, канонічна команда, керований хук коміту і контракт проєкту
- Інтеграція зі ШІ: індекс документації та повний текст
- Міграція та PHP Хуки