# Vlastní bloky ve 3 souborech

Žádné JavaScript, žádný krok sestavení, žádný nadbytečný kód.

## Definujte pole v JSON

Přidejte klíč `blockstudio` do block.json. Definujte atributy s typy, jako jsou `text`, `toggle` a `color`. Blockstudio automaticky vygeneruje editor UI s 27 typy polí od textových vstupů přes opakovače až po editory kódu a také s typy polí, které si zaregistrujete sami.

Plná podpora schématu JSON nabízí automatické doplňování a validaci v VS Code, PhpStorm i ve všech kompatibilních editorech.

Každé pole může pro nové bloky nastavit `default` a také `fallback`, které šablona dostane, dokud je pole prázdné.

[Přehled typů polí](https://blockstudio.dev/cs/docs/blocks/attributes/field-types/)

block.json

```
{
  "name": "starter/hero",
  "title": "Hero",
  "blockstudio": {
    "attributes": [
      { "id": "heading", "type": "text", "label": "Heading" },
      { "id": "showCta", "type": "toggle", "label": "Show CTA" },
      { "id": "background", "type": "color", "label": "Background" }
    ]
  }
}
```

## Práce se třemi soubory

block.json pro pole, šablona pro značky a volitelný soubor stylů.

## React v PHP

RichText, InnerBlocks a useBlockProps fungují přímo v PHP, Twig nebo Blade.

## SCSS a Tailwind

Použijte CSS, SCSS nebo Tailwind. SCSS podporuje cesty k importům i sdílený preambule a úprava vnořené částečné šablony znovu zkompiluje každý soubor, který ji importuje.

## 27 typů polí

Text, barva, obrázek, opakovač, výběr, editor kódu a další pole lze nastavit v JSON.

## JSON Schema

Automatické doplňování a validace v VS Code, PhpStorm a kompatibilních editorech.

## Tři jazyky šablon

PHP, Twig a Blade sdílejí stejné proměnné a komponenty.

## Importy npm

Importujte balíčky v script.js; v produkci se používají lokálně a editor je načítá přes CDN.

## Interactivity API

Povolte Interactivity WordPress API jedním příznakem.

## React komponenty v šablonách PHP

Použijte `<RichText />` pro úpravy přímo na stránce a statické frontendové HTML, `<InnerBlocks />` pro vnořené bloky a `useBlockProps` pro obal, vše v jedné šabloně.

V editoru se z nich stanou skutečné komponenty React. Na frontendu se vykreslí jako serverové HTML a návštěvníkům se neposílá žádné JavaScript.

[Prozkoumat komponenty](https://blockstudio.dev/cs/docs/blocks/react-components/)

index.php

```
<div useBlockProps class="container">
  <RichText
    class="text-xl font-semibold"
    tag="h1"
    attribute="headline"
    placeholder="Enter headline"
  />

  <?php if ($a['showCta']): ?>
    <a href="<?= esc_url($a['ctaUrl']) ?>">
      <?= esc_html($a['ctaLabel']) ?>
    </a>
  <?php endif; ?>

  <InnerBlocks class="mt-4 p-4 border" />
</div>
```

## Pište v PHP, Twig nebo Blade

Používejte jazyk šablon, který znáte. PHP funguje ihned, Twig se spustí po instalaci Timber a Blade běží na `illuminate/view` 8 až 12 prostřednictvím `Blockstudio\Blade_Renderer`. Proměnné, komponenty i chování zůstávají stejné.

`$a` (atributy), `$b` (blok), `$c` (kontext) a `$innerBlocks` jsou dostupné v každém jazyce.

Twig šablony také dostávají celý kontext Timber. Blade vykresluje také stránky, vzory a šablony editoru webu. Starší obal `jenssegers/blade` nefunguje s verzí `illuminate/view` 10 a novějšími, proto místo něj použijte `Blade_Renderer`.

[Jazyky šablon](https://blockstudio.dev/cs/docs/blocks/templating/blade/)

index.twig

```
<div useBlockProps class="card">
  <RichText tag="h2" attribute="title" placeholder="Card title" />
  {% if a.image %}
    <img src="{{ a.image.url|esc_url }}"
      alt="{{ a.image.alt|esc_attr }}" />
  {% endif %}
  <div class="card__body">{{ a.description|esc_html }}</div>
  <InnerBlocks allowedBlocks='["core/button"]' />
</div>
```

## Podmíněná logika a dynamické možnosti

Zobrazujte a skrývejte pole pomocí operátorů, jako jsou `==`, `!=`, `includes`, `empty` a porovnání. Podmínky lze kombinovat pomocí logiky OR.

Možnosti mohou záviset na jiném poli. Přidejte `{attributes.post_type.value}` do argumentů pro načtení a seznam se při změně tohoto pole znovu načte. Přidejte `fetch: true`, aby se při psaní editora vyhledávaly příspěvky.

Sdílejte jeden seznam možností mezi bloky pomocí `type: custom` a filtru `blockstudio/blocks/attributes/populate` a registrujte vlastní globální podmínky, například kontrolu nákupu, prostřednictvím `blockstudio/blocks/conditions`.

[Podmíněná logika](https://blockstudio.dev/cs/docs/blocks/attributes/conditional-logic/)

block.json

```
{
  "name": "starter/posts",
  "title": "Posts",
  "blockstudio": {
    "attributes": [
      {
        "id": "post_type",
        "type": "select",
        "label": "Post type",
        "options": [
          { "value": "page", "label": "Pages" },
          { "value": "post", "label": "Posts" }
        ]
      },
      {
        "id": "selected_post",
        "type": "select",
        "label": "Post",
        "populate": {
          "type": "query",
          "query": "posts",
          "arguments": { "post_type": "{attributes.post_type.value}" }
        }
      },
      {
        "id": "style",
        "type": "select",
        "label": "Style",
        "populate": { "type": "custom", "custom": "cardStyles" },
        "conditions": [[
          { "type": "purchasedProduct", "operator": "==", "value": "yes" }
        ]]
      }
    ]
  }
}
```

## Opakovače, které zůstávají přehledné

Nastavte `min` a `max`, nové bloky začínejte s `default` řádky a stávající řádky sbalte pomocí `minimized`. `textMinimized` označí sbalený řádek jedním z jeho vlastních polí, například názvem.

Řádky přijímají všechny typy polí kromě záložek, včetně vnořených opakovačů. Podmínka uvnitř řádku kontroluje pole mimo něj pomocí `"context": "main"` a `<RichText />` a `<MediaPlaceholder />` upravují jeden řádek, když jejich `attribute` odkazuje na `repeaterId[index].fieldId`.

[Vzory opakovačů](https://blockstudio.dev/cs/guides/field-patterns/#repeater-patterns)

block.json

```
{
  "name": "starter/team",
  "title": "Team",
  "blockstudio": {
    "attributes": [
      {
        "id": "members",
        "type": "repeater",
        "label": "Team members",
        "min": 1,
        "max": 12,
        "minimized": true,
        "textMinimized": { "id": "name", "fallback": "Team member" },
        "attributes": [
          { "id": "name", "type": "text", "label": "Name" },
          { "id": "bio", "type": "richtext", "label": "Bio" }
        ]
      }
    ]
  }
}
```

## Znovupoužitelné sady polí

Definujte skupinu polí jednou v `field.json` a odkazujte na ni z libovolného bloku pomocí `"type": "custom/cta"`. Pole se vloží přímo, takže je šablony čtou jako jakýkoli jiný atribut.

Použijte stejnou sadu dvakrát pomocí `idStructure`, například `hero_{id}`, a u každého bloku změňte popisky, výchozí hodnoty nebo podmínky pomocí `overrides`. Typ pole `block` dělá totéž s celým blokem: vloží pole tohoto bloku přímo a vrátí jeho vykreslené HTML.

[Vlastní pole](https://blockstudio.dev/cs/docs/blocks/attributes/custom-fields/)

fields/cta/field.json

```
{
  "name": "cta",
  "title": "Call to action",
  "attributes": [
    { "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
    { "id": "url", "type": "link", "label": "Button URL" }
  ]
}
```

## Moduly ES bez kroku sestavení

Přidejte `script.js` a načte se jako modul ES. Importujte balíčky npm s prefixem `npm:` a Blockstudio je pro produkční prostředí stáhne lokálně.

Editor nabízí okamžitý náhled, zatímco frontend používá lokální moduly bez externích závislostí, které se zařadí do fronty jen jednou.

Šablony stylů se importují stejným způsobem. `import "npm:swiper@11.0.0/swiper.min.css"` soubor stáhne a zařadí do fronty jednou pro každou verzi, i když ho používá několik bloků.

[Zpracování assetů](https://blockstudio.dev/cs/docs/blocks/assets/)

script.js

```
import Swiper from "npm:swiper@11.0.0";
import "npm:swiper@11.0.0/swiper.min.css";

for (const el of document.querySelectorAll(".swiper")) {
  new Swiper(el, {
    slidesPerView: 3,
    spaceBetween: 20,
    loop: true,
  });
}
```

## Značky bloků i mimo šablony

Namapujte krátkou předponu na jmenný prostor v `blockstudio.json` nebo pomocí aliasového filtru jednu značku na jeden blok a `<acme-card>` vykreslí `acme/card`. Zapnutím `blockTags.enabled` vykreslíte značky v obsahu příspěvků a widgetech, s omezením na vzory `allow` a `deny`.

Atributy `data-*` se předají kořenovému prvku bloku a atributy `html-*` tam dorazí bez předpony. Přidejte vlastní tvůrce značek pomocí `blockstudio/block_tags/builders` a převeďte zkrácené zápisy na přenosný zápis `<bs:acme-card>` příkazem `migrate-block-tags`.

[Přečíst průvodce](https://blockstudio.dev/cs/guides/block-tags/)

blockstudio.json

```
{
  "blockTags": {
    "enabled": true,
    "prefixes": {
      "acme": ["acme"],
      "ui": ["acme-ui"]
    },
    "deny": ["acme-ui/admin-*"]
  }
}
```

## Vlastní typy polí

Zaregistrujte vlastní ovládací prvek pole a používejte ho stejně jako vestavěné pole.

## Blokové ostrůvky

Uložte celou stránku do mezipaměti a při požadavku návštěvníka vykreslete jeden blok.

## Podmíněná registrace

Registrujte blok pouze pro typ příspěvku, uživatelskou roli nebo jinou globální podmínku, případně jeho registraci přeskočte, pokud chybí plugin nebo jeho požadovaná verze.

## Metadata příspěvků a možnosti

Ukládejte hodnoty do metadat příspěvku nebo možností spolu s atributy bloku.

## Podmíněná logika

Zobrazujte pole podle hodnot pomocí rovnosti, členství, prázdnosti a porovnání.

## Dynamické naplňování

Naplňujte možnosti z příspěvků, uživatelů, termínů, funkcí nebo API.

## Přepsání

Nastavte override: true spolu s názvem sdíleného bloku, aby se atributy sloučily podle ID, prostředky nahradily soubory se stejnými názvy a šablona vyměnila. Šablony Twig mohou jednotlivé bloky přepsat pomocí extends.

## Varianty

Deklarujte varianty v block.json, které přednastaví hodnoty polí, a skryjte pole, které je určuje, pomocí hidden.

## Komponenty

Nastavte component: true pro blok, který se vykresluje pouze z PHP nebo značek bloků. Zachová pole, šablony, prostředky a Tailwind, ale nikdy se nezobrazí ve vkladači.

## Pravidla InnerBlocks

Povolte bloky s tokeny namespace/*, category: a @theme, přepínejte vnitřní šablonu pomocí možnosti výběru a na frontendu odstraňte obal filtrem.

## Zdroje polí pro kód

Pole pro kód s asset: true převede vstup editoru na CSS, SCSS nebo JavaScript pro daný blok a pomocí %selector% jej omezí na danou instanci.

## Prostředky podle názvu souboru

*.view.js se načítá pouze na frontendu; předpony global-, admin- a block-editor- načítají soubor na každé stránce, ve wp-admin nebo v editoru bloků.

## Ikony a složky bloků

Přiřaďte bloku vlastní ikonu SVG nebo HTML, změňte umístění vyhledávání filtrem blockstudio/path a přidejte složky pomocí Blockstudio\Build::init().

## Hodnoty ACF a Meta Box

Šablony dostávají $post_id, takže get_field() a rwmb_get_value() čtou upravený příspěvek a refreshOn po uložení obnoví náhled.

## Kontext Query Loop

Uvnitř Query Loop $block[‘context’][‘postId’] sleduje aktuální položku, zatímco $block[‘postId’] zůstává příspěvkem, který se právě zobrazuje.

## WPML

Příkaz wp bs wpml config zapíše wpml-config.xml, které označuje textová pole jako překladatelná, a obrázky uložené v polích se přidají do překladatelských úloh WPML spolu s alternativními texty a popisky.

Plus

## Oficiální sada rozšíření

Prémiové šablony webů, systémové pokyny pro umělou inteligenci a soukromá komunita Discord. Jednorázový nákup, doživotní aktualizace.

- 500+ šablon webů
- Systémové instrukce AI
- Doživotní aktualizace
- Soukromá komunita Discord

[Získat Plus](https://blockstudio.dev/cs/plus/)
