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é.
{
"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.
<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.
<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><div useBlockProps class="card">
<RichText tag="h2" attribute="title" placeholder="Card title" />
@if ($a['description'])
<div class="card__body">{{ $a['description'] }}</div>
@endif
<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.
{
"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" }
]]
}
]
}
}add_filter('blockstudio/blocks/attributes/populate', function ($options) {
$options['cardStyles'] = [
['value' => 'light', 'label' => 'Light'],
['value' => 'dark', 'label' => 'Dark'],
];
return $options;
});
add_filter('blockstudio/blocks/conditions', function ($conditions) {
$conditions['purchasedProduct'] = user_has_purchased(123) ? 'yes' : 'no';
return $conditions;
});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.
{
"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" }
]
}
]
}
}<div useBlockProps class="team">
<?php foreach ($a['members'] as $index => $member): ?>
<article>
<h3><?= esc_html($member['name']) ?></h3>
<RichText
tag="p"
attribute="members[<?= $index ?>].bio"
placeholder="Short bio"
/>
</article>
<?php endforeach; ?>
</div>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.
{
"name": "cta",
"title": "Call to action",
"attributes": [
{ "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
{ "id": "url", "type": "link", "label": "Button URL" }
]
}{
"name": "starter/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{
"type": "custom/cta",
"idStructure": "secondary_{id}",
"overrides": {
"label": { "default": "Contact us" }
}
},
{
"id": "card",
"type": "block",
"block": "starter/card",
"idStructure": "card_{id}"
}
]
}
}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ů.
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.
{
"blockTags": {
"enabled": true,
"prefixes": {
"acme": ["acme"],
"ui": ["acme-ui"]
},
"deny": ["acme-ui/admin-*"]
}
}<div useBlockProps class="acme-features">
<acme-card
title="Fast"
text="Rendered on the server."
data-track="card"
/>
<ui-button label="Get started" href="/start" html-id="start" />
</div>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.
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