Preskočiť na obsah

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.

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.

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.

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.

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.

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.

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.

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

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