Към съдържанието

Dennis · 27 юли 2026 г.

Blockstudio 7.6

Blockstudio Версия 7.6 позволява проектът да се преглежда и визуализира от PHP и премества настройките по подразбиране за производствения фронтенд в blockstudio.json: опис API, самостоятелно визуализиране, помощници за шаблони за мултимедия и Tailwind, профили за производителност, една директория за кеша, статично предварително визуализиране с ранно обслужване, по-строги предварителни настройки за анализ и генерирани инструменти за проекти за агенти за програмиране.

Две извиквания осигуряват повечето възможности в това издание. Canvas::inventory() връща всяка страница, блок, шаблон, шаблон или част от шаблон за редактора на сайта и включен пример на 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 отвъд шаблоните на блоковете.
  • Управляван hook за commit: blockstudio-githooks sync записва и управлява hook за pre-commit, който изпълнява конфигурираната предварителна настройка.
  • Договор на проекта: blockstudio-agents записва AGENTS.md, описващ какво създава проектът, кои функции включва и какво налага неговата предварителна настройка.
  • Индекс на документацията: файлът с контекст за ИИ вече е индекс на всеки документ, неговото предназначение и идентификаторите, за които отговаря.
  • Канонични етикети на блокове: самостоятелна команда пренаписва съкратените форми с префикси и псевдоними като <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 или "*" зарежда всеки запис от съответния тип.
  • Низ или списък съвпада точно по ID, име, кратко име, път или път до източника.
  • Празен низ, празен списък или false не зарежда нищо от този тип.
  • Щом присъства ключ за който и да е тип, пропуснатите типове остават недокоснати.

Идентификаторите, които вече не съществуват, се връщат под deleted, вместо да се получи грешка, а крайната точка за опресняване на Canvas REST прилага същото правило към параметрите си blocks и pages.

Canvas::documents() използва същия избор и добавя по един рендериран документ за всеки запис. Избраните страници се рендерират във възстановен контекст на фронтенда, така че условните проверки на заявката, класовете на тялото, кратките кодове, оформленията, пренасочванията и обратните извиквания за зареждане виждат тази страница, а не заявката, която я е поискала.

Самостоятелно рендериране

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 включват един и същ набор: премахват от главната част извеждането на генератор, емоджита, емисии, откриване и съседни публикации; премахват откриването на oEmbed и скриптовете на хоста; изключват XML–RPC, pingback съобщенията и отдалеченото откриване на редактора; премахват общите ресурси на ядрото за фронтенда; прилагат стандартни настройки за извеждане на изображения; ограничават Heartbeat извън редакторите; предварително зареждат документи от същия източник при намерение за посочване или фокус; и използват зареждача на изображения на Blockstudio.

Всяка дъщерна стойност замества профила, както preload.links по-горе. Премахването на ресурси на ядрото за фронтенда е първото, което трябва да тествате, защото страница, зависеща от тях, ще се повреди видимо. 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, бисквитки за персонализация и всички пътища под 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, преди да се смени картата, така че частично рендерирано внедряване оставя предишния граф активен. Записите за мрежи от сайтове остават изолирани по хост, началния път и ID на сайта.

Затопляне и състояние

Три команди WP-CLI покриват ежедневната употреба:

Обвивка
wp bs prerender warm
wp bs prerender status
wp bs prerender purge

status отчита активната идентичност, броя на файловете и байтовете, записите в графа, състоянието на опашката и броячите за попадения, пропуски, изграждания и неуспешни операции за всеки обхват.

Инструменти за анализ и агенти

Предварителни настройки за анализ

blockstudio/phpstan получава три слоя над анализа на блоковете си, както и една команда, която изпълнява избрания от проекта слой.

Предварителна настройка Какво добавя
base Съществуващият анализ на схемата, шаблоните, hook-овете, настройките и API.
theme Коренови директории на темите, заглавки на стилове, ресурси, ограничаване на обхвата на селекторите, стойности на полетата по подразбиране, граници на повторителите.
extreme-theme PHPStan max, опасни PHP, екраниране, Tailwind, JavaScript и проверки на Interactivity.
wordpress-render Проверка чрез рендериране на живо, предоставена от извикващия, над extreme-theme.

Стойностите по подразбиране идват от blockstudio.json, така че интерактивните изпълнения, CI и hook-овете за commit споделят една конфигурация:

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.

Управляван hook за commit

Една настройка и една команда превръщат конфигурираната предварителна настройка във входен контрол при commit.

JSON
{
  "githooks": {
    "commit": true
  }
}
Обвивка
vendor/bin/blockstudio-githooks sync

Синхронизирането записва hook-а и запис за собственост в общата директория на Git, насочва core.hooksPath към управляваната директория и свързва предходно конфигурирания hook за pre-commit. Hook-ът определя хранилището и основната директория на проекта при извършване на commit, така че свързаните работни копия и пътищата с интервали работят.

Hook-ът изпълнява vendor/bin/blockstudio-phpstan и нищо друго; никога не форматира и не пренаписва файлове. Ако зададете commit на false и синхронизирате отново или изпълните blockstudio-githooks remove, пътят до записания hook се възстановява и се изтриват само файловете, притежавани от Blockstudio.

Договор на проекта

blockstudio-agents записва AGENTS.md, който указва къде се намират блоковете, какво представлява страницата в този проект, кои функции са включени и какво ще отхвърли анализаторът.

Обвивка
vendor/bin/blockstudio-agents

Документът се генерира според проекта, а не от шаблон. Договорът за тема със заглавка style.css, блокове и страници във файлове се различава от договора за плъгин, който регистрира само блокове, и включва броя, директориите, пространствата от имена и езиците за шаблони, открити от скенера. blockstudio.json определя кои функции се показват, така че проект без статично предварително рендериране изобщо няма да го спомене.

Разделът за коректността се прочита слой по слой от собствените файлове с правила на избраната предварителна настройка. Затова добавянето на правило към предварителна настройка променя всеки генериран от нея договор.

Управлението на собствеността работи като при hook-а за commit. Ако във файла няма генериран маркер, той се отхвърля, вместо да бъде заменен, освен ако --force не указва друго; областта за бележки в края се запазва при регенериране; --check излиза с код 1, когато договорът е остарял; а --stdout го извежда, без да докосва файловата система.

Индекс на документацията

blockstudio-llm.txt вече е индекс, а не конкатенация. Всеки публикуван документ се появява веднъж в своя раздел и подраздел, заедно с маршрута, изходния файл, едноредово описание на предназначението и идентификаторите, за които отговаря: пътища към настройки, имена на hook-ове, функции и класове 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. Докато статичното предварително рендиране е изключено, не се записват файлове и не се инсталира допълнителен компонент.

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. Така не се налага големите наследени дървета от заключващи файлове да бъдат изтривани по време на заявка за внедряване.

Генерираните файлове имат собствени места. assets/media.json трябва да бъде под контрола на версиите или част от стъпка по изграждането. Картата на маршрутите, допълнителният компонент 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.

Къде да намерите подробностите