Ugrás a tartalomhoz

Egyéni blokkok 3 fájlban

Nincs JavaScript, nincs buildlépés, nincs sablonkód.

Mezők meghatározása itt: JSON

Adjon hozzá egy blockstudio kulcsot a block.json elemhez. Határozza meg az attribútumokat olyan típusokkal, mint text, toggle és color. A Blockstudio automatikusan létrehozza a szerkesztő UI elemét, 27 mezőtípussal a szövegbeviteli mezőktől az ismétlőkön és kódszerkesztőkön át, valamint az Ön által regisztrált mezőtípusokkal.

A teljes JSON séma támogatása automatikus kiegészítést és ellenőrzést biztosít a VS Code, a PhpStorm és minden kompatibilis szerkesztőben.

Minden mező megadhat egy default értéket az új blokkokhoz, valamint egy fallback értéket, amelyet a sablon akkor kap meg, amikor a mező üres.

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

Háromfájlos munkafolyamat

block.json a mezőkhöz, egy sablon a jelölőkódhoz és egy opcionális stíluslap.

React a PHP nyelvben

A RichText, az InnerBlocks és a useBlockProps közvetlenül működik a PHP, a Twig vagy a Blade nyelvben.

SCSS és Tailwind

Használja a CSS, a SCSS vagy a Tailwind elemet. A SCSS támogatja az importálási útvonalakat és a megosztott előbetöltést; egy beágyazott részfájl szerkesztése újrafordítja az összes fájlt, amely importálja azt.

27 mezőtípus

Szöveg, szín, kép, ismétlő, választó, kódszerkesztő és más mezők beállítása itt: JSON.

JSON Schema

Automatikus kiegészítés és ellenőrzés a VS Code, a PhpStorm és a kompatibilis szerkesztők számára.

Három sablonnyelv

A PHP, a Twig és a Blade ugyanazokat a változókat és komponenseket használja.

npm importálása

Csomagok importálása a script.js nyelvben; helyi használat produkcióban, a szerkesztőben pedig CDN-alapú betöltés.

Interactivity API

Egyetlen kapcsolóval engedélyezd a WordPress Interactivity API funkciót.

React-komponensek PHP-sablonokban

Használd a <RichText /> elemet a helyben történő szerkesztéshez és a statikus frontend HTML-hez, a <InnerBlocks /> elemet a gyermekblokkokhoz, a useBlockProps elemet pedig a burkolóhoz; mindez egyetlen sablonban elfér.

A szerkesztőben ezek valódi React-komponensekké válnak. A frontenden szerveroldali HTML formájában jelennek meg, és nem kerül JavaScript a látogatókhoz.

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>

Írj PHP, Twig vagy Blade nyelven

Használja az Ön által ismert sablonnyelvet. A PHP azonnal működik, a Twig a Timber telepítése után fut, a Blade pedig a illuminate/view 8–12-es verzióján fut a Blockstudio\Blade_Renderer segítségével. A változók, komponensek és működés változatlan marad.

A $a (attribútumok), a $b (blokk), a $c (kontextus) és a $innerBlocks minden nyelven elérhető.

A Twig sablonok is megkapják a teljes Timber kontextust. A Blade oldalakat, mintázatokat és a Webhelyszerkesztő sablonjait is megjeleníti. A régebbi jenssegers/blade burkoló nem működik a illuminate/view 10-es és újabb verzióival, ezért inkább a Blade_Renderer elemet használja.

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>

Feltételes logika és dinamikus lehetőségek

Mezők megjelenítése és elrejtése többek között a ==, a !=, a includes és a empty operátorokkal, valamint összehasonlításokkal. A feltételek OR-logikával kombinálhatók.

A beállítások függhetnek egy másik mezőtől. Helyezze a {attributes.post_type.value} elemet a feltöltési argumentumok közé, és a lista újratöltődik, amikor az adott mező értéke megváltozik. Adja hozzá a fetch: true elemet, hogy a bejegyzések keresése a szerkesztő gépelése közben történjen.

Osszon meg egyetlen opciólistát a blokkok között a type: custom és a blockstudio/blocks/attributes/populate szűrő használatával, és regisztrálja saját globális feltételeit, például egy vásárlás ellenőrzését, a blockstudio/blocks/conditions segítségével.

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

Könnyen kezelhető ismétlők

Állítsa be a min és a max értékét, indítsa az új blokkokat default sorral, a meglévő sorokat pedig csukja össze a minimized segítségével. A textMinimized a sor egyik saját mezőjével, például egy névvel jelöli az összecsukott sort.

A sorok bármilyen mezőtípust elfogadnak a füleken kívül, a beágyazott ismétlőket is beleértve. A soron belüli feltétel a soron kívüli mezőt a "context": "main" segítségével ellenőrzi, a <RichText /> és a <MediaPlaceholder /> pedig egyetlen sort szerkeszt, ha a attribute a repeaterId[index].fieldId elemre mutat.

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

Újrafelhasználható mezőkészletek

Definiáljon egyszer egy mezőcsoportot egy field.json elemben, majd hivatkozzon rá bármelyik blokkból a "type": "custom/cta" segítségével. A mezők beágyazódnak, így a sablonok ugyanúgy olvashatják őket, mint bármely más attribútumot.

Használja kétszer ugyanazt a készletet egy olyan idStructure segítségével, mint a hero_{id}, és módosítsa a címkéket, az alapértelmezett értékeket vagy a feltételeket blokkonként a overrides segítségével. A block mezőtípus ugyanezt teszi egy teljes blokkal: beágyazza a blokk mezőit, és visszaadja a megjelenített HTML értékét.

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-modulok buildlépés nélkül

Add hozzá a script.js elemet, és ES-modulként töltődik be. A npm: előtagú npm csomagokat a Blockstudio tölti le helyben a produkciós környezethez.

A szerkesztő azonnali előnézetet ad, a frontend pedig helyi modulokat használ külső függőségek nélkül; a rendszer csak egyszer veszi fel őket a betöltési sorba.

A stíluslapok importálása ugyanígy működik. A import "npm:swiper@11.0.0/swiper.min.css" letölti a fájlt, és verziónként egyszer sorba állítja, még akkor is, ha több blokk használja.

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,
  });
}

Blokktagek a sablonokon túl

Rendeljen rövid előtagot egy névtérhez a blockstudio.json segítségével, vagy egy taget egy blokkhoz egy álnévs szűrővel, majd jelenítse meg a acme/card elemet a <acme-card> segítségével. Kapcsolja be a blockTags.enabled beállítást a bejegyzések tartalmában és a widgetekben lévő tagek megjelenítéséhez; a lehetőséget a allow és a deny minták korlátozzák.

A data-* attribútumok a blokk gyökéreleméhez kerülnek, a html-* attribútumok pedig előtag nélkül jutnak oda. Adjon hozzá saját tagépítőket a blockstudio/block_tags/builders segítségével, és írja át a rövid alakokat hordozható <bs:acme-card> formára a migrate-block-tags paranccsal.

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

Egyéni mezőtípusok

Regisztráld a saját mezővezérlődet, és használd úgy, mint a beépített mezőket.

Blokkszigetek

Gyorsítótárazd a teljes oldalt, és egy blokkot a látogató kérésére renderelj.

Feltételes regisztráció

Regisztráljon egy blokkot csak egy bejegyzéstípushoz, felhasználói szerepkörhöz vagy más globális feltételhez, vagy hagyja ki, ha egy szükséges bővítmény vagy annak verziója hiányzik.

Bejegyzésmeta és beállítások

Az értékeket a blokk attribútumai mellett a bejegyzésmeta vagy a beállítások között tárold.

Feltételes logika

Mezők megjelenítése az értékek alapján: egyenlőség, tagság, üresség és összehasonlítás.

Dinamikus feltöltés

A választási lehetőségek bejegyzésekből, felhasználókból, kifejezésekből, függvényekből vagy API-kból tölthetők fel.

Felülbírálások

Állítsa be az override: true értéket egy megosztott blokk nevével, hogy az attribútumok azonosító szerint egyesüljenek, az azonos fájlnevű erőforrások lecserélődjenek, a sablon pedig kicserélődjön. A Twig sablonok az extends segítségével egyesével is felülírhatják a blokkokat.

Változatok

Deklaráljon a block.json segítségével olyan variációkat, amelyek előre beállítják a mezőértékeket, a vezérlőmezőt pedig rejtse el a hidden segítségével.

Komponensek

Állítsa be a component: true értéket egy olyan blokknál, amely csak a PHP vagy a blokktagek alapján jelenik meg. Megőrzi a mezőket, sablonokat, erőforrásokat és a Tailwind elemet, de nem jelenik meg a beszúróban.

InnerBlocks-szabályok

Engedélyezze a namespace/*, category: és @theme tokeneket tartalmazó blokkokat, válasszon belső sablont egy select opcióval, és távolítsa el a burkolót a frontenden egy szűrő segítségével.

Kódmezők erőforrásai

Az asset: true értékű kódmező a szerkesztői bevitelt CSS, SCSS vagy JavaScript fájllá alakítja az adott blokkhoz, a példányra korlátozva a %selector% segítségével.

Fájlnév alapján kezelt eszközök

*A .view.js csak a frontenden töltődik be, a global-, admin- és block-editor- előtagok pedig minden oldalon, a wp-admin felületen vagy a blokkszerkesztőben töltenek be egy fájlt.

Ikonok és blokkmappák

Adjon egy blokknak egyéni SVG- vagy HTML ikont, módosítsa a felfedezés helyét a blockstudio/path szűrővel, és adjon hozzá mappákat a Blockstudio\Build::init() segítségével.

ACF és Meta Box értékek

A sablonok megkapják a $post_id elemet, így a get_field() és a rwmb_get_value() a szerkesztett bejegyzést olvassa, a refreshOn pedig mentés után frissíti az előnézetet.

A Query Loop kontextusa

Egy Query Loopon belül a $block[‘context’][‘postId’] az aktuális elemet követi, míg a $block[‘postId’] a megtekintett bejegyzés azonosítója marad.

WPML

A wp bs wpml config létrehozza a wpml-config.xml fájlt, amely megjelöli a szövegmezőket fordíthatóként; a mezőkben tárolt képek pedig az alternatív szövegükkel és képaláírásukkal együtt bekerülnek a WPML fordítási feladatai közé.

Plus

A hivatalos bővítőkészlet

Prémium webhelysablonok, MI-rendszerutasítások és privát Discord közösség. Egyszeri vásárlás, élethosszig tartó frissítések.

  • 500+ webhelysablon
  • AI-rendszerutasítások
  • Élettartamra szóló frissítések
  • Privát Discord közösség