Egna block i 3 filer
Ingen JavaScript, inget byggsteg, ingen standardkod.
Definiera fält i JSON
Lägg till en blockstudio-nyckel i block.json. Definiera attribut med typer som text, toggle och color. Blockstudio genererar automatiskt redigerarens UI, med 27 fälttyper, från textfält till upprepningsfält och kodredigerare, samt fälttyper som du själv registrerar.
Fullständigt stöd för JSON Schema ger komplettering och validering i VS Code, PhpStorm och alla kompatibla redigerare.
Varje fält kan ange ett default för nya block och ett fallback som mallen får när fältet är tomt.
{
"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" }
]
}
}Arbetsflöde med tre filer
block.json för fält, en mall för markup och en valfri formatmall.
React i PHP
RichText, InnerBlocks och useBlockProps fungerar direkt i PHP, Twig eller Blade.
SCSS och Tailwind
Använd CSS, SCSS eller Tailwind. SCSS stöder importsökvägar och en gemensam inledning, och när du redigerar en nästlad del kompileras alla filer som importerar den på nytt.
27 fälttyper
Text, färg, bild, upprepare, väljare, kodredigerare med mera, konfigureras i JSON.
JSON Schema
Komplettering och validering i VS Code, PhpStorm och kompatibla redigerare.
Tre mallspråk
PHP, Twig och Blade delar samma variabler och komponenter.
npm-importer
Importera paket i script.js; lokalt i produktion och med stöd av CDN i redigeraren.
Interactivity API
Aktivera WordPress Interactivity API med en enda flagga.
React-komponenter i PHP-mallar
Använd <RichText /> för redigering direkt på sidan och statisk frontend-HTML, <InnerBlocks /> för underordnade block och useBlockProps för omslaget, allt i en enda mall.
I redigeraren blir dessa riktiga React-komponenter. På frontend renderas de som serverbaserad HTML, utan att någon JavaScript skickas till besökarna.
<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>Skriv i PHP, Twig eller Blade
Använd det mallspråk du känner till. PHP fungerar direkt, Twig körs när Timber har installerats och Blade körs på illuminate/view 8 till 12 via Blockstudio\Blade_Renderer. Variablerna, komponenterna och beteendet förblir desamma.
$a (attribut), $b (block), $c (kontext) och $innerBlocks finns tillgängliga i alla språk.
Twig-mallar får också hela kontexten Timber. Blade renderar även sidor, mönster och Site Editor-mallar. Den äldre omslutaren jenssegers/blade fungerar inte med illuminate/view 10 och senare, så använd Blade_Renderer i stället.
<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>Villkorsstyrd logik och dynamiska alternativ
Visa och dölj fält med operatorer som ==, !=, includes, empty och jämförelser. Kombinera villkor med OR-logik.
Alternativ kan bero på ett annat fält. Lägg till {attributes.post_type.value} i populate-argumenten så läses listan in på nytt när det fältet ändras. Lägg till fetch: true för att söka bland inlägg medan redaktören skriver.
Dela en alternativlista mellan block med type: custom och filtret blockstudio/blocks/attributes/populate, och registrera egna globala villkor, till exempel en köpkontroll, via 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;
});Repetitionsfält som förblir hanterbara
Ange min och max, starta nya block med default rader och fäll ihop befintliga rader med minimized. textMinimized märker en hopfälld rad med ett av dess egna fält, till exempel ett namn.
Rader accepterar alla fälttyper utom flikar, även nästlade repetitionsfält. Ett villkor i en rad kontrollerar ett fält utanför den med "context": "main", och <RichText /> och <MediaPlaceholder /> redigerar en enskild rad när deras attribute pekar på 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>Återanvändbara fältuppsättningar
Definiera en grupp fält en gång i en field.json och hänvisa till den från vilket block som helst med "type": "custom/cta". Fälten bäddas in direkt, så mallar läser dem som vilket annat attribut som helst.
Använd samma uppsättning två gånger med en idStructure, till exempel hero_{id}, och ändra etiketter, standardvärden eller villkor per block med overrides. Fälttypen block gör samma sak med ett helt block: den expanderar blockets fält direkt och returnerar dess renderade 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}"
}
]
}
}ES-moduler utan byggsteg
Lägg till script.js så läses den in som en ES-modul. Importera npm-paket med prefixet npm:, så laddar Blockstudio ned dem lokalt för produktion.
Redigeraren får en direkt förhandsvisning, medan frontend använder lokala moduler utan externa beroenden, som köas in endast en gång.
Stilmallar importeras på samma sätt. import "npm:swiper@11.0.0/swiper.min.css" hämtar filen och lägger till den i kön en gång per version, även när flera block använder den.
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,
});
}Blocktaggar utöver mallar
Koppla ett kort prefix till ett namnrymd i blockstudio.json, eller en tagg till ett block med ett aliasfilter, så renderar <acme-card> acme/card. Aktivera blockTags.enabled för att rendera taggar i inläggsinnehåll och widgetar, begränsat av mönstren allow och deny.
Attribut från data-* når blockets rotelement, och attribut från html-* kommer dit utan prefixet. Lägg till egna taggbyggare med blockstudio/block_tags/builders och skriv om kortformer till den portabla stavningen <bs:acme-card> med kommandot 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>Anpassade fälttyper
Registrera en egen fältkontroll och använd den som ett inbyggt fält.
Blocköar
Cacha hela sidan och rendera ett block i besökarens begäran.
Villkorad registrering
Registrera ett block endast för en inläggstyp, användarroll eller annat globalt villkor, eller hoppa över det om ett plugin eller den pluginversion det behöver saknas.
Inläggsmetadata och alternativ
Lagra värden i inläggsmetadata eller alternativ tillsammans med blockattribut.
Villkorsstyrd logik
Visa fält baserat på värden med likhet, inkludering, tomhet och jämförelser.
Dynamiska datakällor
Hämta val från inlägg, användare, termer, funktioner eller API:er.
Åsidosättningar
Ange override: true med namnet på ett delat block för att slå samman attribut efter id, ersätta tillgångar med matchande filnamn och byta mall. Twig-mallar kan åsidosätta enskilda block med extends.
Varianter
Ange varianter i block.json som förinställer fältvärden, och dölj fältet som styr dem med hidden.
Komponenter
Ange component: true för ett block som renderas endast från PHP eller blocktaggar. Det behåller fält, mallar, tillgångar och Tailwind men visas aldrig i infogaren.
Regler för InnerBlocks
Tillåt block med tokensen namespace/*, category: och @theme, byt den inre mallen från ett select-alternativ och ta bort omslutaren på frontend med ett filter.
Tillgångar för kodfält
Ett kodfält med asset: true omvandlar redigerarens inmatning till CSS, SCSS eller JavaScript för det blocket, avgränsat till instansen med %selector%.
Resurser efter filnamn
*.view.js laddas endast på frontend, och prefixen global-, admin- och block-editor- laddar en fil på varje sida, i wp-admin respektive i blockredigeraren.
Ikoner och blockmappar
Ge ett block en anpassad SVG- eller HTML-ikon, flytta sökningen med filtret blockstudio/path och lägg till mappar med Blockstudio\Build::init().
Värden för ACF och Meta Box
Mallar får $post_id, så get_field() och rwmb_get_value() läser det redigerade inlägget, och refreshOn uppdaterar förhandsvisningen efter att du har sparat.
Kontext för Query Loop
I en Query Loop följer $block[‘context’][‘postId’] det aktuella objektet, medan $block[‘postId’] förblir inlägget som visas.
WPML
wp bs wpml config skriver wpml-config.xml, som markerar textfält som översättningsbara, och bilder som lagras i fält läggs till i WPML-översättningsjobb med sina alt-texter och bildtexter.
Det officiella tilläggspaketet
Premiumwebbplatsmallar, systeminstruktioner för AI och en privat Discord-community. Engångsköp, uppdateringar på livstid.
- 500+ webbplatsmallar
- AI-systeminstruktioner
- Uppdateringar livet ut
- Privat Discord-community