Hoppa till innehåll

Egna block i 3 filer

Ingen JavaScript, inget byggsteg, ingen standardkod.

Definiera fält i JSON

Lägg till en blockstudio-nyckel i block.json. Definiera attribut med typer som text, toggle och color. Blockstudio genererar automatiskt redigerarens UI, med 27 fälttyper, från textfält till upprepningsfält och kodredigerare, samt fälttyper som du själv registrerar.

Fullständigt stöd för JSON Schema ger komplettering och validering i VS Code, PhpStorm och alla kompatibla redigerare.

Varje fält kan ange ett default för nya block och ett fallback som mallen får när fältet är 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" }
    ]
  }
}

Arbetsflöde med tre filer

block.json för fält, en mall för markup och en valfri formatmall.

React i PHP

RichText, InnerBlocks och useBlockProps fungerar direkt i PHP, Twig eller Blade.

SCSS och Tailwind

Använd CSS, SCSS eller Tailwind. SCSS stöder importsökvägar och en gemensam inledning, och när du redigerar en nästlad del kompileras alla filer som importerar den på nytt.

27 fälttyper

Text, färg, bild, upprepare, väljare, kodredigerare med mera, konfigureras i JSON.

JSON Schema

Komplettering och validering i VS Code, PhpStorm och kompatibla redigerare.

Tre mallspråk

PHP, Twig och Blade delar samma variabler och komponenter.

npm-importer

Importera paket i script.js; lokalt i produktion och med stöd av CDN i redigeraren.

Interactivity API

Aktivera WordPress Interactivity API med en enda flagga.

React-komponenter i PHP-mallar

Använd <RichText /> för redigering direkt på sidan och statisk frontend-HTML, <InnerBlocks /> för underordnade block och useBlockProps för omslaget, allt i en enda mall.

I redigeraren blir dessa riktiga React-komponenter. På frontend renderas de som serverbaserad HTML, utan att någon JavaScript skickas till besökarna.

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

Använd det mallspråk du känner till. PHP fungerar direkt, Twig körs när Timber har installerats och Blade körs på illuminate/view 8 till 12 via Blockstudio\Blade_Renderer. Variablerna, komponenterna och beteendet förblir desamma.

$a (attribut), $b (block), $c (kontext) och $innerBlocks finns tillgängliga i alla språk.

Twig-mallar får också hela kontexten Timber. Blade renderar även sidor, mönster och Site Editor-mallar. Den äldre omslutaren jenssegers/blade fungerar inte med illuminate/view 10 och senare, så använd Blade_Renderer i stället.

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>

Villkorsstyrd logik och dynamiska alternativ

Visa och dölj fält med operatorer som ==, !=, includes, empty och jämförelser. Kombinera villkor med OR-logik.

Alternativ kan bero på ett annat fält. Lägg till {attributes.post_type.value} i populate-argumenten så läses listan in på nytt när det fältet ändras. Lägg till fetch: true för att söka bland inlägg medan redaktören skriver.

Dela en alternativlista mellan block med type: custom och filtret blockstudio/blocks/attributes/populate, och registrera egna globala villkor, till exempel en köpkontroll, 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" }
        ]]
      }
    ]
  }
}

Repetitionsfält som förblir hanterbara

Ange min och max, starta nya block med default rader och fäll ihop befintliga rader med minimized. textMinimized märker en hopfälld rad med ett av dess egna fält, till exempel ett namn.

Rader accepterar alla fälttyper utom flikar, även nästlade repetitionsfält. Ett villkor i en rad kontrollerar ett fält utanför den med "context": "main", och <RichText /> och <MediaPlaceholder /> redigerar en enskild rad när deras attribute pekar 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" }
        ]
      }
    ]
  }
}

Återanvändbara fältuppsättningar

Definiera en grupp fält en gång i en field.json och hänvisa till den från vilket block som helst med "type": "custom/cta". Fälten bäddas in direkt, så mallar läser dem som vilket annat attribut som helst.

Använd samma uppsättning två gånger med en idStructure, till exempel hero_{id}, och ändra etiketter, standardvärden eller villkor per block med overrides. Fälttypen block gör samma sak med ett helt block: den expanderar blockets fält direkt och returnerar dess renderade 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 utan byggsteg

Lägg till script.js så läses den in som en ES-modul. Importera npm-paket med prefixet npm:, så laddar Blockstudio ned dem lokalt för produktion.

Redigeraren får en direkt förhandsvisning, medan frontend använder lokala moduler utan externa beroenden, som köas in endast en gång.

Stilmallar importeras på samma sätt. import "npm:swiper@11.0.0/swiper.min.css" hämtar filen och lägger till den i kön en gång per version, även när flera block använder 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,
  });
}

Blocktaggar utöver mallar

Koppla ett kort prefix till ett namnrymd i blockstudio.json, eller en tagg till ett block med ett aliasfilter, så renderar <acme-card> acme/card. Aktivera blockTags.enabled för att rendera taggar i inläggsinnehåll och widgetar, begränsat av mönstren allow och deny.

Attribut från data-* når blockets rotelement, och attribut från html-* kommer dit utan prefixet. Lägg till egna taggbyggare med blockstudio/block_tags/builders och skriv om kortformer till den portabla stavningen <bs:acme-card> med kommandot migrate-block-tags.

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

Anpassade fälttyper

Registrera en egen fältkontroll och använd den som ett inbyggt fält.

Blocköar

Cacha hela sidan och rendera ett block i besökarens begäran.

Villkorad registrering

Registrera ett block endast för en inläggstyp, användarroll eller annat globalt villkor, eller hoppa över det om ett plugin eller den pluginversion det behöver saknas.

Inläggsmetadata och alternativ

Lagra värden i inläggsmetadata eller alternativ tillsammans med blockattribut.

Villkorsstyrd logik

Visa fält baserat på värden med likhet, inkludering, tomhet och jämförelser.

Dynamiska datakällor

Hämta val från inlägg, användare, termer, funktioner eller API:er.

Åsidosättningar

Ange override: true med namnet på ett delat block för att slå samman attribut efter id, ersätta tillgångar med matchande filnamn och byta mall. Twig-mallar kan åsidosätta enskilda block med extends.

Varianter

Ange varianter i block.json som förinställer fältvärden, och dölj fältet som styr dem med hidden.

Komponenter

Ange component: true för ett block som renderas endast från PHP eller blocktaggar. Det behåller fält, mallar, tillgångar och Tailwind men visas aldrig i infogaren.

Regler för InnerBlocks

Tillåt block med tokensen namespace/*, category: och @theme, byt den inre mallen från ett select-alternativ och ta bort omslutaren på frontend med ett filter.

Tillgångar för kodfält

Ett kodfält med asset: true omvandlar redigerarens inmatning till CSS, SCSS eller JavaScript för det blocket, avgränsat till instansen med %selector%.

Resurser efter filnamn

*.view.js laddas endast på frontend, och prefixen global-, admin- och block-editor- laddar en fil på varje sida, i wp-admin respektive i blockredigeraren.

Ikoner och blockmappar

Ge ett block en anpassad SVG- eller HTML-ikon, flytta sökningen med filtret blockstudio/path och lägg till mappar med Blockstudio\Build::init().

Värden för ACF och Meta Box

Mallar får $post_id, så get_field() och rwmb_get_value() läser det redigerade inlägget, och refreshOn uppdaterar förhandsvisningen efter att du har sparat.

Kontext för Query Loop

I en Query Loop följer $block[‘context’][‘postId’] det aktuella objektet, medan $block[‘postId’] förblir inlägget som visas.

WPML

wp bs wpml config skriver wpml-config.xml, som markerar textfält som översättningsbara, och bilder som lagras i fält läggs till i WPML-översättningsjobb med sina alt-texter och bildtexter.

Plus

Det officiella tilläggspaketet

Premiumwebbplatsmallar, systeminstruktioner för AI och en privat Discord-community. Engångsköp, uppdateringar på livstid.

  • 500+ webbplatsmallar
  • AI-systeminstruktioner
  • Uppdateringar livet ut
  • Privat Discord-community