Gå til indhold

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.

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.

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.

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.

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.

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.

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.

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.

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