
Blockstudio 7 je tu. Ide o najväčšie vydanie v histórii projektu: kompletné prepísanie celej kódovej základne od základov. Každá trieda, každý hook aj každý riadok kódu vznikli nanovo so zameraním na moderné PHP, štandardy kódovania WordPress a dlhodobú udržateľnosť.

Nejde však len o refaktoring. Blockstudio 7 prináša významné nové funkcie, ako sú stránky a vzory založené na súboroch, systém ukladania metadát príspevkov, integrácia SEO a úplne nový parser HTML na bloky, ktorý to všetko poháňa. Navyše je teraz Blockstudio úplne zadarmo a s otvoreným zdrojovým kódom.

Pozrime sa na všetky novinky.

## Zadarmo a s otvoreným zdrojovým kódom

Na Blockstudio pracujem od 2020 a za tie roky som vydal desiatky verzií. Ľudia, ktorí ho používali, si ho obľúbili, no nájsť vhodný trh pre komerčný blokový framework WordPress bolo vždy náročné.

Rovnováhu zmenili veľké jazykové modely (LLM). Asistenti na programovanie s umelou inteligenciou už dokážu písať kód blokov, potrebujú však čistú štruktúru založenú na súboroch. Značky blokov WordPress sú neprehľadné: serializované komentáre HTML so vloženými atribútmi JSON, zmiešané so štruktúrou DOM. Ľudia sa v nich orientujú ťažko a pre LLM je ešte náročnejšie vytvoriť ich správne.

Prístup Blockstudio založený predovšetkým na súboroch bol vždy navrhnutý tak, aby veci zostali jednoduché: `block.json` a šablóna PHP v priečinku. Žiadne záznamy v databáze, žiadne React, žiadny krok zostavenia. Vďaka v7 ide táto filozofia ešte ďalej. Parser HTML na bloky umožňuje písať obyčajný HTML, ktorý sa automaticky prevedie na platné značky blokov. Všetko zostáva v súborovom systéme. Zápisy do databázy sa vykonávajú len pri synchronizácii stránok, ktorú výslovne vyžiadate cez PHP API alebo CLI; túto synchronizáciu riadia šablóny súborov.

Sprístupnenie Blockstudio ako open source je prirodzeným ďalším krokom. Čím viac sa LLM trénujú na kóde Blockstudio, tým lepšie ho dokážu generovať. Otvorená kódová základňa, otvorená dokumentácia a vopred pripravený súbor kontextu pre AI [, ktorý dokáže použiť každý nástroj](https://blockstudio.dev/sk/docs/dev/ai/): takto vytvoríte najlepšie prostredie na vývoj s pomocou AI WordPress.

Celý plugin je dostupný na [GitHub](https://github.com/inline0/blockstudio) pre každého, kto ho chce používať, vytvárať jeho vlastné vetvy a prispievať doň. Žiadne licenčné kľúče, žiadne platené obmedzenia ani uzamknuté funkcie.

## Nové funkcie

### Stránky založené na súboroch

Ide o jednu z najväčších noviniek verzie 7.0. Teraz môžete celé stránky WordPress definovať ako šablóny súborov, ktoré sa po spustení synchronizácie stránok API alebo CLI synchronizujú s databázou ako natívny obsah blokov.

Vytvorte priečinok so súborom `page.json` a súborom šablóny:

```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>
```

Spustením príkazu `wp bs pages sync` necháte Blockstudio analyzovať HTML, previesť ho na bloky WordPress a vytvoriť alebo aktualizovať stránku v databáze.

#### Zlučovanie blokov podľa kľúča

Pri synchronizácii šablón by sa úpravy používateľa za bežných okolností prepísali. Atribút `key` tomu zabraňuje tým, že pri synchronizácii zachováva obsah upravený používateľom:

```html title="index.php"
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>
```

Bloky so zhodnými kľúčmi si pri aktualizácii šablóny zachovajú obsah upravený používateľom. Bloky bez kľúčov sa úplne nahradia.

#### Väzby blokov

Namiesto kľúčov môžete použiť aj natívne WordPress Väzby blokov [API](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-bindings/), ktoré prepájajú bloky priamo s metadátami príspevku. Nejde o funkciu Blockstudio, ale o natívne WordPress API. Blockstudio jednoducho prenáša atribút `metadata` do vygenerovaných značiek bloku. Obsah sa ukladá do metadát, nie do značiek bloku, takže synchronizácia šablón nikdy nezničí úpravy používateľa. Údaje možno tiež vyhľadávať cez `WP_Query` a sú dostupné prostredníctvom REST API.

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

Oba prístupy možno použiť v tej istej šablóne.

#### Ovládacie prvky úprav

Stránky podporujú `blockEditingMode` a `templateLock`, ktorými určíte, čo môžu používatelia upravovať:

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

Štruktúra stránky sa tým uzamkne, používatelia však naďalej môžu upravovať text a médiá. Jednotlivé prvky môžu nastavenie celej stránky prepísať pomocou atribútu `blockEditingMode` v šablóne.

#### Priradenie k ID príspevkov

Pomocou `postId` môžete prepojiť šablónu stránky s existujúcim príspevkom WordPress, čím zabránite vzniku duplicitných stránok a zaistíte, že šablóna bude vždy aktualizovať správny príspevok:

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

Všetky podrobnosti nájdete v [dokumentácii k stránkam](https://blockstudio.dev/sk/docs/pages-and-patterns/pages/).

### Vzory založené na súboroch

Podobne ako stránky môžete teraz definovať vzory blokov ako šablóny súborov. Napíšte vzor do HTML a Blockstudio ho prevedie na značky blokov a zaregistruje ako natívny vzor bloku WordPress. Zobrazí sa v nástroji na vkladanie blokov a používatelia ho môžu umiestniť kdekoľvek.

```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>
```

Na rozdiel od stránok vzory nevytvárajú záznamy v databáze. Registrujú sa v pamäti pri každom načítaní stránky. Pozrite si [dokumentáciu k vzorom](https://blockstudio.dev/sk/docs/pages-and-patterns/patterns/).

### Parser HTML na bloky

Stránky aj vzory využívajú nový parser HTML, ktorý prevádza štandardné šablóny HTML na značky blokov WordPress. Automaticky spracuje kontajnerové bloky (napríklad skupiny a stĺpce) aj koncové bloky (napríklad odseky a nadpisy). Parser používa architektúru vykresľovania založenú na traitoch, takže ho možno jednoducho rozšíriť o podporu ďalších typov blokov pomocou filtra `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 );
```

Po registrácii môžete blok použiť v ľubovoľnej šablóne stránky alebo vzoru:

```html title="index.php"
<block name="acme/hero" background="/hero.jpg">
  <h1>Welcome to our site</h1>
</block>
```

### Úložisko

Polia teraz môžu okrem atribútov blokov ukladať svoje hodnoty aj do metadát príspevkov alebo do možností webu. Ide o významnú novinku:

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

Ak sú hodnoty uložené v metadátach príspevkov, môžete:

- Vyhľadávať príspevky podľa hodnôt polí pomocou `WP_Query` a `meta_query`
- Pristupovať k údajom polí cez REST API v riešeniach bez frontendu
- Zdieľať údaje s ďalšími pluginmi, ako sú nástroje SEO, a vrstvami ukladania do vyrovnávacej pamäte

Hodnoty môžete ukladať aj do tabuľky možností pre globálne nastavenia platné pre celý web:

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

Všetky podrobnosti nájdete v [dokumentácii k ukladaniu](https://blockstudio.dev/sk/docs/blocks/storage/), kde je celý API.

### Vlastné polia

Opakovane použiteľné definície polí možno teraz zdieľať medzi viacerými blokmi. Raz definujte skupinu polí a potom na ňu odkazujte z ľubovoľného bloku. Ak viacero blokov používa rovnakú štruktúru polí, nebudete musieť túto definíciu opakovať.

Vytvorte `field.json` v priečinku 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" }
  ]
}
```

Potom naň odkazujte z ľubovoľného bloku pomocou predpony `custom/`:

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

Vlastnosť `idStructure` pridá predponu ku každému ID poľa, takže `heading` sa zmení na `hero_heading`. Pomocou kľúča `overrides` môžete tiež pre každú inštanciu prepísať jednotlivé vlastnosti polí.

Pozrite si [dokumentáciu k vlastným poliam](https://blockstudio.dev/sk/docs/blocks/attributes/custom-fields/).

### Tailwind CSS v4

Podpora Tailwind bola pre v4 kompletne prepracovaná. Namiesto kompilácie na strane klienta cez CDN a ukladania na disk pri ukladaní príspevku (prístup v6) Blockstudio 7 kompiluje Tailwind na strane servera pri každej požiadavke na frontend pomocou [TailwindPHP](https://github.com/dnnsjsk/tailwindphp). Bez Node.js, bez CLI a bez potreby zostavovania.

Kompilácia využíva ukladanie do vyrovnávacej pamäte podľa kandidátov: Blockstudio získa všetky názvy tried CSS z výsledného HTML, zoradí ich a spolu s konfiguráciou CSS vytvorí hash, podľa ktorého vyhľadá súbor vo vyrovnávacej pamäti. Rovnaké triedy znamenajú rovnaký nájdený záznam, aj keď sa okolitý HTML zmení (nonce, časové značky či dynamický obsah).

Konfigurácia používa syntax CSS-first z Tailwind v4. Vlastné témy a pomocné triedy môžete definovať priamo v `blockstudio.json` alebo cez filter `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;
      }
    }
  ';
});
```

V editore blokov poskytuje pribalený skript Tailwind CDN živý náhľad počas písania. Typ poľa `classes` ponúka automatické dopĺňanie všetkých pomocných tried Tailwind. Frontend vždy používa CSS skompilované na serveri, vložené ako vnorený štýlový tag pred `</head>`.

Kompletné nastavenie nájdete v [dokumentácii Tailwind](https://blockstudio.dev/sk/docs/tailwind/).

### Interaktivita API

Blockstudio teraz podporuje
[WordPress Interaktivitu API](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/).
Povoľte ju v block.json:

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

Pridajte do šablóny direktívy `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>
```

A vytvorte `script.js` s logikou svojho úložiska:

```javascript title="script.js"
import { store, getContext } from '@wordpress/interactivity';

store('myBlock', {
  actions: {
    toggle: () => {
      const context = getContext();
      context.isOpen = !context.isOpen;
    },
  },
});
```

Blockstudio spravuje importmap, načítavanie modulov a spracovanie direktív na frontende aj v editore blokov. Bloky, ktoré používajú iba deklaratívne direktívy s `data-wp-context` (napríklad `data-wp-bind--hidden` alebo `data-wp-text`), fungujú úplne bez JavaScript. Na frontende je podporovaný aj stav na strane servera cez `wp_interactivity_state()`.

Kompletné nastavenie nájdete v [dokumentácii k interaktivite](https://blockstudio.dev/sk/docs/blocks/interactivity/).

### Analýza obsahu SEO

Bloky Blockstudio sú dynamické, preto ich obsah polí nie je predvolene viditeľný pre pluginy SEO. Blockstudio 7 to rieši automatickou integráciou s Yoast SEO, Rank Math a SEOPress. Textové hodnoty z polí `text`, `textarea`, `richtext`, `wysiwyg` a `link` (vrátane vnorených riadkov opakujúcich polí) sa získajú a odovzdajú každému pluginu na analýzu obsahu. Pluginy SEO teraz môžu správne analyzovať obsah vašich blokov z hľadiska hustoty kľúčových slov, čitateľnosti a ďalších ukazovateľov. Nie je potrebná žiadna konfigurácia.

### Predvolené riadky opakujúceho poľa

Polia opakovača teraz podporujú vlastnosť `default` s poľom vopred vyplnených riadkov. Po vložení bloku sa opakovač naplní určenými riadkami a ich hodnotami v editore aj na frontende:

```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" }
  ]
}
```

Vlastnosť `min` funguje aj s predvolenými hodnotami na úrovni polí: ak má opakovač `min: 3` a jeho vnútorné polia majú hodnoty `default`, automaticky vytvorené riadky sa vopred vyplnia týmito hodnotami namiesto toho, aby zostali prázdne.

## Vylepšenia a opravy

- **Opakovač `min` s predvolenými hodnotami polí**: automaticky vytvorené minimálne riadky teraz používajú predvolené hodnoty na úrovni polí na frontende aj v editore
- **Štýly editora Tailwind**: skompilované Tailwind CSS sa teraz vkladá do rámca editora blokov spolu s CDN, takže vlastné pravidlá `@apply` a konfigurácia témy fungujú aj v editore
- **[Súbor kontextu AI](https://blockstudio.dev/sk/docs/dev/ai/)**: `blockstudio-llm.txt` bol vytvorený nanovo ako statický súbor zostavený z celej dokumentácie v7 a deduplikovaných schém JSON (približne 48-tisíc tokenov), ktorý nahrádza dynamické generovanie z v6
- **Vyskakovacie okno poľa kódu**: pole kódu možno teraz otvoriť v samostatnom okne s nezávislým vrátením a opakovaním akcií a zvýrazňovaním syntaxe JavaScript
- **Kompilácia Tailwind v4 na strane servera**: pozrite si vyššie uvedenú časť [Tailwind](#tailwind-css-v4)
- **Verzia API 3**: bloky sa teraz správne vykresľujú v editore v ráme vrátane editora webu a responzívnych náhľadov
- **Bodková notácia pre prostriedky**: prehľadnejšie pomenovanie súborov pre prípony prostriedkov (`*.inline.css`, `*.editor.js`, `*.scoped.css`)
- Opravené upozornenie `bs_render_block()` z `WP_Block_Supports` pri použití `useBlockProps`
- Opravené nerešpektovanie predvolených hodnôt podmienenými poľami pri prvom načítaní
- Opravené odstraňovanie znakov dolára z obsahu `<RichText />` na frontende
- Opravené fungovanie funkcie `populate` s taxonómiami zaregistrovanými inými pluginmi
- Opravená chyba `optionsPopulate` null v kontextoch WPML

## Pod pokrievkou

### Kompletné prepísanie

Nejde o refaktoring ani upratovanie kódu. Každá trieda bola napísaná od základu nanovo. Výsledkom je prehľadnejšia a modulárnejšia kódová základňa, ktorú možno jednoduchšie udržiavať a rozširovať.

### Moderné PHP

Blockstudio 7 vyžaduje PHP 8.2+ a v celom kóde používa moderné deklarácie typov.

## Zmeny, ktoré môžu narušiť kompatibilitu

Ako aktualizácia hlavnej verzie prináša verzia 7.0 niekoľko nekompatibilných zmien. Väčšina má záložné riešenia kompatibilné so staršími verziami, no pred aktualizáciou by ste si ich mali preštudovať. Úplný návod na migráciu nájdete v migračnej dokumentácii [v7](https://blockstudio.dev/sk/docs/dev/migration/v7/).

### Názvy hookov teraz používajú snake_case

Všetky hooky PHP boli premenované z camelCase na snake_case v súlade so zvyklosťami jadra 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'];
});
```

Staré názvy camelCase stále fungujú, odporúčame vám ich však aktualizovať.

### Prepínač poľa je predvolene vypnutý

Vlastnosť `switch` má teraz predvolenú hodnotu `false` namiesto `true`. Vo verzii v6 malo každé pole na ľavom okraji neviditeľný prepínač, ktorý bol predvolene zapnutý. Vo verzii v7 je prepínač voliteľný a v označení poľa používa viditeľnú ikonu oka. Ak ste sa spoliehali na predvolené správanie prepínača, pridajte do definícií polí `"switch": true`.

### Bodková notácia pri názvoch súborov prostriedkov

Prípony prostriedkov teraz používajú bodky namiesto pomlčiek (`style.inline.css` namiesto `style-inline.css`). Starý zápis s pomlčkou stále funguje, odporúčaným štandardom do budúcnosti je však bodková notácia.

### Predpona importu npm

Importy modulov ES teraz používajú `npm:` namiesto `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";
```

Predpona `blockstudio/` je naďalej podporovaná kvôli spätnej kompatibilite.

### Odstránené funkcie

**Oblasť správcu a editor kódu.** Stránka nastavení správcu WordPress aj vstavaný editor kódu blokov boli odstránené. Celá konfigurácia sa teraz vykonáva cez filtre `blockstudio.json` a PHP, takže nastavenie je uložené v systéme správy verzií spolu s vašimi blokmi.

Editor kódu bol v starších verziách užitočný na zobrazovanie náhľadu blokov, nikdy však nedosiahol úplnú rovnocennosť s reálnym vývojovým prostredím. Niektoré funkcie pluginu boli celé roky obmedzené, pretože ich nebolo možné podporovať v samostatnom editore. Navyše nikdy nemal nahradiť plnohodnotné IDE. Jeho odstránenie umožňuje pluginu sústrediť sa výlučne na vývoj založený na súboroch bez kompromisov.

**Licenčný kľúč.** Už ho nepotrebujete. Blockstudio je zadarmo a s otvoreným zdrojovým kódom.

**Knižnica blokov.** Vstavaná knižnica „Blockstudio Elements“ (galéria, posuvník, porovnanie obrázkov, kód, ikona) bola odstránená. Išlo o vopred pripravené ukážkové bloky dodávané s pluginom. Ak ste ich používali, skopírujte priečinky blokov z v6 do priečinka blockstudio vo svojej téme.

## Začíname

Nainštalujte Blockstudio 7 a vytvorte svoj prvý blok za pár minút. Pozrite si
[príručku Začíname](https://blockstudio.dev/sk/docs/general/getting-started/), ktorá vás prevedie jednotlivými krokmi,
alebo [príručku migrácie na v7](https://blockstudio.dev/sk/docs/dev/migration/v7/), ak prechádzate z v6.

Celý zdrojový kód nájdete na [GitHub](https://github.com/inline0/blockstudio). Uvítame hlásenia problémov, príspevky do projektu aj spätnú väzbu.
