Přejít k obsahu

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é.

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.

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.

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.

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.

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.

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ů.

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.

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