
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](https://blockstudio.dev/uk/docs/dev/ai/), який може використовувати будь-який інструмент: так можна створити найкраще середовище для розробки WordPress за допомогою AI.

Повна версія плагіна доступна на [GitHub](https://github.com/inline0/blockstudio) для всіх охочих користуватися ним, створювати форки та робити внески. Жодних ліцензійних ключів, платних обмежень чи заблокованих функцій.

## Нові функції

### Сторінки на основі файлів

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

Створіть папку з `page.json` і файлом шаблону:

```json title="page.json"
{
  "name": "about",
  "title": "About Us",
  "slug": "about",
  "postStatus": "publish"
}
```

```php title="index.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 title="index.php"
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>
```

Блоки з однаковими ключами зберігають внесені користувачем зміни під час оновлення шаблону. Блоки без ключів повністю замінюються.

#### Прив’язки блоків

Замість ключів можна скористатися WordPress Core — [прив’язками блоків API](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-bindings/), щоб безпосередньо з’єднати блоки з метаданими запису. Це не функція Blockstudio, а рідна можливість WordPress API. Blockstudio просто передає атрибут `metadata` у згенеровану розмітку блока. Вміст зберігається в метаданих, а не в розмітці блоків, тож синхронізація шаблонів не знищує зміни користувачів. Дані також можна запитувати через `WP_Query` і отримувати через REST API.

```html title="index.php"
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
  Default Title
</h1>
```

Обидва підходи можна використовувати в одному шаблоні.

#### Керування редагуванням

Для сторінок можна налаштувати `blockEditingMode` та `templateLock`, щоб визначити, що користувачі можуть змінювати:

```json title="page.json"
{
  "name": "landing",
  "title": "Landing Page",
  "blockEditingMode": "contentOnly",
  "templateLock": "all"
}
```

Так структура сторінки залишається заблокованою, але користувачі можуть редагувати текст і медіафайли. Окремі елементи можуть перевизначати параметр сторінки за допомогою атрибута `blockEditingMode` у шаблоні.

#### Прив’язування до ID записів

Скористайтеся `postId`, щоб прив’язати шаблон сторінки до наявного запису WordPress. Це запобігає створенню дублікатів сторінок і гарантує, що шаблон завжди оновлюватиме потрібний запис:

```json title="page.json"
{
  "name": "home",
  "title": "Home",
  "postId": 2
}
```

Докладніше дивіться в [документації про сторінки](https://blockstudio.dev/uk/docs/pages-and-patterns/pages/).

### Патерни на основі файлів

Як і сторінки, патерни блоків тепер можна описувати у файлових шаблонах. Створіть патерн у HTML, а Blockstudio перетворить його на розмітку блоків і зареєструє як рідний патерн блоків WordPress. Він з’явиться у вставці блоків, і користувачі зможуть розмістити його будь-де.

```json title="pattern.json"
{
  "name": "hero-section",
  "title": "Hero Section",
  "categories": ["featured"],
  "keywords": ["hero", "banner"]
}
```

```html title="index.php"
<div class="hero">
  <h1>Welcome</h1>
  <p>Get started today.</p>
</div>
```

На відміну від сторінок, патерни не створюють записів у базі даних. Вони реєструються в пам’яті під час кожного завантаження сторінки. Докладніше дивіться в [документації про патерни](https://blockstudio.dev/uk/docs/pages-and-patterns/patterns/).

### Парсер HTML у блоки

На основі нового парсера HTML працюють і сторінки, і патерни: він перетворює стандартні шаблони HTML на розмітку блоків WordPress. Він автоматично обробляє блоки-контейнери (наприклад, групи й колонки) та окремі блоки (наприклад, абзаци й заголовки). В основі парсера — архітектура рендерера на основі трейтів, яку легко розширити підтримкою додаткових типів блоків через фільтр `blockstudio/parser/renderers`:

```php title="functions.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 title="index.php"
<block name="acme/hero" background="/hero.jpg">
  <h1>Welcome to our site</h1>
</block>
```

### Сховище

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

```json title="block.json"
{
  "id": "subtitle",
  "type": "text",
  "label": "Subtitle",
  "storage": {
    "type": "postMeta"
  }
}
```

Зберігання значень у метаданих записів дає змогу:

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

Також можна зберігати значення в таблиці параметрів для глобальних налаштувань усього сайту:

```json title="block.json"
{
  "id": "phone",
  "type": "text",
  "label": "Phone Number",
  "storage": {
    "type": "option",
    "optionKey": "company_phone"
  }
}
```

Повний опис API наведено в [документації про сховище](https://blockstudio.dev/uk/docs/blocks/storage/).

### Користувацькі поля

Тепер визначення полів можна повторно використовувати в кількох блоках. Один раз визначте набір полів, а потім використовуйте його в будь-якому блоці. Це усуває дублювання, коли кілька блоків мають однакову структуру полів.

Створіть `field.json` у каталозі blockstudio:

```json title="fields/hero/field.json"
{
  "name": "hero",
  "title": "Hero Section",
  "attributes": [
    { "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
    { "id": "description", "type": "textarea", "label": "Description" }
  ]
}
```

Потім посилайтеся на нього в будь-якому блоці за допомогою префікса `custom/`:

```json title="block.json"
{
  "blockstudio": {
    "attributes": [
      { "type": "custom/hero", "idStructure": "hero_{id}" }
    ]
  }
}
```

Властивість `idStructure` додає префікс до ID кожного поля, тож `heading` стає `hero_heading`. Також можна перевизначати окремі властивості поля для кожного екземпляра за допомогою ключа `overrides`.

Дивіться [документацію про користувацькі поля](https://blockstudio.dev/uk/docs/blocks/attributes/custom-fields/).

### Tailwind CSS v4

Підтримку Tailwind повністю перебудовано для v4. Замість компіляції на клієнті через CDN і збереження на диску після збереження запису (підхід v6), Blockstudio 7 компілює Tailwind на сервері під час кожного запиту до фронтенду через [TailwindPHP](https://github.com/dnnsjsk/tailwindphp). Жодних Node.js, CLI чи кроків збирання.

Компіляція використовує кешування на основі кандидатів: Blockstudio виділяє всі назви класів CSS з фінального HTML, сортує їх і хешує разом із вашою конфігурацією CSS, а потім шукає файл у кеші. Однакові класи дають збіг у кеші, навіть якщо навколишній HTML змінюється (nonce, часові мітки, динамічний вміст).

Для конфігурації використовується синтаксис v4 Tailwind, у якому на першому місці CSS. Визначайте власні теми й класи-утиліти безпосередньо у своєму `blockstudio.json` або через фільтр `blockstudio/tailwind/css`:

```php title="functions.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](https://blockstudio.dev/uk/docs/tailwind/).

### Інтерактивність API

Тепер Blockstudio підтримує специфікацію [WordPress інтерактивності API](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/). Увімкніть її у своєму block.json:

```json title="block.json"
{
  "blockstudio": {
    "interactivity": true
  }
}
```

Додайте директиви `data-wp-*` до шаблону:

```php title="index.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 title="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()`.

Повний опис налаштування дивіться в [документації про інтерактивність](https://blockstudio.dev/uk/docs/blocks/interactivity/).

### Аналіз вмісту SEO

За замовчуванням вміст полів динамічних блоків Blockstudio недоступний плагінам SEO. Blockstudio 7 виправляє це за допомогою автоматичної інтеграції з Yoast SEO, Rank Math і SEOPress. Текстові значення з полів `text`, `textarea`, `richtext`, `wysiwyg` і `link` (зокрема вкладених рядків репітера) витягуються для аналізу в кожному плагіні. Тепер плагіни SEO можуть належно аналізувати вміст ваших блоків на щільність ключових слів, читабельність та інші показники. Налаштування не потрібне.

### Рядки репітера за замовчуванням

Поля репітера тепер підтримують властивість `default` із масивом попередньо заповнених рядків. Після вставлення блока репітер заповнюється заданими рядками та їхніми значеннями як у редакторі, так і на фронтенді:

```json title="block.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` і конфігурація теми працюють у редакторі
- **[Файл контексту AI](https://blockstudio.dev/uk/docs/dev/ai/)**: `blockstudio-llm.txt` перебудовано як статичний файл із повної документації v7 та дедуплікованих схем JSON (~48k токенів); динамічну генерацію з v6 вилучено
- **Винесення поля коду в окреме вікно**: поле коду тепер можна відкрити в окремому вікні з незалежними скасуванням і повторенням дій та підсвічуванням синтаксису JavaScript
- **Компіляція Tailwind v4 на сервері**: дивіться розділ [Tailwind вище](#tailwind-css-v4)
- **Версія 3 API**: блоки тепер правильно відображаються в редакторі з 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](https://blockstudio.dev/uk/docs/dev/migration/v7/).

### Назви хуків тепер у snake_case

Усі хуки PHP перейменовано з camelCase на snake_case відповідно до домовленостей ядра WordPress:

```php title="functions.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 title="script.js"
// 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 і створіть свій перший блок за лічені хвилини. Покрокову інструкцію дивіться в [посібнику з початку роботи](https://blockstudio.dev/uk/docs/general/getting-started/), а якщо оновлюєтеся з v6 — у [v7посібнику з міграції](https://blockstudio.dev/uk/docs/dev/migration/v7/).

Повний вихідний код розміщено на [GitHub](https://github.com/inline0/blockstudio). Будемо раді повідомленням про проблеми, PR і відгукам.
