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

[Reference til felttyper](https://blockstudio.dev/da/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" }
    ]
  }
}
```

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

[Udforsk komponenter](https://blockstudio.dev/da/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>
```

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

[Skabelonsprog](https://blockstudio.dev/da/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>
```

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

[Betinget logik](https://blockstudio.dev/da/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" }
        ]]
      }
    ]
  }
}
```

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

[Repeatermønstre](https://blockstudio.dev/da/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" }
        ]
      }
    ]
  }
}
```

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

[Brugerdefinerede felter](https://blockstudio.dev/da/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-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.

[Behandling af aktiver](https://blockstudio.dev/da/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,
  });
}
```

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

[Læs vejledningen](https://blockstudio.dev/da/guides/block-tags/)

blockstudio.json

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

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

Plus

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

[Få Plus](https://blockstudio.dev/da/plus/)
