Aangepaste blokken in 3 bestanden
Geen JavaScript, geen buildstap, geen boilerplate.
Velden definiëren in JSON
Voeg een blockstudio-sleutel toe aan block.json. Definieer attributen met typen zoals text, toggle en color. Blockstudio genereert automatisch de editor UI, met 27 veldtypen, van tekstinvoer tot repeaters en code-editors, plus veldtypen die je zelf registreert.
Volledige ondersteuning voor JSON Schema biedt automatisch aanvullen en validatie in VS Code, PhpStorm en elke compatibele editor.
Elk veld kan een default instellen voor nieuwe blokken en een fallback die het sjabloon ontvangt zolang het veld leeg is.
{
"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" }
]
}
}Workflow met 3 bestanden
block.json voor velden, een template voor markup en een optioneel stylesheet.
React in PHP
RichText, InnerBlocks en useBlockProps werken rechtstreeks in PHP, Twig of Blade.
SCSS en Tailwind
Gebruik CSS, SCSS of Tailwind. SCSS ondersteunt importpaden en een gedeelde prelude; als je een geneste partial bewerkt, worden alle bestanden die deze importeren opnieuw gecompileerd.
27 veldtypen
Tekst, kleur, afbeelding, herhaalveld, selectievak, code-editor en meer, ingesteld in JSON.
JSON Schema
Automatisch aanvullen en validatie in VS Code, PhpStorm en compatibele editors.
Drie template-talen
PHP, Twig en Blade gebruiken dezelfde variabelen en componenten.
npm-imports
Importeer pakketten in script.js; lokaal in productie en ondersteund door CDN in de editor.
Interactivity API
Schakel de interactiviteit van WordPress in met één vlag: API.
React-componenten in PHP-templates
Gebruik <RichText /> voor inline bewerken en statische frontend-HTML, <InnerBlocks /> voor geneste blokken en useBlockProps voor de wrapper, allemaal in één template.
In de editor worden dit echte React-componenten. Op de frontend worden ze weergegeven als server-side HTML, zonder dat JavaScript naar bezoekers wordt gestuurd.
<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>Schrijf in PHP, Twig of Blade
Gebruik de sjabloontaal die je kent. PHP werkt direct, Twig wordt uitgevoerd zodra Timber is geïnstalleerd, en Blade wordt uitgevoerd op illuminate/view 8 tot 12 via Blockstudio\Blade_Renderer. De variabelen, componenten en werking blijven hetzelfde.
$a (kenmerken), $b (blok), $c (context) en $innerBlocks zijn in elke taal beschikbaar.
Twig-templates ontvangen ook de volledige Timber-context. Blade rendert ook pagina’s, patronen en templates van de Site-editor. De oudere wrapper jenssegers/blade werkt niet met illuminate/view 10 en hoger, dus gebruik in plaats daarvan 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>Voorwaardelijke logica en dynamische opties
Toon en verberg velden met operatoren zoals ==, !=, includes, empty en vergelijkingen. Combineer voorwaarden met OR-logica.
Opties kunnen afhankelijk zijn van een ander veld. Voeg {attributes.post_type.value} toe aan de populate-argumenten en de lijst wordt opnieuw geladen wanneer dat veld verandert. Voeg fetch: true toe om berichten te doorzoeken terwijl de editor typt.
Deel één optielijst tussen blokken met type: custom en het filter blockstudio/blocks/attributes/populate, en registreer via blockstudio/blocks/conditions je eigen globale voorwaarden, zoals een aankoopcontrole.
{
"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;
});Repeaters die beheersbaar blijven
Stel min en max in, begin nieuwe blokken met default rijen en klap bestaande rijen in met minimized. textMinimized geeft een ingeklapte rij het label van een van de eigen velden, zoals een naam.
Rijen accepteren elk veldtype behalve tabs, inclusief geneste repeaters. Een voorwaarde in een rij controleert met "context": "main" een veld erbuiten, en met <RichText /> en <MediaPlaceholder /> bewerk je één rij wanneer hun attribute naar repeaterId[index].fieldId verwijst.
{
"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>Herbruikbare veldsets
Definieer een groep velden één keer in een field.json en verwijs er vanuit elk blok naar met "type": "custom/cta". De velden worden inline ingevoegd, zodat templates ze lezen als elk ander attribuut.
Gebruik dezelfde set twee keer met een idStructure zoals hero_{id} en wijzig labels, standaardwaarden of voorwaarden per blok met overrides. Het veldtype block doet hetzelfde met een heel blok: het voegt de velden van dat blok inline in en retourneert de gerenderde 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-modules zonder buildstap
Voeg script.js toe en het wordt als ES-module geladen. Importeer npm-pakketten met het voorvoegsel npm: en Blockstudio downloadt ze lokaal voor productie.
De editor toont direct een voorbeeld, terwijl de frontend lokale modules zonder externe afhankelijkheden gebruikt, die slechts één keer worden toegevoegd aan de wachtrij.
Stylesheets worden op dezelfde manier geïmporteerd. import "npm:swiper@11.0.0/swiper.min.css" downloadt het bestand en voegt het eenmaal per versie toe aan de wachtrij, ook wanneer meerdere blokken het gebruiken.
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,
});
}Blokt tags buiten templates
Koppel een korte prefix aan een namespace in blockstudio.json, of één tag aan één blok met een aliasfilter, waarna <acme-card> acme/card rendert. Schakel blockTags.enabled in om tags in berichtinhoud en widgets te renderen, beperkt door patronen allow en deny.
Attributen van data-* komen op het hoofdelement van het blok terecht, en attributen van html-* komen daar zonder prefix aan. Voeg je eigen tagbuilders toe met blockstudio/block_tags/builders en herschrijf afkortingen naar de draagbare schrijfwijze <bs:acme-card> met de opdracht 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>Aangepaste veldtypen
Registreer uw eigen veldbediening en gebruik deze als een ingebouwd veld.
Blokeilanden
Cache de hele pagina en render één blok tijdens het verzoek van de bezoeker.
Voorwaardelijke registratie
Registreer een blok alleen voor een berichttype, gebruikersrol of andere globale voorwaarde, of sla het over als een vereiste plugin of pluginversie ontbreekt.
Berichtmeta en opties
Sla waarden op in berichtmeta of opties, naast blokkenmerken.
Voorwaardelijke logica
Toon velden op basis van waarden met gelijkheid, opname, leegte en vergelijkingen.
Dynamische gegevensbronnen
Vul keuzes vanuit berichten, gebruikers, termen, functies of API’s.
Overschrijvingen
Stel override: true in met de naam van een gedeeld blok om attributen op id samen te voegen, assets met dezelfde bestandsnaam te vervangen en de template om te wisselen. Met extends kunnen Twig-templates afzonderlijke blokken overschrijven.
Varianten
Declareer variaties in block.json die veldwaarden vooraf instellen, en verberg het veld dat deze aanstuurt met hidden.
Componenten
Stel component: true in voor een blok dat alleen vanuit PHP of bloktags wordt gerenderd. Het behoudt velden, templates, assets en Tailwind, maar verschijnt nooit in de invoeger.
Regels voor InnerBlocks
Sta blokken toe met namespace/*-, category:- en @theme-tokens, wissel de binnenste template via een selectoptie en verwijder de wrapper aan de voorkant met een filter.
Assets voor codevelden
Een codeveld met asset: true zet editorinvoer om in CSS, SCSS of JavaScript voor dat blok, beperkt tot de instantie via %selector%.
Assets op basis van bestandsnaam
*.view.js wordt alleen aan de voorkant geladen, en de prefixes global-, admin- en block-editor- laden een bestand op elke pagina, in wp-admin of in de blokeditor.
Pictogrammen en blokmappen
Geef een blok een eigen SVG- of HTML-pictogram, wijzig de locatie waar blokken worden gevonden met het blockstudio/path-filter en voeg mappen toe met Blockstudio\Build::init().
Waarden van ACF en Meta Box
Templates ontvangen $post_id, zodat get_field() en rwmb_get_value() het bewerkte bericht lezen; refreshOn vernieuwt het voorbeeld na het opslaan.
Query Loop-context
Binnen een Query Loop volgt $block[‘context’][‘postId’] het huidige item, terwijl $block[‘postId’] het bericht blijft waarop je je bevindt.
WPML
wp bs wpml config schrijft de wpml-config.xml die tekstvelden markeert als vertaalbaar, en afbeeldingen die in velden zijn opgeslagen, worden samen met hun alternatieve teksten en bijschriften toegevoegd aan de vertaalopdrachten van WPML.
De officiële uitbreidingskit
Premium-sitetemplates, AI-systeeminstructies en een privécommunity van Discord. Eenmalige aankoop, levenslange updates.
- 500+ websitesjablonen
- Systeeminstructies voor AI
- Updates voor altijd
- Privécommunity van Discord