Ga naar de inhoud

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.

block.json
{
  "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.

index.php
<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.

index.twig
<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>

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.

block.json
{
  "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" }
        ]]
      }
    ]
  }
}

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.

block.json
{
  "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" }
        ]
      }
    ]
  }
}

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.

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" }
  ]
}

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.

script.js
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.

blockstudio.json
{
  "blockTags": {
    "enabled": true,
    "prefixes": {
      "acme": ["acme"],
      "ui": ["acme-ui"]
    },
    "deny": ["acme-ui/admin-*"]
  }
}

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.

Plus

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