
Blockstudio 7 е тук. Това е най-голямото издание в историята на проекта: цялостно пренаписване на кодовата база от нулата. Всеки клас, всеки hook и всеки ред код са изградени наново с фокус върху съвременния PHP, стандартите за програмиране на WordPress и дългосрочната поддръжка.

Но това не е просто рефакториране. Blockstudio 7 въвежда важни нови функции като файлово базирани страници и шаблони, система за съхранение на post meta, интеграция с 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/bg/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>
```

Блоковете със съвпадащи ключове запазват редактираното от потребителя съдържание, когато шаблонът се актуализира. Блоковете без ключове се заменят изцяло.

#### Обвързвания на блокове

Като алтернатива на ключовете можете да използвате [Block Bindings API](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-bindings/) на ядрото на WordPress, за да свържете блокове директно с post meta. Това не е функция на Blockstudio, а собствена WordPress API. Blockstudio просто предава атрибута `metadata` към генерираната блокова маркировка. Съдържанието се съхранява в meta, а не в блоковата маркировка, така че синхронизациите на шаблони никога не изтриват редакциите на потребителите. Данните могат да се заявяват и чрез `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` в шаблона.

#### Закачане към идентификатори на публикации

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

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

За пълни подробности вижте [документацията за страниците](https://blockstudio.dev/bg/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/bg/docs/pages-and-patterns/patterns/).

### Парсер от HTML към блокове

Нов парсер HTML задвижва както страниците, така и шаблоните, като преобразува стандартните шаблони HTML в блокова маркировка WordPress. Той автоматично обработва контейнерни блокове (като групи и колони) и крайни блокове (като абзаци и заглавия). Парсерът използва архитектура за визуализиране, базирана на trait-и, което улеснява добавянето на поддръжка за други типове блокове чрез филтъра `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>
```

### Хранилище

Полета вече могат да съхраняват стойностите си в post meta или в настройките на сайта, наред с атрибутите на блоковете. Това е важно допълнение:

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

Когато стойностите са в post meta, можете:

- Да заявявате публикации по стойности на полета с `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/bg/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` поставя префикс пред всеки идентификатор на поле, така че `heading` става `hero_heading`. Можете също да заменяте отделни свойства на полетата за всеки екземпляр чрез ключа `overrides`.

Вижте [документацията за персонализирани полета](https://blockstudio.dev/bg/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 стойности, времеви отметки, динамично съдържание).

Конфигурацията използва синтаксиса с приоритет на CSS в Tailwind v4. Дефинирайте персонализирани теми и помощни класове директно в `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/bg/docs/tailwind/).

### Интерактивност API

Blockstudio вече поддържа [Interactivity WordPressAPI](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/bg/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/bg/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 в контексти WPML на `optionsPopulate`

## Под капака

### Пълно пренаписване

Това не е рефакториране или просто почистване на кода. Всеки клас е пренаписан от нулата. Резултатът е по-изчистена и по-модулна кодова база, която се поддържа и разширява по-лесно.

### Съвременен PHP

Blockstudio 7 изисква PHP 8.2+ и използва съвременни декларации на типове навсякъде.

## Несъвместими промени

Като основно издание, версия 7.0 включва няколко несъвместими промени. Повечето имат резервни варианти за обратна съвместимост, но трябва да ги прегледате преди надграждане. Пълното ръководство за миграция ще намерите в [документацията за миграция на v7](https://blockstudio.dev/bg/docs/dev/migration/v7/).

### Имената на hook-овете вече използват snake_case

Всички hook-ове на 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/bg/docs/general/getting-started/) за инструкции стъпка по стъпка или [ръководството за миграция на v7](https://blockstudio.dev/bg/docs/dev/migration/v7/), ако надграждате от v6.

Целият изходен код е в [GitHub](https://github.com/inline0/blockstudio). Добре дошли са сигнали за проблеми, PR-и и обратна връзка.
