Перейти к содержимому

Dennis · 7 февраля 2026 г.

Introducing Blockstudio 7

Blockstudio 7 вышел. Это крупнейший выпуск в истории проекта: кодовая база полностью переписана с нуля. Каждый класс, каждый хук и каждая строка кода созданы заново с упором на современные PHP, стандарты разработки WordPress и долгосрочную поддержку.

Но это не просто рефакторинг. В Blockstudio 7 появились важные возможности: страницы и паттерны на основе файлов, система хранения метаданных записей, интеграция с SEO и совершенно новый парсер HTML в блоки, на котором все это работает. Кроме того, Blockstudio теперь полностью бесплатный и с открытым исходным кодом.

Давайте разберем все новинки.

Бесплатный проект с открытым исходным кодом

Я работаю над Blockstudio с 2020 и за эти годы выпустил десятки версий. Пользователям он нравился, но найти подходящую рыночную нишу для коммерческого фреймворка блоков WordPress всегда было непросто.

Ситуацию изменили большие языковые модели. ИИ-помощники по программированию теперь достаточно хорошо пишут код блоков, но для работы им нужны чистые структуры на основе файлов. Разметка блоков WordPress громоздкая: сериализованные комментарии HTML со встроенными атрибутами JSON смешаны со структурой DOM. С этим непросто справиться людям, а языковым моделям еще сложнее.

Файловый подход Blockstudio с самого начала был призван упростить работу: block.json и шаблон PHP в одной папке. Без записей в базе данных, без React и без этапа сборки. С v7 этот подход идет еще дальше. Парсер HTML в блоки позволяет писать обычный HTML и автоматически преобразовывать его в корректную разметку блоков. Все остается в файловой системе. Записи в базу данных выполняются только при синхронизации страниц, явно запрошенной через PHP API или CLI; она выполняется на основе файловых шаблонов.

Сделать Blockstudio открытым исходным кодом — естественный следующий шаг. Чем больше LLM обучаются на Blockstudio коде, тем лучше они его генерируют. Открытая кодовая база, открытая документация и готовый файл контекста для ИИ, который может использовать любой инструмент, — так создаются лучшие условия для разработки WordPress с помощью ИИ.

Полная версия плагина доступна на GitHub всем желающим: её можно использовать, форкать и дополнять. Без лицензионных ключей, платного доступа и ограничений функций.

Новые возможности

Страницы на основе файлов

Это одно из самых крупных нововведений версии 7.0. Теперь можно создавать целые страницы WordPress в виде файловых шаблонов, которые синхронизируются с базой данных как нативный контент блоков при запуске синхронизации страниц API или CLI.

Создайте папку с page.json и файлом шаблона:

JSON
{
  "name": "about",
  "title": "About Us",
  "slug": "about",
  "postStatus": "publish"
}
PHP
<div class="about-page">
  <h1>About Us</h1>
  <p>Welcome to our site.</p>
</div>

Запустите wp bs pages sync, чтобы Blockstudio разобрал HTML на блоки WordPress и создал или обновил страницу в базе данных.

Объединение блоков по ключам

При синхронизации шаблонов пользовательские изменения обычно перезаписываются. Атрибут key решает эту проблему, сохраняя пользовательский контент при синхронизации:

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

HTML
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
  Default Title
</h1>

Оба подхода можно использовать в одном шаблоне.

Параметры редактирования

Для страниц можно задать blockEditingMode и templateLock, чтобы контролировать, что могут изменять пользователи:

JSON
{
  "name": "landing",
  "title": "Landing Page",
  "blockEditingMode": "contentOnly",
  "templateLock": "all"
}

Такая настройка блокирует структуру страницы, но позволяет пользователям редактировать текст и медиафайлы. Отдельные элементы могут переопределять настройку страницы с помощью атрибута blockEditingMode в шаблоне.

Привязка к ID записей

Используйте postId, чтобы привязать шаблон страницы к существующей записи типа WordPress. Это предотвратит создание дубликатов страниц и гарантирует, что шаблон всегда обновляет нужную запись:

JSON
{
  "name": "home",
  "title": "Home",
  "postId": 2
}

Подробности см. в документации по страницам.

Паттерны на основе файлов

Как и страницы, паттерны блоков теперь можно задавать в виде файловых шаблонов. Напишите паттерн в HTML, и Blockstudio преобразует его в разметку блоков и зарегистрирует как нативный паттерн блоков WordPress. Паттерны появятся в панели вставки блоков, и пользователи смогут размещать их где угодно.

JSON
{
  "name": "hero-section",
  "title": "Hero Section",
  "categories": ["featured"],
  "keywords": ["hero", "banner"]
}
HTML
<div class="hero">
  <h1>Welcome</h1>
  <p>Get started today.</p>
</div>

В отличие от страниц, шаблоны не создают записей в базе данных. Они регистрируются в памяти при каждой загрузке страницы. См. документацию по шаблонам.

Парсер HTML в блоки

Новые парсеры HTML обрабатывают как страницы, так и паттерны, преобразуя стандартные шаблоны HTML в разметку блоков WordPress. Они автоматически обрабатывают контейнерные блоки, например группы и колонки, а также самостоятельные блоки, например абзацы и заголовки. В парсере используется архитектура рендерера на основе трейтов, поэтому его легко расширять, добавляя поддержку других типов блоков через фильтр blockstudio/parser/renderers:

PHP
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 );

После регистрации блок можно использовать в шаблоне любой страницы или паттерна:

HTML
<block name="acme/hero" background="/hero.jpg">
  <h1>Welcome to our site</h1>
</block>

Хранилище

Теперь поля могут хранить значения в метаданных записей или параметрах сайта, а не только в атрибутах блоков. Это важное нововведение:

JSON
{
  "id": "subtitle",
  "type": "text",
  "label": "Subtitle",
  "storage": {
    "type": "postMeta"
  }
}

Если значения хранятся в метаданных записей, можно:

  • Выполнять запросы записей по значениям полей с помощью WP_Query и meta_query
  • Получать данные полей через REST API для безголовых конфигураций
  • Передавать данные другим плагинам, например инструментам SEO, и системам кэширования

Значения также можно хранить в таблице параметров для глобальных настроек сайта:

JSON
{
  "id": "phone",
  "type": "text",
  "label": "Phone Number",
  "storage": {
    "type": "option",
    "optionKey": "company_phone"
  }
}

Полное описание см. в документации по хранилищу API.

Пользовательские поля

Теперь определения полей можно повторно использовать в нескольких блоках. Задайте набор полей один раз и подключайте его к любому блоку. Это избавляет от дублирования, когда нескольким блокам нужна одинаковая структура полей.

Создайте field.json в каталоге blockstudio:

JSON
{
  "name": "hero",
  "title": "Hero Section",
  "attributes": [
    { "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
    { "id": "description", "type": "textarea", "label": "Description" }
  ]
}

Затем подключите его к любому блоку с помощью префикса custom/:

JSON
{
  "blockstudio": {
    "attributes": [
      { "type": "custom/hero", "idStructure": "hero_{id}" }
    ]
  }
}

Свойство idStructure добавляет свой префикс к идентификатору каждого поля, поэтому heading становится hero_heading. Также можно переопределять отдельные свойства поля для каждого экземпляра с помощью ключа overrides.

См. документацию по пользовательским полям.

Tailwind CSS v4

Поддержка Tailwind была полностью переработана для v4. Вместо компиляции на стороне клиента через CDN и сохранения на диск при сохранении записи (подход v6), Blockstudio 7 компилирует Tailwind на стороне сервера при каждом запросе к фронтенду через TailwindPHP. Не нужны ни Node.js, ни CLI, ни этап сборки.

Компиляция использует кэширование на основе найденных классов: Blockstudio извлекает все имена классов CSS из итогового HTML, сортирует их и создает хеш вместе с конфигурацией CSS, затем проверяет наличие файла в кэше. Для одинаковых классов используется одна и та же запись кэша, даже если окружающий HTML меняется (одноразовые коды, временные метки, динамический контент).

Для настройки используется синтаксис v4 Tailwind с подходом CSS-сначала. Создавайте пользовательские темы и классы-утилиты прямо в blockstudio.json или через фильтр blockstudio/tailwind/css:

PHP
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 Interactivity API. Включите ее в block.json:

JSON
{
  "blockstudio": {
    "interactivity": true
  }
}

Добавьте директивы data-wp-* в шаблон:

PHP
<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 с логикой хранилища:

JavaScript
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 с массивом предварительно заполненных строк. При вставке блока повторитель заполняется указанными строками и их значениями как в редакторе, так и во внешнем интерфейсе:

JSON
{
  "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 и конфигурация темы работают в редакторе
  • Файл контекста для ИИ: blockstudio-llm.txt пересобран как статический файл на основе полной документации v7 и дедуплицированных схем JSON (около 48 тыс. токенов), заменив динамическую генерацию из v6
  • Всплывающее окно поля кода: теперь поле кода можно открыть в отдельном окне с независимой отменой и повтором действий и подсветкой синтаксиса JavaScript
  • Компиляция Tailwind v4 на стороне сервера: см. раздел Tailwindвыше
  • Версия API 3: блоки теперь корректно отображаются в редакторе с iframe, включая редактор сайта и адаптивные предпросмотры
  • Точечная запись для ресурсов: более аккуратный способ именования файлов с суффиксами ресурсов (*.inline.css, *.editor.js, *.scoped.css)
  • Исправлено предупреждение bs_render_block() от WP_Block_Supports при использовании useBlockProps
  • Исправлена обработка условных полей: при первой загрузке они не учитывали значения по умолчанию
  • Исправлена проблема, из-за которой знаки доллара удалялись из содержимого <RichText /> на фронтенде
  • Исправлена работа функции populate с таксономиями, зарегистрированными другими плагинами
  • Исправлена ошибка null в контекстах optionsPopulate WPML

Как это устроено

Полная переработка

Это не рефакторинг и не косметическая чистка. Каждый класс переписан с нуля. В результате получилась более чистая и модульная кодовая база, которую проще поддерживать и расширять.

Современный PHP

Для Blockstudio 7 требуется PHP 8.2+, и в нем повсеместно используются современные объявления типов.

Несовместимые изменения

В выпуск 7.0, как и в любое крупное обновление версии, вошло несколько несовместимых изменений. Для большинства предусмотрены варианты, сохраняющие обратную совместимость, но перед обновлением их следует проверить. Полное руководство по миграции см. в документации v7.

Названия хуков теперь записываются в snake_case

Все хуки PHP переименованы из camelCase в snake_case в соответствии с соглашениями ядра WordPress:

PHP
// 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/:

JavaScript
// 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. Благодаря этому настройки хранятся в системе контроля версий вместе с блоками.

В ранних версиях редактор кода помогал предварительно просматривать блоки, но так и не сравнялся по возможностям с полноценной средой разработки. На протяжении многих лет некоторые функции плагина оставались недоступны, поскольку редактор не мог их поддерживать. Он также не мог заменить полноценную IDE. После его удаления плагин может полностью сосредоточиться на разработке на основе файлов без компромиссов.

Лицензионный ключ. Больше не нужен. Blockstudio бесплатный и с открытым исходным кодом.

Библиотека блоков. Встроенная библиотека «Blockstudio Elements» (галерея, слайдер, сравнение изображений, код, значок) удалена. В нее входили готовые примеры блоков, поставлявшиеся вместе с плагином. Если вы ими пользовались, скопируйте папки блоков из v6 в каталог blockstudio вашей темы.

Начало работы

Установите Blockstudio 7 и создайте свой первый блок за несколько минут. Пошаговая инструкция есть в руководстве «Начало работы», а если вы переходите с v6 — в руководстве по миграции v7.

Полный исходный код доступен на GitHub. Мы приветствуем сообщения об ошибках, запросы на изменение и отзывы.