Tilpassede blokke i 3 filer
Ingen JavaScript, intet byggetrin, ingen standardkode.
Definér felter i JSON
Tilføj en blockstudio-nøgle til block.json. Definér attributter med typer som text, toggle og color. Blockstudio genererer automatisk editoren UI med 27 felttyper fra tekstfelter til repeatere og kodeeditorer samt felttyper, du selv registrerer.
Fuld understøttelse af JSON-skemaer giver autofuldførelse og validering i VS Code, PhpStorm og alle kompatible editorer.
Hvert felt kan angive en default for nye blokke og en fallback, som skabelonen modtager, når feltet er 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" }
]
}
}Arbejdsgang med 3 filer
block.json til felter, en skabelon til markup og et valgfrit typografiark.
React i PHP
RichText, InnerBlocks og useBlockProps fungerer direkte i PHP, Twig eller Blade.
SCSS og Tailwind
Brug CSS, SCSS eller Tailwind. SCSS understøtter importstier og en delt prelude, og når du redigerer en indlejret partial, kompileres alle filer, der importerer den, igen.
27 felttyper
Tekst, farve, billede, gentager, valgliste, kodeeditor og mere, konfigureret i JSON.
JSON Schema
Autofuldførelse og validering i VS Code, PhpStorm og kompatible editorer.
Tre skabelonsprog
PHP, Twig og Blade bruger de samme variabler og komponenter.
npm-importer
Importér pakker i script.js; lokalt i produktion og baseret på CDN i editoren.
Interactivity API
Aktivér WordPress Interactivity API med ét flag.
React-komponenter i PHP-skabeloner
Brug <RichText /> til inline-redigering og statisk frontend-HTML, <InnerBlocks /> til underordnede blokke og useBlockProps som wrapper, alt sammen i én skabelon.
I editoren bliver de til rigtige React-komponenter. På frontend gengives de som serverbaseret HTML, uden at JavaScript sendes til de besøgende.
<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
Brug det skabelonsprog, du kender. PHP fungerer direkte, Twig kører, når Timber er installeret, og Blade kører på illuminate/view 8 til 12 via Blockstudio\Blade_Renderer. Variablerne, komponenterne og funktionaliteten er den samme.
$a (attributter), $b (blok), $c (kontekst) og $innerBlocks er tilgængelige i alle sprog.
Twig-skabeloner modtager også hele Timber-konteksten. Blade gengiver også sider, mønstre og Site Editor-skabeloner. Den ældre wrapper jenssegers/blade virker ikke med illuminate/view 10 og nyere versioner, så brug Blade_Renderer i stedet.
<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>Betinget logik og dynamiske valgmuligheder
Vis og skjul felter med operatorer som ==, !=, includes, empty og sammenligninger. Kombinér betingelser med OR-logik.
Indstillinger kan afhænge af et andet felt. Sæt {attributes.post_type.value} ind i argumenterne til populate, så indlæses listen igen, når feltet ændres. Tilføj fetch: true for at søge efter indlæg, mens redaktøren skriver.
Del én indstillingsliste på tværs af blokke med type: custom og filteret blockstudio/blocks/attributes/populate, og registrer dine egne globale betingelser, f.eks. et køb i en kontrol, 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;
});Repeatere, der er nemme at administrere
Angiv min og max, start nye blokke med default rækker, og fold eksisterende rækker sammen med minimized. textMinimized mærker en sammenfoldet række med et af dens egne felter, f.eks. et navn.
Rækker accepterer alle felttyper undtagen faner, herunder indlejrede repeatere. En betingelse i en række kontrollerer et felt uden for den med "context": "main", og <RichText /> og <MediaPlaceholder /> redigerer en enkelt række, når deres attribute peger 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>Genanvendelige feltsæt
Definer en gruppe felter én gang i en field.json, og henvis til den fra enhver blok med "type": "custom/cta". Felterne indsættes direkte, så skabeloner læser dem som enhver anden attribut.
Brug det samme sæt to gange med en idStructure som hero_{id}, og tilpas etiketter, standardværdier eller betingelser for hver blok med overrides. Felttypen block gør det samme med en hel blok: Den udfolder blokkens felter direkte og returnerer dens gengivne 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 uden byggetrin
Tilføj script.js, så indlæses den som et ES-modul. Importér npm-pakker med præfikset npm:, og Blockstudio downloader dem lokalt til produktion.
Editoren får øjeblikkelig forhåndsvisning, mens frontend bruger lokale moduler uden eksterne afhængigheder, som kun indlæses én gang.
Stylesheets importeres på samme måde. import "npm:swiper@11.0.0/swiper.min.css" downloader filen og tilføjer den i kø én gang pr. version, også når flere blokke bruger 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,
});
}Bloktags ud over skabeloner
Tilknyt et kort præfiks til et namespace i blockstudio.json, eller ét tag til én blok med et aliasfilter, så gengiver <acme-card> acme/card. Slå blockTags.enabled til for at gengive tags i indlægsindhold og widgets, begrænset af mønstrene allow og deny.
data-*-attributter når blokkens rodelement, og html-*-attributter ankommer dertil uden præfikset. Tilføj dine egne tagbyggere med blockstudio/block_tags/builders, og omskriv kortformer til den portable stavemåde <bs:acme-card> med kommandoen 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>Tilpassede felttyper
Registrér din egen feltkontrol, og brug den som et indbygget felt.
Blokøer
Cache hele siden, og gengiv én blok i den besøgendes anmodning.
Betinget registrering
Registrer kun en blok for en indlægstype, brugerrolle eller anden global betingelse, eller spring den over, hvis et nødvendigt plugin eller en nødvendig pluginversion mangler.
Indlægsmetadata og indstillinger
Gem værdier i indlægsmetadata eller indstillinger sammen med blokattributter.
Betinget logik
Vis felter baseret på værdier med lighed, medlemskab, tomhed og sammenligninger.
Dynamiske datakilder
Hent valgmuligheder fra indlæg, brugere, termer, funktioner eller API’er.
Tilsidesættelser
Sæt override: true sammen med navnet på en delt blok for at flette attributter efter id, erstatte aktiver med matchende filnavne og skifte skabelonen. Twig-skabeloner kan tilsidesætte enkelte blokke med extends.
Variationer
Deklarer variationer i block.json, som forudindstiller feltværdier, og skjul feltet, der styrer dem, med hidden.
Komponenter
Sæt component: true for en blok, der kun gengives fra PHP eller bloktags. Den beholder felter, skabeloner, aktiver og Tailwind, men vises aldrig i indsættelsesværktøjet.
Regler for InnerBlocks
Tillad blokke med tokensene namespace/*, category: og @theme, skift den indre skabelon fra en select-indstilling, og fjern wrapperen på frontend med et filter.
Aktiver til kodefelter
Et kodefelt med asset: true omdanner input fra editoren til CSS, SCSS eller JavaScript for den blok, afgrænset til instansen via %selector%.
Aktiver efter filnavn
*.view.js indlæses kun på frontend, og præfikserne global-, admin- og block-editor- indlæser en fil på hver side, i wp-admin eller i blokeditoren.
Ikoner og blokmapper
Giv en blok et brugerdefineret SVG- eller HTML-ikon, flyt søgningen med blockstudio/path-filteret, og tilføj mapper med Blockstudio\Build::init().
Værdierne ACF og Meta Box
Skabeloner modtager $post_id, så get_field() og rwmb_get_value() læser det redigerede indlæg, og refreshOn opdaterer forhåndsvisningen efter lagring.
Kontekst for Query Loop
I en Query Loop følger $block[‘context’][‘postId’] det aktuelle element, mens $block[‘postId’] forbliver det indlæg, der vises.
WPML
wp bs wpml config skriver wpml-config.xml, som markerer tekstfelter som oversættelige, og billeder gemt i felter føjes til WPML-oversættelsesopgaver med deres alternativtekster og billedtekster.
Det officielle udvidelsessæt
Premiumskabeloner til websteder, AI-systeminstruktioner og et privat Discord-fællesskab. Engangskøb med opdateringer hele livet.
- 500+ hjemmesideskabeloner
- AI-systeminstruktioner
- Opdateringer hele livet
- Privat Discord-fællesskab