# Vlastné bloky v 3 súboroch

Bez JavaScript, zostavovania a štandardnej predpripravenej štruktúry.

## Definujte polia v JSON

Pridajte kľúč `blockstudio` do block.json. Definujte atribúty s typmi, ako sú `text`, `toggle` a `color`. Blockstudio automaticky vygeneruje UI editora s 27 typmi polí od textových vstupov cez opakovače až po editory kódu, ako aj typmi polí, ktoré si zaregistrujete sami.

Úplná podpora schémy JSON poskytuje automatické dopĺňanie a validáciu v VS Code, PhpStorm a každom kompatibilnom editore.

Pre každý blok možno nastaviť `default` pre nové bloky a `fallback`, ktorý šablóna dostane, kým je pole prázdne.

[Prehľad typov polí](https://blockstudio.dev/sk/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áca s tromi súbormi

block.json pre polia, šablóna pre značky a voliteľný súbor štýlov.

## React v PHP

RichText, InnerBlocks a useBlockProps fungujú priamo v PHP, Twig alebo Blade.

## SCSS a Tailwind

Použite CSS, SCSS alebo Tailwind. SCSS podporuje cesty importov a zdieľaný úvodný kód; úprava vnoreného čiastkového súboru znova skompiluje každý súbor, ktorý ho importuje.

## 27 typov polí

Text, farba, obrázok, opakovač, výber, editor kódu a ďalšie polia nakonfigurované v JSON.

## JSON Schema

Automatické dopĺňanie a validácia v VS Code, PhpStorm a kompatibilných editoroch.

## Tri jazyky šablón

PHP, Twig a Blade používajú rovnaké premenné a komponenty.

## Importy npm

Importujte balíky v script.js; v produkčnom prostredí lokálne a v editore zabezpečené pomocou CDN.

## Interactivity API

Povoľte interaktivitu WordPress pomocou príznaku API.

## Komponenty React v šablónach PHP

Použite `<RichText />` na úpravy priamo v texte a statické prvky frontendu HTML, `<InnerBlocks />` pre vnorené bloky a `useBlockProps` pre obal; všetko v jednej šablóne.

V editore sa z nich stanú skutočné komponenty React. Na frontende sa vykreslia ako HTML na strane servera a návštevníkom sa neposiela žiadne JavaScript.

[Preskúmať komponenty](https://blockstudio.dev/sk/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>
```

## Píšte v PHP, Twig alebo Blade

Použite jazyk šablón, ktorý poznáte. PHP funguje hneď po inštalácii, Twig sa spustí po nainštalovaní Timber a Blade beží na `illuminate/view` vo verziách 8 až 12 cez `Blockstudio\Blade_Renderer`. Premenné, komponenty a správanie zostávajú rovnaké.

`$a` (atribúty), `$b` (blok), `$c` (kontext) a `$innerBlocks` sú dostupné v každom jazyku.

Twig šablóny tiež dostávajú celý kontext Timber. Blade vykresľuje aj stránky, vzory a šablóny editora webu. Starší obal `jenssegers/blade` zlyháva vo verzii `illuminate/view` 10 a novších, preto namiesto neho použite `Blade_Renderer`.

[Jazyky šablón](https://blockstudio.dev/sk/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>
```

## Podmienená logika a dynamické možnosti

Zobrazujte a skrývajte polia pomocou operátorov vrátane `==`, `!=`, `includes`, `empty` a porovnávania. Podmienky môžete kombinovať pomocou logiky OR.

Možnosti môžu závisieť od iného poľa. Vložte `{attributes.post_type.value}` do argumentov populate a zoznam sa znova načíta pri zmene daného poľa. Pridajte `fetch: true`, aby sa pri písaní editora vyhľadávali príspevky.

Zdieľajte jeden zoznam možností medzi blokmi pomocou `type: custom` a filtra `blockstudio/blocks/attributes/populate` a registrujte vlastné globálne podmienky, napríklad kontrolu nákupu, prostredníctvom `blockstudio/blocks/conditions`.

[Podmienená logika](https://blockstudio.dev/sk/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" }
        ]]
      }
    ]
  }
}
```

## Prehľadné opakovače

Nastavte `min` a `max`, začínajte nové bloky s `default` riadkami a existujúce riadky zbaľte pomocou `minimized`. `textMinimized` označí zbalený riadok jedným z jeho vlastných polí, napríklad názvom.

Riadky podporujú všetky typy polí okrem kariet vrátane vnorených opakovačov. Podmienka v riadku kontroluje pole mimo neho pomocou `"context": "main"` a `<RichText />` a `<MediaPlaceholder />` upravujú jeden riadok, keď ich `attribute` odkazuje na `repeaterId[index].fieldId`.

[Vzory opakovačov](https://blockstudio.dev/sk/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" }
        ]
      }
    ]
  }
}
```

## Opakovane použiteľné skupiny polí

Definujte skupinu polí raz v `field.json` a odkazujte na ňu z ľubovoľného bloku pomocou `"type": "custom/cta"`. Polia sa vložia priamo, takže ich šablóny čítajú ako každý iný atribút.

Použite rovnakú skupinu dvakrát pomocou `idStructure`, napríklad `hero_{id}`, a pre každý blok zmeňte popisy, predvolené hodnoty alebo podmienky pomocou `overrides`. Typ poľa `block` funguje rovnako s celým blokom: vloží polia daného bloku priamo a vráti jeho vykreslený HTML.

[Vlastné polia](https://blockstudio.dev/sk/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 zostavovania

Pridajte `script.js` a načíta sa ako modul ES. Importujte balíky npm s predponou `npm:` a Blockstudio ich pre produkčné prostredie stiahne lokálne.

Editor ponúka okamžitý náhľad, zatiaľ čo frontend používa lokálne moduly bez externej závislosti, ktoré sa zaradia do fronty len raz.

Štýlopisy sa importujú rovnako. `import "npm:swiper@11.0.0/swiper.min.css"` stiahne súbor a zaradí ho do frontu raz pre každú verziu, aj keď ho používa viacero blokov.

[Spracovanie zdrojov](https://blockstudio.dev/sk/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 blokov aj mimo šablón

V `blockstudio.json` priraďte krátku predponu k mennému priestoru alebo jednu značku k jednému bloku pomocou filtra aliasov a `<acme-card>` vykreslí `acme/card`. Zapnutím `blockTags.enabled` umožníte vykresľovanie značiek v obsahu príspevkov a miniaplikáciách, obmedzené vzormi `allow` a `deny`.

Atribúty `data-*` sa dostanú ku koreňovému prvku bloku a atribúty `html-*` tam prídu bez predpony. Pridajte vlastné tvorcov značiek pomocou `blockstudio/block_tags/builders` a príkazom `migrate-block-tags` prepíšte skrátené zápisy na prenosný zápis `<bs:acme-card>`.

[Prečítať príručku](https://blockstudio.dev/sk/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í prvok poľa a používajte ho ako vstavané pole.

## Blokové ostrovy

Uložte do vyrovnávacej pamäte celú stránku a vykreslite jeden blok v rámci požiadavky návštevníka.

## Podmienená registrácia

Zaregistrujte blok iba pre určitý typ príspevku, používateľskú rolu alebo inú globálnu podmienku, prípadne jeho registráciu preskočte, ak chýba potrebný plugin alebo jeho verzia.

## Metadáta príspevkov a možnosti

Ukladajte hodnoty do metadát príspevkov alebo možností spolu s atribútmi bloku.

## Podmienená logika

Zobrazujte polia podľa hodnôt pomocou rovnosti, zahrnutia, prázdnosti a porovnávania.

## Dynamické napĺňanie

Napĺňajte možnosti z príspevkov, používateľov, výrazov, funkcií alebo API.

## Prepísania

Nastavte override: true a názov zdieľaného bloku, aby sa atribúty zlúčili podľa ID, zdroje nahradili súbormi s rovnakými názvami a šablóna vymenila. Šablóny Twig môžu jednotlivé bloky prepísať pomocou extends.

## Varianty

Deklarujte variácie v block.json, ktoré prednastavia hodnoty polí, a skryte pole, ktoré ich riadi, pomocou hidden.

## Komponenty

Nastavte component: true pre blok, ktorý sa vykresľuje iba z PHP alebo značiek blokov. Zachováva polia, šablóny, zdroje a Tailwind, no nikdy sa nezobrazí vo vkladači.

## Pravidlá InnerBlocks

Povoľte bloky s tokenmi namespace/*, category: a @theme, prepínajte vnútornú šablónu pomocou možnosti výberu a pomocou filtra odstráňte obal na frontende.

## Zdroje polí kódu

Pole kódu s asset: true zmení vstup editora na CSS, SCSS alebo JavaScript pre daný blok; rozsah je obmedzený na jeho inštanciu pomocou %selector%.

## Súbory podľa názvu

*.view.js sa načítava iba na frontende a predpony global-, admin- a block-editor- načítajú súbor na každej stránke, vo wp-admin alebo v editore blokov.

## Ikony a priečinky blokov

Priraďte bloku vlastnú ikonu SVG alebo HTML, zmeňte umiestnenie pri vyhľadávaní pomocou filtra blockstudio/path a pridajte priečinky pomocou Blockstudio\Build::init().

## Hodnoty ACF a Meta Box

Šablóny dostávajú $post_id, takže get_field() a rwmb_get_value() čítajú upravený príspevok a refreshOn po uložení obnoví ukážku.

## Kontext Query Loop

V rámci Query Loop sleduje $block[‘context’][‘postId’] aktuálnu položku, zatiaľ čo $block[‘postId’] zostáva príspevkom, ktorý sa zobrazuje.

## WPML

Príkaz wp bs wpml config zapíše wpml-config.xml, ktorý označí textové polia ako preložiteľné, a obrázky uložené v poliach sa spolu s alternatívnymi textami a titulkami pridajú do prekladateľských úloh WPML.

Plus

## Oficiálna súprava rozšírení

Prémiové šablóny webov, systémové pokyny pre AI a súkromná komunita Discord. Jednorazový nákup, aktualizácie na celý život.

- 500+ šablón stránok
- Systémové pokyny pre AI
- Doživotné aktualizácie
- Súkromná komunita Discord

[Získať Plus](https://blockstudio.dev/sk/plus/)
