Kuchařka vzorů polí
Systém polí v Blockstudio je sám o sobě jednoduchý: přidejte pole do blockstudio.attributes a v šabloně k němu přistupte přes $a. Skutečné bloky ale málokdy obsahují jen jedno pole. Mají skupiny souvisejících nastavení, pole zobrazovaná či skrývaná podle jiných polí, opakovače se složitou strukturou řádků a data, která musí být dostupná pro dotazování i mimo editor bloků.
Tento průvodce shromažďuje praktické návody na běžné vzory polí. Každý návod ukazuje konfiguraci block.json a odpovídající kód šablony. Zkopírujte je přímo do svých bloků a podle potřeby upravte.
Podmíněná pole
Nejběžnější vzor: zobrazování nebo skrývání polí podle hodnoty jiného pole. Editor tak zůstává přehledný, protože nabízí jen relevantní možnosti.
Přepínač pro zobrazení možností
Blok CTA, ve kterém se po zapnutí tlačítka zobrazí další nastavení:
{
"name": "my-theme/cta",
"title": "Call to Action",
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading", "default": "Ready to get started?" },
{ "id": "description", "type": "textarea", "label": "Description" },
{ "id": "showButton", "type": "toggle", "label": "Show Button", "default": true },
{
"id": "buttonText",
"type": "text",
"label": "Button Text",
"default": "Get Started",
"conditions": [[{ "id": "showButton", "operator": "==", "value": true }]]
},
{
"id": "buttonUrl",
"type": "link",
"label": "Button Link",
"conditions": [[{ "id": "showButton", "operator": "==", "value": true }]]
}
]
}
}
Pole pro text a odkaz tlačítka se zobrazí pouze při zapnutém přepínači. V šabloně před vykreslením zkontrolujte stav přepínače:
<div useBlockProps>
<h2><?php echo esc_html( $a['heading'] ); ?></h2>
<?php if ( $a['description'] ) : ?>
<p><?php echo esc_html( $a['description'] ); ?></p>
<?php endif; ?>
<?php if ( $a['showButton'] && $a['buttonUrl'] ) : ?>
<a href="<?php echo esc_url( $a['buttonUrl']['url'] ); ?>">
<?php echo esc_html( $a['buttonText'] ); ?>
</a>
<?php endif; ?>
</div>
Výběr pro přepínání sad polí
Blok hero, ve kterém typ pozadí určuje, která pole se zobrazí:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{
"id": "bgType",
"type": "select",
"label": "Background Type",
"default": "color",
"options": [
{ "value": "color", "label": "Solid Color" },
{ "value": "gradient", "label": "Gradient" },
{ "value": "image", "label": "Image" },
{ "value": "video", "label": "Video" }
]
},
{
"id": "bgColor",
"type": "color",
"label": "Background Color",
"conditions": [[{ "id": "bgType", "operator": "==", "value": "color" }]]
},
{
"id": "bgGradient",
"type": "gradient",
"label": "Background Gradient",
"conditions": [[{ "id": "bgType", "operator": "==", "value": "gradient" }]]
},
{
"id": "bgImage",
"type": "files",
"label": "Background Image",
"multiple": false,
"conditions": [[{ "id": "bgType", "operator": "==", "value": "image" }]]
},
{
"id": "bgVideo",
"type": "files",
"label": "Background Video",
"multiple": false,
"allowedTypes": ["video"],
"conditions": [[{ "id": "bgType", "operator": "==", "value": "video" }]]
},
{
"id": "overlay",
"type": "range",
"label": "Overlay Opacity",
"default": 50,
"min": 0,
"max": 100,
"conditions": [[{ "id": "bgType", "operator": "!=", "value": "color" }]]
}
]
}
}
Pole pro neprůhlednost překryvu používá != a zobrazuje se pro všechny typy kromě plné barvy. Vždy se zobrazuje pouze jedno pole pro pozadí. Pole color vrací pole obsahující value, name a slug barvy, takže šablona čte ['value']:
<?php
$bg_style = match ( $a['bgType'] ) {
'color' => $a['bgColor'] ? "background-color: {$a['bgColor']['value']}" : '',
'gradient' => $a['bgGradient'] ? "background: {$a['bgGradient']}" : '',
'image' => $a['bgImage'] ? "background-image: url({$a['bgImage']['url']})" : '',
default => '',
};
?>
<div useBlockProps style="<?php echo esc_attr( $bg_style ); ?>">
<?php if ( $a['bgType'] === 'video' && $a['bgVideo'] ) : ?>
<video autoplay muted loop playsinline>
<source src="<?php echo esc_url( $a['bgVideo']['url'] ); ?>" />
</video>
<?php endif; ?>
<h1><?php echo esc_html( $a['heading'] ); ?></h1>
</div>
Podmínky OR
Zobrazte pole, když platí kterákoli z několika podmínek. Každé vnitřní pole je skupina podmínek AND; vnější pole je kombinuje pomocí OR:
{
"id": "caption",
"type": "text",
"label": "Caption",
"conditions": [
[{ "id": "bgType", "operator": "==", "value": "image" }],
[{ "id": "bgType", "operator": "==", "value": "video" }]
]
}
Tím se zobrazí pole pro popisek, když je bgType nastaveno na “image” NEBO “video”.
Řetězené podmínky
Více podmínek ve stejném vnitřním poli používá logiku AND:
{
"id": "altText",
"type": "text",
"label": "Alt Text",
"conditions": [[
{ "id": "bgType", "operator": "==", "value": "image" },
{ "id": "bgImage", "operator": "!empty" }
]]
}
Pole pro alternativní text se zobrazí pouze tehdy, když je bgType nastaveno na “image” A zároveň je vybrán obrázek.
Globální podmínky
Zobrazujte pole podle typu příspěvku, ID příspěvku nebo uživatelské role, nikoli podle hodnot jiných polí:
{
"id": "seoTitle",
"type": "text",
"label": "SEO Title",
"conditions": [[{ "type": "postType", "operator": "==", "value": "page" }]]
}
Dostupné typy globálních podmínek: postType, postId, userRole, userId.
Uspořádaná nastavení
S rostoucí složitostí bloků pomáhá uspořádat pole do logických skupin, aby panel inspektoru zůstal přehledný.
Skupiny pro vizuální uspořádání
Skupiny vytvářejí v panelu inspektoru sbalitelné oddíly. Anonymní skupina (bez id) slouží čistě k vizuálnímu členění; k jejím polím se přistupuje pomocí jejich prostých ID:
{
"name": "my-theme/card",
"title": "Card",
"blockstudio": {
"attributes": [
{
"type": "group",
"title": "Content",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "description", "type": "textarea", "label": "Description" },
{ "id": "image", "type": "files", "label": "Image", "multiple": false }
]
},
{
"type": "group",
"title": "Link",
"attributes": [
{ "id": "url", "type": "link", "label": "URL" },
{ "id": "openInNewTab", "type": "toggle", "label": "Open in New Tab" }
]
},
{
"type": "group",
"title": "Appearance",
"attributes": [
{
"id": "style",
"type": "select",
"label": "Style",
"default": "elevated",
"options": [
{ "value": "elevated", "label": "Elevated" },
{ "value": "outlined", "label": "Outlined" },
{ "value": "flat", "label": "Flat" }
]
},
{ "id": "accentColor", "type": "color", "label": "Accent Color" }
]
}
]
}
}
<div useBlockProps>
<h3><?php echo esc_html( $a['title'] ); ?></h3>
<p><?php echo esc_html( $a['description'] ); ?></p>
</div>
K polím se přistupuje přímo: $a['title'], $a['style'], $a['accentColor']. Skupiny ovlivňují pouze rozvržení panelu inspektoru.
Pojmenované skupiny s bs_get_group
Když má skupina id, ID jejích podřízených polí dostanou předponu. K jejímu odstranění použijte bs_get_group():
{
"id": "author",
"type": "group",
"title": "Author",
"attributes": [
{ "id": "name", "type": "text", "label": "Name" },
{ "id": "role", "type": "text", "label": "Role" },
{ "id": "avatar", "type": "files", "label": "Avatar", "multiple": false }
]
}
Bez pomocné funkce se k polím přistupuje jako k $a['author_name'], $a['author_role'], $a['author_avatar']. S pomocnou funkcí:
<?php $author = bs_get_group( $a, 'author' ); ?>
<div class="author">
<?php if ( $author['avatar'] ) : ?>
<img src="<?php echo esc_url( $author['avatar']['url'] ); ?>" alt="" />
<?php endif; ?>
<p><?php echo esc_html( $author['name'] ); ?></p>
<p><?php echo esc_html( $author['role'] ); ?></p>
</div>
Pojmenované skupiny se hodí, když se stejná jména polí vyskytují ve více skupinách (e.g., author_name a company_name) nebo když chcete předat skupinu jako celek dílčí šabloně.
Rozvržení mřížky ve skupinách
Pomocí vlastnosti style uspořádáte podřízená pole skupiny vedle sebe:
{
"type": "group",
"title": "Dimensions",
"style": {
"display": "grid",
"grid-template-columns": "1fr 1fr",
"grid-gap": "16px"
},
"attributes": [
{ "id": "width", "type": "unit", "label": "Width", "default": "100%", "switch": false },
{ "id": "height", "type": "unit", "label": "Height", "default": "auto", "switch": false }
]
}
Dvě pole jednotek se v panelu inspektoru vykreslí vedle sebe, nikoli pod sebou. Hodí se to pro dvojice rozměrů, hodnot okrajů či vnitřních okrajů nebo pro jakákoli dvě koncepčně související pole.
Karty pro hlavní oddíly
Když má blok mnoho nastavení, karty zajistí přehlednější uspořádání než dlouhý seznam skupin:
{
"type": "tabs",
"tabs": [
{
"title": "Content",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "body", "type": "wysiwyg", "label": "Body" }
]
},
{
"title": "Media",
"attributes": [
{ "id": "image", "type": "files", "label": "Image", "multiple": false },
{ "id": "video", "type": "files", "label": "Video", "multiple": false, "allowedTypes": ["video"] }
]
},
{
"title": "Settings",
"attributes": [
{ "id": "layout", "type": "select", "label": "Layout", "options": [
{ "value": "left", "label": "Media Left" },
{ "value": "right", "label": "Media Right" }
]},
{ "id": "fullWidth", "type": "toggle", "label": "Full Width" }
]
}
]
}
K polím jednotlivých karet se přistupuje stejně jako k polím nejvyšší úrovně: $a['title'], $a['image'], $a['layout']. Karty slouží pouze jako kontejner UI.
Vzory opakovačů
Opakovače umožňují uživatelům přidávat více řádků polí. Jsou nezbytné pro seznamy, mřížky, časové osy a všechny komponenty s proměnlivým počtem položek.
Základní opakovač s omezeními
Seznam funkcí s 1 až 6 položkami:
{
"id": "features",
"type": "repeater",
"label": "Features",
"min": 1,
"max": 6,
"textButton": "Add Feature",
"attributes": [
{ "id": "icon", "type": "icon", "label": "Icon" },
{ "id": "title", "type": "text", "label": "Title", "default": "Feature" },
{ "id": "description", "type": "textarea", "label": "Description" }
]
}
<div useBlockProps class="grid grid-cols-3 gap-8">
<?php foreach ( $a['features'] as $feature ) : ?>
<div>
<?php if ( $feature['icon'] ) : ?>
<?php bs_render_icon( $feature['icon'] ); ?>
<?php endif; ?>
<h3><?php echo esc_html( $feature['title'] ); ?></h3>
<p><?php echo esc_html( $feature['description'] ); ?></p>
</div>
<?php endforeach; ?>
</div>
Vlastní popisky řádků
Sbalené řádky opakovače mají ve výchozím nastavení obecný popisek. Pomocí textMinimized můžete místo něj zobrazit hodnotu pole:
{
"id": "team",
"type": "repeater",
"label": "Team Members",
"textMinimized": { "id": "name", "fallback": "Team Member" },
"attributes": [
{ "id": "name", "type": "text", "label": "Name" },
{ "id": "role", "type": "text", "label": "Role" },
{ "id": "photo", "type": "files", "label": "Photo", "multiple": false }
]
}
Po sbalení řádku se místo “Řádek 1” zobrazí jméno osoby. fallback se použije, když je pole pro jméno prázdné. Můžete také přidat řetězce prefix a suffix.
Podmínky uvnitř opakovačů
Pole uvnitř opakovače mohou odkazovat na další pole v témže řádku pomocí jejich prostých id (předpona není potřeba):
{
"id": "links",
"type": "repeater",
"label": "Links",
"attributes": [
{ "id": "label", "type": "text", "label": "Label" },
{ "id": "url", "type": "link", "label": "URL" },
{
"id": "isExternal",
"type": "toggle",
"label": "External Link"
},
{
"id": "externalNote",
"type": "message",
"label": "Note",
"description": "External links open in a new tab with rel=\"noopener\".",
"conditions": [[{ "id": "isExternal", "operator": "==", "value": true }]]
}
]
}
Odkazování na vnější pole uvnitř opakovače
Když podmínka uvnitř opakovače potřebuje zkontrolovat pole mimo opakovač, přidejte "context": "main":
{
"id": "showDescriptions",
"type": "toggle",
"label": "Show Descriptions",
"default": true
},
{
"id": "items",
"type": "repeater",
"label": "Items",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{
"id": "description",
"type": "textarea",
"label": "Description",
"conditions": [[{
"id": "showDescriptions",
"operator": "==",
"value": true,
"context": "main"
}]]
}
]
}
Bez "context": "main" by podmínka hledala pole showDescriptions uvnitř řádku opakovače. S ním podmínka kontroluje přepínač na kořenové úrovni.
Karty uvnitř opakovačů
Karty nejsou uvnitř opakovačů dostupné: pole tabs uvnitř řádku opakovače místo svých polí zobrazí v editoru upozornění a rozšíření PHPStan tuto skutečnost nahlásí. Pole v řádku ponechte raději bez vnořování. U dlouhých řádků pomůže vlastní popisek řádku (textMinimized), díky kterému zůstanou sbalené řádky přehledné. Podmínky uvnitř řádku mohou skrýt pole potřebná jen pro některé řádky, jak ukazují výše uvedené vzory.
Nastavením "minimized": true u opakovače se existující řádky při otevření sbalí. Nově přidané řádky se otevřou hned. Výjimky, které rozbalíte, se v tomto prohlížeči zapamatují i po opětovném načtení editoru; jde o předvolbu pro úpravy, nikoli o uložený obsah příspěvku. Opakovače bez minimized si zachovají dosavadní chování, kdy jsou ve výchozím nastavení rozbalené.
Vzory pro média
Jeden obrázek s náhradní hodnotou
{
"id": "image",
"type": "files",
"label": "Image",
"multiple": false
}
<?php if ( $a['image'] ) : ?>
<img
src="<?php echo esc_url( $a['image']['url'] ); ?>"
alt="<?php echo esc_attr( $a['image']['alt'] ); ?>"
<?php if ( isset( $a['image']['sizes']['full-width'], $a['image']['sizes']['full-height'] ) ) : ?>
width="<?php echo esc_attr( $a['image']['sizes']['full-width'] ); ?>"
height="<?php echo esc_attr( $a['image']['sizes']['full-height'] ); ?>"
<?php endif; ?>
/>
<?php endif; ?>
Výchozí returnFormat je "object", který poskytuje ID, title, alt, caption, description, href, url a sizes. sizes obsahuje URL všech registrovaných velikostí obrázků (sizes['large']) včetně jejich rozměrů (sizes['large-width'], sizes['large-height']). Úplný seznam najdete v Atributy vykreslování.
Galerie s omezeným počtem položek
{
"id": "gallery",
"type": "files",
"label": "Gallery",
"multiple": true,
"max": 6,
"allowedTypes": ["image"]
}
<?php if ( $a['gallery'] ) : ?>
<div class="grid grid-cols-3 gap-4">
<?php foreach ( $a['gallery'] as $image ) : ?>
<img
src="<?php echo esc_url( $image['url'] ); ?>"
alt="<?php echo esc_attr( $image['alt'] ); ?>" />
<?php endforeach; ?>
</div>
<?php endif; ?>
Vypínatelný obrázek s přepínačem
Vlastnost switch přidá ikonu oka, která uživatelům umožňuje pole vypnout, aniž by smazali jeho hodnotu:
{
"id": "logo",
"type": "files",
"label": "Logo",
"multiple": false,
"switch": true
}
<?php
$is_disabled = ! empty( $a['_disabled'] ) && in_array( 'logo', $a['_disabled'], true );
if ( $a['logo'] && ! $is_disabled ) : ?>
<img src="<?php echo esc_url( $a['logo']['url'] ); ?>" alt="" />
<?php endif; ?>
Uživatel může logo vypnout, aniž by odstranil nahraný soubor. Po opětovném zapnutí se zobrazí tentýž soubor.
Varianty formátu návratové hodnoty
Určete, co vrací pole souborů:
// Full object (default)
{ "id": "photo", "type": "files", "returnFormat": "object", "multiple": false }
// $a['photo']['url'], $a['photo']['alt'], $a['photo']['sizes']['full-width'], etc.
// Just the ID
{ "id": "photo", "type": "files", "returnFormat": "id", "multiple": false }
// $a['photo'] = 42
// Just the URL
{ "id": "photo", "type": "files", "returnFormat": "url", "multiple": false }
// $a['photo'] = "https://example.com/photo.jpg"
Použijte "id", když potřebujete sami zavolat wp_get_attachment_image(). Pro jednoduché obrázky na pozadí použijte "url". Ve všech ostatních případech použijte "object" (výchozí hodnotu).
Při použití "returnFormat": "id" se importovaný řetězcový odkaz, například "buckshair-home", předá beze změny. Editor zobrazí náhradní kartu bez miniatury, a to i v řádcích opakovače. Otevřením ani uložením stránky se skalární odkaz nepřevede na pole. Fungují také smíšené seznamy ID příloh a řetězcových odkazů; v knihovně médií se vyhledávají pouze kladná ID příloh.
Blockstudio nepřevádí vlastní řetězcové odkazy na přílohy. Pokud používáte přenositelné názvy napříč weby, vyřešte je ve vlastním filtru vykreslování nebo šabloně. Při výběru náhrady v knihovně médií se jako obvykle uloží její ID přílohy.
Dynamické možnosti
Naplnění příspěvky
Výběrové pole se seznamem všech publikovaných stránek:
{
"id": "linkedPage",
"type": "select",
"label": "Linked Page",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "page",
"post_status": "publish",
"posts_per_page": -1
}
}
}
Pole se automaticky naplní názvy stránek jako popisky a ID příspěvků jako hodnotami. Mapování můžete upravit pomocí returnFormat v konfiguraci naplnění:
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"returnFormat": { "value": "ID", "label": "post_title" }
}
Naplnění termíny taxonomie
{
"id": "category",
"type": "select",
"label": "Category",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "terms",
"arguments": {
"taxonomy": "category",
"hide_empty": true
}
}
}
Naplnění pomocí funkce PHP
{
"id": "postType",
"type": "select",
"label": "Post Type",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": { "public": true }
}
}
Statické možnosti s doplněnými položkami
Kombinujte pevně zadané možnosti s dynamickými. Pomocí position určete, kde se mají zobrazit naplněné možnosti:
{
"id": "source",
"type": "select",
"label": "Source",
"options": [
{ "value": "manual", "label": "Manual Entry" },
{ "value": "latest", "label": "Latest Posts" }
],
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"position": "after"
}
}
Nejprve se zobrazí statické možnosti a po nich dynamicky naplněné stránky.
Ukládání dat pro dotazy
Ve výchozím nastavení jsou hodnoty polí uloženy v atributech bloku uvnitř post_content. Nelze je dotazovat pomocí WP_Query. Pokud potřebujete filtrovat nebo řadit příspěvky podle hodnoty pole, použijte úložiště.
Metadata příspěvku pro pole dostupná v dotazech
{
"id": "featured",
"type": "toggle",
"label": "Featured",
"storage": {
"type": "postMeta",
"postMetaKey": "is_featured"
}
},
{
"id": "priority",
"type": "number",
"label": "Priority",
"default": 0,
"min": 0,
"max": 100,
"storage": {
"type": "postMeta",
"postMetaKey": "priority_score"
}
}
Nyní můžete vyhledávat doporučené příspěvky:
$featured = new WP_Query( array(
'meta_query' => array(
array(
'key' => 'is_featured',
'value' => '1',
),
),
'orderby' => 'meta_value_num',
'meta_key' => 'priority_score',
'order' => 'DESC',
) );
Klíče metadat se automaticky registrují pomocí show_in_rest, takže jsou dostupné také v REST API.
Dvojí úložiště
Ukládejte data do atributů bloku i metadat příspěvku. Atribut bloku zpřístupňuje hodnotu v šablonách prostřednictvím $a, zatímco metadata příspěvku umožňují její použití v dotazech:
{
"id": "eventDate",
"type": "date",
"label": "Event Date",
"storage": {
"type": ["block", "postMeta"],
"postMetaKey": "event_date"
}
}
Ukládání do nastavení pro globální hodnoty
Pro nastavení platná pro celý web, která mají být všude stejná, použijte úložiště nastavení:
{
"id": "companyName",
"type": "text",
"label": "Company Name",
"storage": {
"type": "option",
"optionKey": "site_company_name"
}
}
Hodnota se ukládá do wp_options a odkudkoli je dostupná pomocí get_option('site_company_name'). Když uživatel upraví toto pole v kterékoli instanci bloku, hodnota se aktualizuje globálně.
Opakovaně použitelné definice polí
Když několik bloků sdílí stejnou strukturu polí, definujte ji jednou jako vlastní pole a odkazujte na ni všude.
Vytvoření vlastního pole
Vytvořte field.json v adresáři blockstudio/fields/ svého motivu:
theme/
└── blockstudio/
└── 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" },
{ "id": "style", "type": "select", "label": "Button Style", "default": "primary", "options": [
{ "value": "primary", "label": "Primary" },
{ "value": "secondary", "label": "Secondary" },
{ "value": "outline", "label": "Outline" }
]}
]
}
Použití vlastního pole
Odkazujte na něj v libovolném bloku pomocí "type": "custom/cta":
{
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{ "type": "custom/cta" }
]
}
}
Pole CTA jsou vložena přímo do bloku. Přistupujte k nim přímo: $a['label'], $a['url'], $a['style'].
Vlastní pole s předponou pomocí idStructure
Při opakovaném použití stejného vlastního pole přidejte idStructure, aby se k ID připojila předpona:
{
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{ "type": "custom/cta", "idStructure": "secondary_{id}" }
]
}
}
Pole prvního CTA budou primary_label, primary_url, primary_style. Druhé bude mít secondary_label atd.
Přepsání výchozích hodnot
Při odkazování na vlastní pole upravte konkrétní pole:
{
"type": "custom/cta",
"idStructure": "hero_{id}",
"overrides": {
"label": { "default": "Get Started", "label": "CTA Label" },
"style": { "default": "primary" }
}
}
Přepsané hodnoty se sloučí s původní definicí. Můžete změnit výchozí hodnoty, popisky, podmínky i jakékoli jiné vlastnosti.
Vzory vykreslování
Kontrola prázdných hodnot
Většina typů polí vrací při prázdné hodnotě false. Před vykreslením ji vždy zkontrolujte:
<?php if ( $a['title'] ) : ?>
<h2><?php echo esc_html( $a['title'] ); ?></h2>
<?php endif; ?>
U čísel je 0 platná hodnota. Pokud potřebujete rozlišit mezi „prázdné“ a „nula“, použijte striktní porovnání:
<?php if ( $a['count'] !== 0 || $a['count'] !== false ) : ?>
<span><?php echo esc_html( $a['count'] ); ?></span>
<?php endif; ?>
Výběr s returnFormat: both
Když potřebujete hodnotu pro logiku i popisek pro zobrazení:
{
"id": "status",
"type": "select",
"label": "Status",
"returnFormat": "both",
"options": [
{ "value": "active", "label": "Active" },
{ "value": "paused", "label": "On Hold" },
{ "value": "closed", "label": "Closed" }
]
}
<?php if ( $a['status'] ) : ?>
<span class="badge badge--<?php echo esc_attr( $a['status']['value'] ); ?>">
<?php echo esc_html( $a['status']['label'] ); ?>
</span>
<?php endif; ?>
Datové atributy z pole attributes
Typ pole attributes umožňuje uživatelům přidávat vlastní datové atributy:
{
"id": "dataAttrs",
"type": "attributes",
"label": "Data Attributes",
"link": true,
"media": true
}
<div useBlockProps <?php bs_render_data_attributes( $a['dataAttrs'] ); ?>>
Content here.
</div>
Proměnné CSS z hodnot polí
Vytvářejte vlastní vlastnosti CSS z vybraných polí:
{
"id": "textColor", "type": "color", "label": "Text Color"
},
{
"id": "fontSize", "type": "unit", "label": "Font Size", "default": "1rem"
}
<div useBlockProps style="<?php bs_render_variables( $a, array( 'textColor', 'fontSize' ) ); ?>">
<p>Styled content.</p>
</div>
Výstupem bude style="--text-color: #333; --font-size: 1rem;" (ID polí se převedou na kebab-case). Proměnné použijte ve svém CSS:
p {
color: var(--text-color);
font-size: var(--font-size);
}
Další kroky
- Registrace atributů: vlastnosti
id,type,label,default,help,positionaconditions. - Přehled typů polí: automaticky generovaný přehled všech vlastností každého typu pole.
- Podmíněná logika: operátory, globální podmínky, vlastní filtry podmínek a kontext opakovačů.
- Naplnění možností: režimy dotazů, funkcí, vlastních hodnot a načítání pro dynamická výběrová pole.
- Vlastní pole:
field.json, cesty pro vyhledávání, filtrblockstudio/fieldsa pokročilé vzoryidStructure. - Vykreslování:
$a,$b,$c, prázdné hodnoty a pomocné funkce.