# 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.

[Referentie voor veldtypen](https://blockstudio.dev/nl/docs/blocks/attributes/field-types/)

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.

[Ontdek de componenten](https://blockstudio.dev/nl/docs/blocks/react-components/)

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`.

[Templatetalen](https://blockstudio.dev/nl/docs/blocks/templating/blade/)

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.

[Voorwaardelijke logica](https://blockstudio.dev/nl/docs/blocks/attributes/conditional-logic/)

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.

[Repeaterpatronen](https://blockstudio.dev/nl/guides/field-patterns/#repeater-patterns)

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.

[Aangepaste velden](https://blockstudio.dev/nl/docs/blocks/attributes/custom-fields/)

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.

[Assets verwerken](https://blockstudio.dev/nl/docs/blocks/assets/)

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`.

[Lees de handleiding](https://blockstudio.dev/nl/guides/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

[Neem Plus](https://blockstudio.dev/nl/plus/)
