Dennis · 7 лютого 2026 р.
Introducing Blockstudio 7
Blockstudio 7 вже тут. Це найбільший випуск в історії проєкту: повне переписування всієї кодової бази з нуля. Кожен клас, кожен хук і кожен рядок коду створено заново з урахуванням сучасного PHP, стандартів розробки WordPress та довгострокової підтримуваності.
Але це не просто рефакторинг. У Blockstudio 7 з’явилися важливі нові можливості: сторінки й патерни на основі файлів, система зберігання метаданих записів, інтеграція з SEO і абсолютно новий парсер HTML у блоки, на якому все це працює. Крім того, Blockstudio тепер повністю безкоштовний і має відкритий вихідний код.
Розгляньмо всі нові можливості.
Безкоштовний і з відкритим вихідним кодом
Я працюю над Blockstudio з 2020, і за ці роки випустив десятки оновлень. Користувачам він подобався, але знайти відповідність ринку для комерційного фреймворку блоків WordPress було складно.
Змінило ситуацію розширення можливостей LLM. AI-асистенти програмування вже достатньо добре пишуть код блоків, але для роботи їм потрібні чисті структури на основі файлів. Розмітка блоків WordPress неохайна: серіалізовані коментарі HTML із вбудованими атрибутами JSON, змішані зі структурою DOM. Людям із цим складно, а LLM ще важче зробити все правильно.
Підхід Blockstudio, у якому на першому місці файли, завжди мав спрощувати роботу: block.json і шаблон PHP у папці. Жодних записів у базі даних, React чи кроку збирання. У v7 ця філософія розвивається ще далі. Парсер HTML у блоки дає змогу писати звичайний HTML, який автоматично перетворюється на коректну розмітку блоків. Усе залишається у файловій системі. Записи до бази даних створюються лише під час синхронізації сторінок, яку явно запускають через PHP API або CLI, і ці сторінки генеруються з файлових шаблонів.
Відкриття вихідного коду Blockstudio — природний наступний крок. Що більше LLM навчаються на коді Blockstudio, то краще вони його генерують. Відкрита кодова база, відкрита документація та попередньо створений файл контексту для AI, який може використовувати будь-який інструмент: так можна створити найкраще середовище для розробки WordPress за допомогою AI.
Повна версія плагіна доступна на GitHub для всіх охочих користуватися ним, створювати форки та робити внески. Жодних ліцензійних ключів, платних обмежень чи заблокованих функцій.
Нові функції
Сторінки на основі файлів
Це одне з найбільших нововведень версії 7.0. Тепер цілі сторінки WordPress можна описувати у файлових шаблонах, які синхронізуються з базою даних як рідний вміст блоків, коли ви запускаєте синхронізацію сторінок командою API або CLI.
Створіть папку з page.json і файлом шаблону:
{
"name": "about",
"title": "About Us",
"slug": "about",
"postStatus": "publish"
}
<div class="about-page">
<h1>About Us</h1>
<p>Welcome to our site.</p>
</div>
Запустіть wp bs pages sync, щоб Blockstudio розібрав HTML на блоки WordPress і створив або оновив сторінку в базі даних.
Об’єднання блоків за ключами
Під час синхронізації шаблонів зміни користувачів зазвичай перезаписуються. Атрибут key розв’язує цю проблему, зберігаючи користувацький вміст між синхронізаціями:
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>
Блоки з однаковими ключами зберігають внесені користувачем зміни під час оновлення шаблону. Блоки без ключів повністю замінюються.
Прив’язки блоків
Замість ключів можна скористатися WordPress Core — прив’язками блоків API, щоб безпосередньо з’єднати блоки з метаданими запису. Це не функція Blockstudio, а рідна можливість WordPress API. Blockstudio просто передає атрибут metadata у згенеровану розмітку блока. Вміст зберігається в метаданих, а не в розмітці блоків, тож синхронізація шаблонів не знищує зміни користувачів. Дані також можна запитувати через WP_Query і отримувати через REST API.
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
Default Title
</h1>
Обидва підходи можна використовувати в одному шаблоні.
Керування редагуванням
Для сторінок можна налаштувати blockEditingMode та templateLock, щоб визначити, що користувачі можуть змінювати:
{
"name": "landing",
"title": "Landing Page",
"blockEditingMode": "contentOnly",
"templateLock": "all"
}
Так структура сторінки залишається заблокованою, але користувачі можуть редагувати текст і медіафайли. Окремі елементи можуть перевизначати параметр сторінки за допомогою атрибута blockEditingMode у шаблоні.
Прив’язування до ID записів
Скористайтеся postId, щоб прив’язати шаблон сторінки до наявного запису WordPress. Це запобігає створенню дублікатів сторінок і гарантує, що шаблон завжди оновлюватиме потрібний запис:
{
"name": "home",
"title": "Home",
"postId": 2
}
Докладніше дивіться в документації про сторінки.
Патерни на основі файлів
Як і сторінки, патерни блоків тепер можна описувати у файлових шаблонах. Створіть патерн у HTML, а Blockstudio перетворить його на розмітку блоків і зареєструє як рідний патерн блоків WordPress. Він з’явиться у вставці блоків, і користувачі зможуть розмістити його будь-де.
{
"name": "hero-section",
"title": "Hero Section",
"categories": ["featured"],
"keywords": ["hero", "banner"]
}
<div class="hero">
<h1>Welcome</h1>
<p>Get started today.</p>
</div>
На відміну від сторінок, патерни не створюють записів у базі даних. Вони реєструються в пам’яті під час кожного завантаження сторінки. Докладніше дивіться в документації про патерни.
Парсер HTML у блоки
На основі нового парсера HTML працюють і сторінки, і патерни: він перетворює стандартні шаблони HTML на розмітку блоків WordPress. Він автоматично обробляє блоки-контейнери (наприклад, групи й колонки) та окремі блоки (наприклад, абзаци й заголовки). В основі парсера — архітектура рендерера на основі трейтів, яку легко розширити підтримкою додаткових типів блоків через фільтр blockstudio/parser/renderers:
add_filter( 'blockstudio/parser/renderers', function ( $renderers, $parser ) {
$renderers['acme/hero'] = function ( $element, $attrs, $parser ) {
$content = $parser->get_inner_html( $element );
$html = '<div class="acme-hero">' . $content . '</div>';
return array(
'blockName' => 'acme/hero',
'attrs' => $attrs,
'innerBlocks' => array(),
'innerHTML' => $html,
'innerContent' => array( $html ),
);
};
return $renderers;
}, 10, 2 );
Після реєстрації блок можна використовувати в шаблоні будь-якої сторінки чи патерна:
<block name="acme/hero" background="/hero.jpg">
<h1>Welcome to our site</h1>
</block>
Сховище
Тепер поля можуть зберігати значення в метаданих записів або параметрах сайту, а не лише в атрибутах блоків. Це важливе оновлення:
{
"id": "subtitle",
"type": "text",
"label": "Subtitle",
"storage": {
"type": "postMeta"
}
}
Зберігання значень у метаданих записів дає змогу:
- Вибирати записи за значеннями полів за допомогою
WP_Queryіmeta_query - Отримувати дані полів через REST API для безголових конфігурацій
- Передавати дані іншим плагінам, наприклад інструментам SEO, і кешувальним шарам
Також можна зберігати значення в таблиці параметрів для глобальних налаштувань усього сайту:
{
"id": "phone",
"type": "text",
"label": "Phone Number",
"storage": {
"type": "option",
"optionKey": "company_phone"
}
}
Повний опис API наведено в документації про сховище.
Користувацькі поля
Тепер визначення полів можна повторно використовувати в кількох блоках. Один раз визначте набір полів, а потім використовуйте його в будь-якому блоці. Це усуває дублювання, коли кілька блоків мають однакову структуру полів.
Створіть field.json у каталозі blockstudio:
{
"name": "hero",
"title": "Hero Section",
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
{ "id": "description", "type": "textarea", "label": "Description" }
]
}
Потім посилайтеся на нього в будь-якому блоці за допомогою префікса custom/:
{
"blockstudio": {
"attributes": [
{ "type": "custom/hero", "idStructure": "hero_{id}" }
]
}
}
Властивість idStructure додає префікс до ID кожного поля, тож heading стає hero_heading. Також можна перевизначати окремі властивості поля для кожного екземпляра за допомогою ключа overrides.
Дивіться документацію про користувацькі поля.
Tailwind CSS v4
Підтримку Tailwind повністю перебудовано для v4. Замість компіляції на клієнті через CDN і збереження на диску після збереження запису (підхід v6), Blockstudio 7 компілює Tailwind на сервері під час кожного запиту до фронтенду через TailwindPHP. Жодних Node.js, CLI чи кроків збирання.
Компіляція використовує кешування на основі кандидатів: Blockstudio виділяє всі назви класів CSS з фінального HTML, сортує їх і хешує разом із вашою конфігурацією CSS, а потім шукає файл у кеші. Однакові класи дають збіг у кеші, навіть якщо навколишній HTML змінюється (nonce, часові мітки, динамічний вміст).
Для конфігурації використовується синтаксис v4 Tailwind, у якому на першому місці CSS. Визначайте власні теми й класи-утиліти безпосередньо у своєму blockstudio.json або через фільтр blockstudio/tailwind/css:
add_filter('blockstudio/tailwind/css', function ($css) {
return $css . '
@theme {
--color-brand: #4f46e5;
}
@layer utilities {
.container-narrow {
max-width: 48rem;
margin-inline: auto;
}
}
';
});
У редакторі блоків вбудований скрипт Tailwind CDN показує попередній перегляд під час введення. Для типу поля classes доступне автодоповнення всіх утиліт Tailwind. На фронтенді завжди використовується скомпільований на сервері CSS, який вставляється як вбудований тег стилю перед </head>.
Повний опис налаштування дивіться в документації Tailwind.
Інтерактивність API
Тепер Blockstudio підтримує специфікацію WordPress інтерактивності API. Увімкніть її у своєму block.json:
{
"blockstudio": {
"interactivity": true
}
}
Додайте директиви data-wp-* до шаблону:
<div useBlockProps
data-wp-interactive="myBlock"
data-wp-context='{ "isOpen": false }'>
<button data-wp-on--click="actions.toggle"
data-wp-bind--aria-expanded="context.isOpen">
Toggle
</button>
<div data-wp-bind--hidden="!context.isOpen">
This content is toggled by the button.
</div>
</div>
І створіть script.js із логікою сховища:
import { store, getContext } from '@wordpress/interactivity';
store('myBlock', {
actions: {
toggle: () => {
const context = getContext();
context.isOpen = !context.isOpen;
},
},
});
Blockstudio обробляє importmap, завантаження модулів і директиви як на фронтенді, так і в редакторі блоків. Блоки, у яких використовуються лише декларативні директиви з data-wp-context (наприклад, data-wp-bind--hidden або data-wp-text), працюють без будь-якого JavaScript. На фронтенді також підтримується стан на стороні сервера через wp_interactivity_state().
Повний опис налаштування дивіться в документації про інтерактивність.
Аналіз вмісту SEO
За замовчуванням вміст полів динамічних блоків Blockstudio недоступний плагінам SEO. Blockstudio 7 виправляє це за допомогою автоматичної інтеграції з Yoast SEO, Rank Math і SEOPress. Текстові значення з полів text, textarea, richtext, wysiwyg і link (зокрема вкладених рядків репітера) витягуються для аналізу в кожному плагіні. Тепер плагіни SEO можуть належно аналізувати вміст ваших блоків на щільність ключових слів, читабельність та інші показники. Налаштування не потрібне.
Рядки репітера за замовчуванням
Поля репітера тепер підтримують властивість default із масивом попередньо заповнених рядків. Після вставлення блока репітер заповнюється заданими рядками та їхніми значеннями як у редакторі, так і на фронтенді:
{
"id": "features",
"type": "repeater",
"label": "Features",
"default": [
{ "title": "Fast", "icon": "bolt" },
{ "title": "Secure", "icon": "shield" }
],
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "icon", "type": "text", "label": "Icon" }
]
}
Властивість min також працює зі значеннями полів за замовчуванням: якщо для репітера задано min: 3, а для його внутрішніх полів — значення default, автоматично створені рядки попередньо заповнюються цими значеннями замість того, щоб залишатися порожніми.
Покращення та виправлення
minрепітера зі значеннями полів за замовчуванням: автоматично створені мінімальні рядки тепер використовують значення полів за замовчуванням як на фронтенді, так і в редакторі- Стилі редактора Tailwind: скомпільований Tailwind CSS тепер вставляється в iframe редактора блоків разом із CDN, тому власні правила
@applyі конфігурація теми працюють у редакторі - Файл контексту AI:
blockstudio-llm.txtперебудовано як статичний файл із повної документації v7 та дедуплікованих схем JSON (~48k токенів); динамічну генерацію з v6 вилучено - Винесення поля коду в окреме вікно: поле коду тепер можна відкрити в окремому вікні з незалежними скасуванням і повторенням дій та підсвічуванням синтаксису JavaScript
- Компіляція Tailwind v4 на сервері: дивіться розділ Tailwind вище
- Версія 3 API: блоки тепер правильно відображаються в редакторі з iframe, зокрема в редакторі сайту та адаптивних попередніх переглядах
- Точкова нотація для ресурсів: зрозуміліший спосіб називати файли з суфіксами ресурсів (
*.inline.css,*.editor.js,*.scoped.css) - Виправлено попередження
bs_render_block()відWP_Block_Supportsпід час використанняuseBlockProps - Виправлено ігнорування значень за замовчуванням умовними полями під час першого завантаження
- Виправлено видалення знаків долара з вмісту
<RichText />на фронтенді - Виправлено роботу функції
populateз таксономіями, зареєстрованими іншими плагінами - Виправлено помилку null у контекстах
optionsPopulateWPML
Внутрішня будова
Повне переписування
Це не рефакторинг і не просто очищення коду. Кожен клас написано з нуля. У результаті кодова база стала чистішою та модульнішою, її легше підтримувати й розширювати.
Сучасний PHP
Для Blockstudio 7 потрібна версія PHP 8.2 або новіша; у коді повсюдно використовуються сучасні оголошення типів.
Несумісні зміни
У версії 7.0 є кілька несумісних змін. Для більшості передбачено сумісні зі старими версіями резервні варіанти, але перед оновленням варто їх переглянути. Повний посібник із міграції дивіться в документації з міграції v7.
Назви хуків тепер у snake_case
Усі хуки PHP перейменовано з camelCase на snake_case відповідно до домовленостей ядра WordPress:
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
return ['my-stylesheet'];
});
// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
return ['my-stylesheet'];
});
Старі назви у форматі camelCase досі працюють, але ми радимо їх оновити.
Перемикач поля за замовчуванням вимкнений
Тепер для властивості switch за замовчуванням встановлено false замість true. У v6 у кожного поля перемикач був непомітно розташований на лівому краї та ввімкнений за замовчуванням. У v7 перемикач потрібно вмикати явно, а його стан позначається видимою піктограмою ока в назві поля. Якщо ви покладалися на поведінку перемикача за замовчуванням, додайте "switch": true до визначень полів.
Для назв файлів ресурсів використовується точкова нотація
У суфіксах ресурсів тепер використовуються крапки замість дефісів (style.inline.css замість style-inline.css). Старий формат із дефісами досі працює, але надалі рекомендовано використовувати крапки.
Префікс імпорту npm
В імпортах модулів ES тепер використовується npm: замість blockstudio/:
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";
// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";
Префікс blockstudio/ досі підтримується для зворотної сумісності.
Вилучені функції
Область адміністратора та редактор коду. Сторінку налаштувань адміністратора WordPress і вбудований редактор коду блоків вилучено. Тепер усі налаштування виконуються через фільтри blockstudio.json та PHP, тож конфігурація зберігається в системі контролю версій разом із блоками.
У попередніх версіях редактор коду допомагав переглядати блоки, але його можливості так і не зрівнялися зі справжнім середовищем розробки. Протягом років роботу над кількома функціями плагіна обмежували, бо редактор не міг їх підтримувати. Він також ніколи не мав замінити повноцінне інтегроване середовище розробки. Його вилучення дає змогу зосередити плагін на розробці на основі файлів без жодних компромісів.
Ліцензійний ключ. Більше не потрібен. Blockstudio безкоштовний і має відкритий вихідний код.
Бібліотека блоків. Вбудовану бібліотеку «Blockstudio Elements» (Gallery, Slider, Image Comparison, Code, Icon) вилучено. Це були готові демонстраційні блоки, що постачалися разом із плагіном. Якщо ви ними користувалися, скопіюйте папки блоків із v6 до каталогу blockstudio вашої теми.
Початок роботи
Встановіть Blockstudio 7 і створіть свій перший блок за лічені хвилини. Покрокову інструкцію дивіться в посібнику з початку роботи, а якщо оновлюєтеся з v6 — у v7посібнику з міграції.
Повний вихідний код розміщено на GitHub. Будемо раді повідомленням про проблеми, PR і відгукам.