
Blockstudio 7 je tady. Jde o největší vydání v historii projektu: kompletní přepsání celé kódové základny od základů. Každá třída, každý háček i každý řádek kódu byly vytvořeny znovu se zaměřením na moderní PHP, standardy kódování WordPress a dlouhodobou udržovatelnost.

Nejde ale jen o refaktoring. Blockstudio 7 přináší zásadní nové funkce, například stránky a vzory založené na souborech, systém ukládání metadat příspěvků, integraci SEO a zcela nový parser HTML na bloky, který vše pohání. Navíc je nyní Blockstudio zcela zdarma a jako open source.

Pojďme se podívat na všechny novinky.

## Zdarma a jako open source

Na Blockstudio pracuji od 2020 a za ta léta jsem vydal desítky verzí. Lidé, kteří jej používali, si ho oblíbili, ale najít tržní uplatnění pro komerční framework bloků WordPress bylo vždy náročné.

Rovnováhu změnily LLM. Asistenti pro programování s AI už umí psát kód bloků dostatečně dobře, ale potřebují přehlednou strukturu založenou na souborech. Značky bloků WordPress jsou nepřehledné: serializované komentáře HTML s vloženými atributy JSON, promíchané se strukturou DOM. Lidé v tom mají problém se vyznat a LLM ještě víc.

Přístup Blockstudio, který staví soubory na první místo, byl vždy navržen tak, aby vše zůstalo jednoduché: `block.json` a šablona PHP ve složce. Žádné záznamy v databázi, žádné React, žádný krok sestavení. S v7 jde tato filozofie ještě dál. Parser HTML na bloky umožňuje psát prosté HTML, které se automaticky převede na platné značky bloků. Vše zůstává v souborovém systému. Zápisy do databáze probíhají pouze při synchronizaci stránek výslovně vyžádané přes PHP API nebo CLI; ty vycházejí ze šablon souborů.

Zveřejnění Blockstudio jako open source je přirozeným dalším krokem. Čím více kódu Blockstudio se LLM naučí, tím lépe jej budou generovat. Otevřená kódová základna, otevřená dokumentace a předpřipravený [kontextový soubor pro AI](https://blockstudio.dev/cs/docs/dev/ai/), který mohou používat libovolné nástroje: tak vytvoříte nejlepší prostředí pro vývoj WordPress s pomocí AI.

Celý plugin je k dispozici na [GitHub](https://github.com/inline0/blockstudio), kde jej může kdokoli používat, rozvětvit a přispívat do něj. Žádné licenční klíče, žádné placené bariéry, žádné uzamčené funkce.

## Nové funkce

### Stránky založené na souborech

Jde o jednu z největších novinek verze 7.0. Nyní můžete definovat celé stránky WordPress jako šablony souborů, které se po spuštění příkazu API nebo CLI pro synchronizaci stránek synchronizují do databáze jako nativní obsah bloků.

Vytvořte složku se souborem `page.json` a souborem šablony:

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

Spuštěním `wp bs pages sync` nechte Blockstudio zpracovat HTML na bloky WordPress a vytvořit nebo aktualizovat stránku v databázi.

#### Sloučení bloků podle klíče

Při synchronizaci šablon by se úpravy uživatelů běžně přepsaly. Atribut `key` tomu zabrání a zachová uživatelský obsah i po synchronizaci:

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

Bloky se shodnými klíči si při aktualizaci šablony zachovají uživatelský obsah. Bloky bez klíčů se zcela nahradí.

#### Vazby bloků

Jako alternativu ke klíčům můžete použít [vazby bloků API](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-bindings/) jádra WordPress, které propojí bloky přímo s metadaty příspěvků. Nejde o funkci Blockstudio, ale o nativní WordPress API. Blockstudio pouze předává atribut `metadata` do vygenerovaných značek bloku. Obsah je uložen v metadatech místo značek bloku, takže synchronizace šablon nikdy nezničí uživatelské úpravy. Data lze také vyhledávat přes `WP_Query` a jsou dostupná prostřednictvím REST API.

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

Oba přístupy lze použít v téže šabloně.

#### Ovládací prvky úprav

Stránky podporují `blockEditingMode` a `templateLock`, kterými lze určit, co mohou uživatelé měnit:

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

Struktura stránky se tím uzamkne, uživatelé však mohou upravovat text a média. Jednotlivé prvky mohou nastavení celé stránky přepsat atributem `blockEditingMode` v šabloně.

#### Přiřazení k ID příspěvku

Pomocí `postId` můžete navázat šablonu stránky na existující příspěvek WordPress, zabránit vzniku duplicitních stránek a zajistit, aby šablona vždy aktualizovala správný příspěvek:

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

Podrobnosti najdete v [dokumentaci ke stránkám](https://blockstudio.dev/cs/docs/pages-and-patterns/pages/).

### Vzory založené na souborech

Podobně jako stránky nyní můžete definovat vzory bloků jako šablony souborů. Napište vzor v HTML a Blockstudio jej převede na značky bloků a zaregistruje jako nativní vzor bloku WordPress. Zobrazí se ve vkladači bloků a uživatelé je mohou umístit kamkoli.

```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 rozdíl od stránek vzory nevytvářejí záznamy v databázi. Registrují se v paměti při každém načtení stránky. Viz [dokumentace ke vzorům](https://blockstudio.dev/cs/docs/pages-and-patterns/patterns/).

### Parser HTML na bloky

Stránky i vzory využívají nový parser HTML, který převádí standardní šablony HTML na značky bloků WordPress. Automaticky zpracovává kontejnerové bloky, jako jsou skupiny a sloupce, i samostatné bloky, například odstavce a nadpisy. Parser využívá architekturu vykreslování založenou na trait, takže lze snadno přidat podporu dalších typů bloků pomocí filtru `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 registraci můžete blok použít v libovolné šabloně stránky nebo vzoru:

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

### Úložiště

Pole nyní mohou kromě atributů bloku ukládat své hodnoty také do metadat příspěvků nebo možností webu. Tohle je velká novinka:

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

Hodnoty v metadatech příspěvků umožňují:

- Vyhledávat příspěvky podle hodnot polí pomocí `WP_Query` a `meta_query`
- Přistupovat k datům polí přes REST API pro bezhlavé instalace
- Sdílet data s dalšími pluginy, například nástroji SEO a vrstvami mezipaměti

Hodnoty můžete také ukládat do tabulky možností pro globální nastavení platná pro celý web:

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

Úplné informace najdete v [dokumentaci úložiště](https://blockstudio.dev/cs/docs/blocks/storage/) pro celé API.

### Vlastní pole

Opakovaně použitelné definice polí lze nyní sdílet mezi několika bloky. Jednou definujte sadu polí a pak na ni odkazujte z libovolného bloku. Odpadne tak opakování, když více bloků používá stejnou strukturu polí.

Vytvořte soubor `field.json` v adresáři 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" }
  ]
}
```

Pak na něj odkažte z libovolného bloku pomocí předpony `custom/`:

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

Vlastnost `idStructure` předřadí každému ID pole tento prefix, takže `heading` se změní na `hero_heading`. Vlastnosti jednotlivých polí můžete také přepsat pro konkrétní instanci pomocí klíče `overrides`.

Viz [dokumentace k vlastním polím](https://blockstudio.dev/cs/docs/blocks/attributes/custom-fields/).

### Tailwind CSS v4

Podpora Tailwind byla pro v4 kompletně přepracována. Namísto kompilace na straně klienta přes CDN a ukládání na disk při uložení příspěvku (přístup v6) nyní Blockstudio 7 kompiluje Tailwind na straně serveru při každém požadavku na frontend prostřednictvím [TailwindPHP](https://github.com/dnnsjsk/tailwindphp). Není potřeba Node.js, CLI ani krok sestavení.

Kompilace využívá ukládání do mezipaměti podle kandidátů: Blockstudio extrahuje z výsledného HTML všechny názvy tříd CSS, seřadí je a vytvoří jejich hash společně s konfigurací CSS, poté vyhledá soubor v mezipaměti. Stejné třídy vedou k nalezení stejné položky v mezipaměti, i když se okolní HTML změní (nonce, časová razítka, dynamický obsah).

Konfigurace používá syntaxi CSS-first z Tailwind v4. Vlastní motivy a pomocné třídy definujte přímo v `blockstudio.json` nebo prostřednictvím filtru `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 editoru bloků poskytuje přibalený skript Tailwind CDN živý náhled při psaní. Typ pole `classes` nabízí automatické doplňování všech utilit Tailwind. Frontend vždy používá CSS zkompilované na serveru, vložené jako vložený tag stylů před `</head>`.

Úplné nastavení najdete v [dokumentaci Tailwind](https://blockstudio.dev/cs/docs/tailwind/).

### API Interactivity

Blockstudio nyní podporuje [Interactivity WordPressAPI](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/). Povolte ji v block.json:

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

Přidejte do šablony direktivy `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 vytvořte `script.js` s logikou úložiště:

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

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

Blockstudio zajišťuje importmap, načítání modulů a zpracování direktiv na frontendu i v editoru bloků. Bloky, které používají pouze deklarativní direktivy s `data-wp-context`, například `data-wp-bind--hidden` nebo `data-wp-text`, fungují zcela bez JavaScript. Na frontendu je podporován také stav na straně serveru prostřednictvím `wp_interactivity_state()`.

Úplné nastavení najdete v [dokumentaci k Interactivity](https://blockstudio.dev/cs/docs/blocks/interactivity/).

### Analýza obsahu SEO

Bloky Blockstudio jsou dynamické, takže jejich obsah polí není pro SEO pluginy SEO ve výchozím nastavení viditelný. Blockstudio 7 to řeší automatickou integrací s Yoast SEO, Rank Math a SEOPress. Textové hodnoty z polí `text`, `textarea`, `richtext`, `wysiwyg` a `link`, včetně vnořených řádků opakovacích polí, se extrahují a předávají k analýze obsahu každého pluginu. SEO pluginy SEO nyní mohou správně analyzovat obsah bloků z hlediska hustoty klíčových slov, čitelnosti a dalších metrik. Není nutné nic konfigurovat.

### Výchozí řádky opakovacích polí

Opakovací pole nyní podporují vlastnost `default` s polem předvyplněných řádků. Po vložení bloku se opakovací pole naplní zadanými řádky a jejich hodnotami v editoru i na frontendu:

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

Vlastnost `min` funguje také s výchozími hodnotami na úrovni polí: pokud má opakovací pole `min: 3` a jeho vnitřní pole mají hodnoty `default`, automaticky vytvořené řádky se předvyplní těmito výchozími hodnotami místo toho, aby zůstaly prázdné.

## Vylepšení a opravy

- **Opakovací pole `min` s výchozími hodnotami polí**: automaticky vytvořené minimální počty řádků nyní používají výchozí hodnoty na úrovni polí na frontendu i v editoru
- **Styly editoru Tailwind**: zkompilované Tailwind CSS se nyní vkládá do iframe editoru bloků vedle CDN, takže vlastní pravidla `@apply` a konfigurace motivu fungují i v editoru
- **[Kontextový soubor pro AI](https://blockstudio.dev/cs/docs/dev/ai/)**: `blockstudio-llm.txt` byl znovu vytvořen jako statický soubor sestavený z úplné dokumentace v7 a deduplikovaných schémat JSON (~48k tokenů), čímž nahradil dynamické generování z v6
- **Vyskakovací okno pole kódu**: pole kódu lze nyní otevřít v samostatném okně s nezávislými funkcemi zpět/znovu a zvýrazněním syntaxe JavaScript
- **Kompilace Tailwind v4 na straně serveru**: viz výše uvedená [část Tailwind](#tailwind-css-v4)
- **API verze 3**: bloky se nyní správně vykreslují v editoru s iframe, včetně editoru webu a responzivních náhledů
- **Tečková notace názvů souborů prostředků**: přehlednější konvence pojmenování přípon prostředků (`*.inline.css`, `*.editor.js`, `*.scoped.css`)
- Opraveno upozornění `bs_render_block()` z `WP_Block_Supports` při použití `useBlockProps`
- Opravena pole podmíněná podmínkou, která při prvním načtení nerespektovala výchozí hodnoty
- Opraveno odstraňování znaku dolaru z obsahu `<RichText />` na frontendu
- Opravena funkce `populate`, aby fungovala s taxonomiemi registrovanými jinými pluginy
- Opravena chyba null `optionsPopulate` v kontextech WPML

## Jak to funguje uvnitř

### Kompletní přepsání

Nejde o refaktoring ani úklid kódu. Každá třída byla napsána znovu od základu. Výsledkem je přehlednější a modulárnější kódová základna, kterou lze snáze udržovat a rozšiřovat.

### Moderní PHP

Blockstudio 7 vyžaduje PHP 8.2+ a všude používá moderní typové deklarace.

## Změny, které mohou narušit kompatibilitu

Hlavní aktualizace verze 7.0 přináší několik změn, které mohou narušit kompatibilitu. Většina z nich má zpětně kompatibilní náhradní řešení, ale před aktualizací byste si je měli projít. Úplného průvodce migrací najdete v [dokumentaci k migraci v7](https://blockstudio.dev/cs/docs/dev/migration/v7/).

### Názvy háčků nyní používají snake_case

Všechny háčky PHP byly přejmenovány z camelCase na snake_case v souladu s konvencemi jádra 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í, ale doporučujeme je aktualizovat.

### Přepínač pole je ve výchozím nastavení vypnutý

Vlastnost `switch` má nyní jako výchozí hodnotu `false` místo `true`. Ve verzi v6 mělo každé pole na levém okraji neviditelný přepínač, který byl ve výchozím nastavení zapnutý. Ve verzi v7 je přepínač volitelný a v popisku pole používá viditelnou ikonu oka. Pokud jste se spoléhali na výchozí chování přepínače, přidejte do definic polí `"switch": true`.

### Názvy souborů prostředků používají tečkovou notaci

Přípony prostředků nyní používají tečky místo pomlček (`style.inline.css` místo `style-inline.css`). Stará notace s pomlčkami stále funguje, ale do budoucna doporučujeme tečkovou notaci.

### Předpona importu npm

Importy modulů ES nyní používají `npm:` místo `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";
```

Předpona `blockstudio/` je i nadále podporována kvůli zpětné kompatibilitě.

### Odebrané funkce

**Administrace a editor kódu.** Stránka nastavení administrace WordPress i vestavěný editor kódu bloků byly odebrány. Veškerá konfigurace nyní probíhá přes filtry `blockstudio.json` a PHP, takže vaše nastavení žije ve správě verzí společně s bloky.

Editor kódu byl v dřívějších verzích užitečný pro náhled bloků, ale nikdy nedosáhl plnohodnotné úrovně skutečného vývojového prostředí. Několik funkcí pluginu zůstávalo celé roky omezených, protože je v samostatném editoru nebylo možné podporovat. Editor také nikdy neměl nahradit plnohodnotné IDE. Jeho odstranění umožňuje pluginu plně se zaměřit na vývoj založený na souborech bez kompromisů.

**Licenční klíč.** Už není potřeba. Blockstudio je zdarma a jako open source.

**Knihovna bloků.** Vestavěná knihovna „Blockstudio Elements“ (Gallery, Slider, Image Comparison, Code, Icon) byla odebrána. Šlo o předpřipravené ukázkové bloky dodávané s pluginem. Pokud jste je používali, zkopírujte složky bloků z v6 do adresáře blockstudio ve svém motivu.

## Začínáme

Nainstalujte Blockstudio 7 a vytvořte svůj první blok během několika minut. Podívejte se na [průvodce Začínáme](https://blockstudio.dev/cs/docs/general/getting-started/), který vás provede postupem krok za krokem, nebo na [průvodce migrací v7](https://blockstudio.dev/cs/docs/dev/migration/v7/), pokud přecházíte z v6.

Celý zdrojový kód najdete na [GitHub](https://github.com/inline0/blockstudio). Vítáme hlášení problémů, příspěvky do projektu i zpětnou vazbu.
