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.
{
"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.
<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.
<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>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.
{
"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;
});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.
{
"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>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.
{
"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 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.
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>.
{
"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í 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.
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