Перейти до вмісту

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() повертає все, що проєкт зареєстрував, одним звичайним масивом, нічого не рендерячи.

PHP
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 — шаблоном для рендерингу.

Цільовий вибір

Зазначення записів обмежує обсяг роботи відразу, замість фільтрування після її виконання.

PHP
$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 як рядок за допомогою того самого конвеєра, що й фронтенд.

PHP
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.

PHP
$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
<?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() повертає невелику викличну функцію для варіантів компонента:

PHP
$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 вмикає типові налаштування фронтенду для виробничого середовища в одному місці.

JSON
{
  "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.

PHP
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.

JSON
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}

Дані збірки, відомості про реєстрацію блоків, ресурси редактора, скомпільований Tailwind CSS, документи рендерингу, фрагменти островів, статичні HTML, індекси графів, черги прогрівання та діагностичні дані зберігаються в цьому кореневому каталозі. Відносний шлях обчислюється від WP_CONTENT_DIR, а абсолютний можна спрямувати на окремий том.

Об’єкти зберігаються спочатку в каталозі поточної мережі й сайту, а потім — за ідентичністю середовища виконання: відбитком версій Blockstudio, WordPress і PHP, ефективних налаштувань, активної теми й плагінів, джерел виявлення та задіяних файлів джерела. Щойно вхідні дані змінюються, залежні від них об’єкти стають новими, а старі видаляються.

Холодні збірки виконуються в режимі одного запиту: один запит створює й атомарно публікує результат, а решта чекають. Якщо оновлення не вдається, продовжує обслуговуватися останній справний об’єкт, а помилка залишається видимою. Команда Blockstudio\Runtime_Cache::purge('tailwind') очищає одну область.

Статичний попередній рендеринг

Статичний попередній рендеринг кешує повні анонімні документи HTML і може віддавати їх до запуску WordPress. Типово функцію вимкнено.

JSON
{
  "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-адреси.

PHP
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 і хуки коміту використовують спільну конфігурацію:

JSON
{
  "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.

Керований хук коміту

Один параметр і одна команда перетворюють налаштований набір правил на умову для коміту.

JSON
{
  "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 та командами.

Text
## 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, це скорочення:

HTML
<brand-card>
  <ui-input />
</brand-card>

означає те саме, що й:

HTML
<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; кожен такий крок скасовує один рівень змін.

Рекомендований порядок впровадження:

  1. Установіть для performance.profile значення speed, а потім перевірте вивід у head, стрічки та плагіни, які залежать від oEmbed або XML-RPC.
  2. Згенеруйте assets/media.json, перенесіть шаблони в bs_media_image(), а потім увімкніть performance.media.lazy.
  3. Увімкніть performance.staticPrerender, залишивши earlyServe вимкненим, перевірте запити за допомогою wp bs prerender status, а потім увімкніть earlyServe.
  4. Запускайте blockstudio-phpstan --preset theme, доки звіт не буде чистим, і лише тоді додайте пресет до githooks.commit.

Де знайти подробиці