Ugrás a tartalomhoz

Dennis · 2026. március 14.

Blockstudio 7.1

A Blockstudio 7.1 az első funkciókiadás a v7 átírása óta. Míg a v7 új alapokra helyezte a rendszert, a 7.1 olyan elemeket ad hozzá, amelyekkel a blokkok többre képesek: adatbázisréteget, szerverfunkciókat, ütemezett feladatokat és egy CLI. Egy blokk mappája most már teljes alkalmazás lehet.

Íme az összes újdonság.

Komponensek

Mindig is volt némi feszültség az olyan blokkok között, amelyeket a szerkesztők a beszúróban használnak, és azok között, amelyeket a fejlesztők más dolgok építőelemeiként használnak. Egy kártya, egy jelvény, egy statisztikai widget, egy űrlapmező. Szükségük van a teljes Blockstudio folyamatra (attribútumok, sablonok, eszközfájlok, Tailwind), de semmi keresnivalójuk a beszúróban.

A 7.1 komponenseket vezet be ennek megoldására. Állítsa be a "component": true értéket a block.json fájlban, és a blokk végigmegy a teljes összeállítási folyamaton, de nem kerül be a WordPress blokktípus-nyilvántartásába. Nem jelenik meg a beszúróban, és nem kerül bele a JavaScript-nek küldött szerkesztői adatokba, de programozott megjelenítésre teljesen használható.

JSON
{
  "name": "my-theme/card",
  "title": "Card",
  "blockstudio": {
    "component": true,
    "attributes": [
      { "id": "title", "type": "text" },
      { "id": "description", "type": "textarea" }
    ]
  }
}

Jelenítse meg őket innen: PHP:

PHP
bs_render_block([
  'name' => 'my-theme/card',
  'data' => ['title' => 'My Card', 'description' => 'Card content.'],
]);

Vagy az új HTML címkeszintaxissal:

HTML
<bs:my-theme-card title="My Card" description="Card content." />

Blokkcímkék

A blokkok mostantól HTML címkékként ágyazhatók be, két felcserélhető szintaxis használatával:

HTML
<bs:acme-hero title="Welcome" />
<block name="acme/hero" title="Welcome" />

Mindkettő ugyanazt az eredményt adja. Mindkettő működik a Blockstudio blokkokkal és az alapvető WordPress blokkokkal. A blokk sablonjain belül külön bekapcsolás nélkül, automatikusan jelennek meg. Így a sablonban közvetlenül más blokkokból állíthat össze teljes elrendezéseket:

Twig
<div class="my-page">
  <bs:mytheme-card title="Featured" />
  <block name="core/separator" />
  <bs:core-heading level="2">Section Title</bs:core-heading>
  <block name="core/group">
    <block name="core/paragraph">Inside a core group block.</block>
    <bs:mytheme-cta variant="primary" />
  </block>
</div>

A két szintaxis szabadon egymásba ágyazható. A Blockstudio blokkok végigmennek a teljes folyamaton (sablonok, Tailwind, eszközfájlok). Az alapblokkok megjelenítését a WordPress végzi ugyanazokkal a megjelenítőkkel, amelyek a Pages and Patterns funkciót is működtetik.

Az oldalszintű megjelenítéshez (bejegyzéstartalom, widgetterületek) engedélyezze ezt itt: blockstudio.json:

JSON
{ "blockTags": { "enabled": true } }

Az engedélyezési és tiltólisták helyettesítő mintákkal szabályozzák, mely blokkok jeleníthetők meg címkéken keresztül. A data-* és html-* attribútumok változatlanul átkerülnek a megjelenített blokk gyökér HTML elemébe. Egyéni megjelenítők a blockstudio/block_tags/renderers szűrővel regisztrálhatók.

A háttérben a címkeelemző egy új, könnyű karakterlánc-olvasó, amely teljesen kiváltja a DOMDocumentet. Mélységkövetéssel kezeli a beágyazott címkéket, a rekurzív tárolóblokkokat és az egyetlen menetben feldolgozott vegyes szintaxist. A teljesítménymérésekben 1,000 egyszerű címkét 2,4 ms alatt, 100 egymásba ágyazási szintet pedig 3,7 ms alatt elemez, így következetesen gyorsabb a DOMDocumentnél és a WordPress WP_HTML_Tag_Processor megoldásánál. Ugyanez az elemző a Pages and Patterns funkcióhoz a nyers HTML elemeket is feldolgozza, és kiváltja a korábbi, DOMDocument-alapú elemzőt, amely a <p>, <div> és más HTML elemeket kezelte.

Új mezőtípusok

Blokk

Új block mezőtípus, amellyel egy másik Blockstudio blokk attribútumként hivatkozható. A hivatkozott blokk mezői a idStructure és overrides segítségével, a saját mezőkhöz hasonlóan, beágyazva jelennek meg. A különbség: a sablonban az érték elérése a megjelenített blokk kimenetét adja vissza.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "card",
        "type": "block",
        "block": "mytheme/card",
        "idStructure": "card_{id}"
      }
    ]
  }
}

Ha a mytheme/card rendelkezik heading és content mezővel, a befogadó blokk oldalsávján megjelenik a card_heading és a card_content. A sablonban a {{ a.card }} a megjelenített kártyát adja ki. Normál blokkokkal és komponensekkel egyaránt működik.

HTML címke

Minden témában vannak olyan blokkok, amelyek címsorszintjének a környezettől függően kell változnia. H1 a kezdőlapon, H2 a belső oldalakon. Ahelyett, hogy minden alkalommal rögzített beállításokkal rendelkező választómezőt készítene, mostantól külön html-tag mezőtípus áll rendelkezésre beépített előbeállításokkal.

JSON
{
  "id": "tag",
  "type": "html-tag",
  "default": "h2",
  "tags": "heading",
  "exclude": ["h5", "h6"]
}

Előbeállítások: heading (h1-h6), text (címsorok + p, span, div), structural (div, section, article, aside, main, header, footer, nav), all. Egyéni tömb is megadható. A exclude eltávolít bizonyos címkéket bármelyik előbeállításból.

Twig
<{{ a.tag }}>{{ a.title }}</{{ a.tag }}>

Adatbázis

Ez a kiadás központi újdonsága. Adjon hozzá egy db.php fájlt bármelyik blokkmappához, és a Blockstudio létrehozza az öt REST CRUD-végpontot, minden írási műveletet ellenőriz a séma alapján, automatikusan kezeli a tárolási hátteret, valamint egy JavaScript klienst (bs.db()) és egy PHP API megoldást (Db::get()) is biztosít. Nincs szükség migrációs fájlokra, vezérlőosztályokra vagy útvonal-regisztrációra.

PHP
return [
    'subscribers' => [
        'storage'    => 'table',
        'capability' => [
            'create' => true,
            'read'   => true,
            'update' => 'edit_posts',
            'delete' => 'manage_options',
        ],
        'fields' => [
            'email' => [
                'type'     => 'string',
                'format'   => 'email',
                'required' => true,
                'validate' => function ($value) {
                    if (str_ends_with($value, '@spam.com')) {
                        return 'This domain is blocked.';
                    }
                    return true;
                },
            ],
            'name' => ['type' => 'string', 'maxLength' => 100],
            'plan' => ['type' => 'string', 'enum' => ['free', 'pro']],
        ],
    ],
];

Már ez a séma is teljesen működő API-t hoz létre létrehozási, listázási, lekérési, frissítési és törlési végpontokkal, mindegyiknél bemenet-ellenőrzéssel.

Tárolás

Ötféle tárolási háttér, különböző felhasználási esetekhez:

  • table: Egyéni MySQL tábla, amelyet a dbDelta() kezel. Ha mezőket ad a sémához, a következő oldalbetöltéskor új oszlopok jönnek létre. Ez az éles környezetben használt alapértelmezett megoldás.
  • sqlite: Egyetlen SQLite fájl a blokk db/ mappájában. Valódi SQL lekérdezések, WAL-mód az egyidejű olvasáshoz, és teljes hordozhatóság. Másolja a mappát, másolja az adatbázist.
  • jsonc: Fájlonként soronként egy JSON objektum. Ember által olvasható, verziókezelhető, gitbarát.
  • meta: JSON tömb a WordPress bejegyzés metaadataiban, egy adott bejegyzéshez kötve.
  • post_type: Minden rekordból WordPress bejegyzés lesz egy egyéni bejegyzéstípusban. A mezők külön bejegyzés-metaadatként tárolódnak, és a WP_Query segítségével teljes körűen lekérdezhetők.

Kliensek

A JavaScript oldalon a bs.db() teljes CRUD-klienst biztosít:

JavaScript
const db = bs.db('my-theme/block', 'subscribers');
const record = await db.create({ email: 'a@b.com', plan: 'pro' });
const pros = await db.list({ plan: 'pro' });
await db.update(record.id, { plan: 'free' });
await db.delete(record.id);

Három kiegészítő segédprogram is tartozik hozzá:

  • bs.cache: Memóriabeli lekérdezési gyorsítótár get, set, invalidate és clear támogatással. Minden lekérdezés és módosítás között megosztott.
  • bs.query(key, fn, options): Bármely aszinkron függvényt gyorsítótárazással, kérések összevonásával és beállítható staleTime értékekkel egészít ki. Ha egy kérés folyamatban van, azonos kulccsal több hívás ugyanazt az ígéretet adja vissza.
  • bs.mutate(options): Optimista módosításokat kezel automatikus visszaállítással. Adjon meg egy reaktív állapotobjektumot, egy műveletet (create, update, delete) és optimista adatokat. A UI azonnal frissül. Ha a szerverkérés sikertelen, az állapot visszaáll a módosítás előtti pillanatképre.

Ezek együtt a teljes olvasási és írási ciklust lefedik: bs.query a gyorsítótárazott olvasásokhoz, bs.mutate az optimista írásokhoz, bs.cache a kézi vezérléshez.

A PHP oldalon a Db osztály ugyanezeket a műveleteket biztosítja:

PHP
use Blockstudio\Db;

$db = Db::get('my-theme/block', 'subscribers');
$db->create(['email' => 'a@b.com', 'plan' => 'pro']);
$db->list(['plan' => 'pro']);

Érvényesítés

Az érvényesítési hibák mezőnkénti hibatömbökként érkeznek vissza, a Zod fieldErrors formátuma alapján. Ugyanazon a mezőn több szabály is hibát jelezhet, a szerkezet pedig megkönnyíti a hibák hozzárendelését a kezelőfelületen lévő űrlapmezőkhöz:

JSON
{
  "data": {
    "status": 400,
    "errors": {
      "email": ["Must be a valid email address.", "This domain is blocked."],
      "plan": ["Must be one of: free, pro."]
    }
  }
}

Egyéni validate visszahívások futnak le a szerveren minden olyan ellenőrzéshez, amelyre a beépített szabályok nem terjednek ki: domainek blokkolása, mezők közötti ellenőrzés, külső lekérdezések.

Felhasználóhoz kötött adatok

Felhasználónkénti adatokhoz, például teendőkhöz, kedvencekhez vagy piszkozatokhoz állítsa a userScoped értékét erre: true, a többit pedig a Blockstudio intézi. Hozzáad egy user_id oszlopot, létrehozáskor automatikusan beállítja, és minden lekérdezést az aktuális felhasználóra szűkít. A frissítések és törlések ellenőrzik a tulajdonjogot. Nincs szükség kézi user_id mezőre, before_create hookra vagy a RPC szerinti szűrésre. Egy sor beállítás. post_type tárolás használatakor a userScoped külön oszlop helyett a post_author mezőre képeződik le.

PHP
return [
    'storage'    => 'sqlite',
    'userScoped' => true,
    'fields'     => [ /* ... */ ],
];

Valós idejű lekérdezés

Állítsa be a 'realtime' => true értéket a sémában, és az ügyfél automatikusan lekérdezi a változásokat. Ha valami megváltozik a szerveren, az Interactivity API tároló frissül, a UI pedig újrarenderelődik anélkül, hogy az Ön oldalán bármilyen JavaScript változtatásra lenne szükség. A 'realtime' => ['key' => 'todos', 'interval' => 5000] segítségével egyéni állapotkulcsok és időközök állíthatók be. A lekérdezések hash-összehasonlítást használnak a kérések kis méretűen tartásához, és szünetelnek, amikor a böngészőlap rejtett.

Biztonság, hookok és hordozhatóság

A nyilvános végpontokat automatikusan hozzáadott X-BS-Token CSRF-fejléc védi. Használja a 'open' beállítást, ha valóban hitelesítés nélküli hozzáférésre van szüksége, például bejövő webhookokhoz.

Az életciklus-hookok minden írási művelet előtt és után lefutnak. Definiálja őket közvetlenül a db.php fájlban vagy globálisan, a WordPress műveleteken keresztül.

A mezőknél megadható egy component kulcs a sémavezérelt űrlapmegjelenítéshez a bs_db_form() segítségével.

SQLite vagy JSONC tárolással az egész alkalmazás egyetlen mappában él: a kód, a logika, a hozzáférés-vezérlés és az adatok. A telepítéshez elég átmásolni.

RPC

Néha a CRUD nem elég. Egyéni szerveroldali logikára van szükség: például teendők állapotának váltására, értesítések küldésére vagy statisztikák összesítésére. Erre szolgál a rpc.php. Definiáljon egy PHP függvényt, hívja meg a kezelőfelületről a bs.fn() segítségével, a Blockstudio pedig kezeli a REST végpontot, a hitelesítést, a CSRF-védelmet és a JSON szerializálást. A megoldás a tRPC mintáját követi: az eljárásokat a szerveren definiálja, az ügyfél pedig név szerint hívja meg őket.

PHP
return [
    'subscribe' => function (array $params): array {
        $email = sanitize_email($params['email']);
        return ['success' => true];
    },
];
JavaScript
const result = await bs.fn('subscribe', { email: 'user@example.com' });

A beágyazott szkriptek (script-inline.js) automatikusan felismerik a blokk nevét a szkriptcímkéjük data-block attribútumából, így nem kell kézzel átadnia. A moduláris szkriptek harmadik argumentumként kapják meg.

A hozzáférés-vezérlési lehetőségek között szerepel a public (CSRF-védelemmel), a 'open' (védelem nélkül), a jogosultsági karakterláncok és a tömbök. Támogatott a függvényenkénti HTTP metódusvezérlés, az életciklus-hookok, valamint a blokkok közötti hívás a JS és a PHP felől egyaránt.

Cron

A háttérfeladatokat egy cron.php fájlban lehet definiálni. Adjon meg egy ütemezést és egy visszahívási függvényt, a Blockstudio pedig az indításkor regisztrálja őket a WordPress Cron rendszerben. A bővítmény kikapcsolásakor minden ütemezés szabályosan törlődik.

PHP
return [
    'cleanup' => [
        'schedule' => 'daily',
        'callback' => function () {
            $db = Db::get('my-theme/app', 'logs');
            // delete old entries
        },
    ],
    'sync' => [
        'schedule' => 'hourly',
        'callback' => function () {
            // pull from external API
        },
    ],
];

Minden beépített WordPress ütemezés támogatott, az egyéni időközök pedig a cron_schedules szűrővel állíthatók be.

CLI

Egy új wp bs parancs lefedi a teljes Blockstudio funkciókészletet: blokkok, adatbázis, RPC, cron, beállítások, Tailwind fordítás, SCSS fordítás, egyéni mezők és eszközfájlok kezelése.

Shell
wp bs blocks list --components
wp bs db schemas
wp bs db create my-theme/app subs --email=a@b.com
wp bs db list my-theme/app subs --plan=pro --format=json
wp bs rpc call my-theme/app subscribe --email=a@b.com
wp bs cron run my-theme/app cleanup
wp bs tailwind compile --file=template.html
wp bs scss compile --file=style.scss
wp bs fields list
wp bs assets list --type=global
wp bs settings get tailwind/enabled

Minden parancs támogatja a --format=json kapcsolót szkripteléshez.

Ismétlődő mezők fejlesztései

textMinimized objektummezőkhöz

Az összecsukott ismétlődő sorok most már megfelelően kezelik az objektummezők értékeit. Korábban a textMinimized linkmezőre állítva ezt mutatta: [object Object]. Most a Blockstudio automatikusan a mezőtípusnak megfelelő almezőt olvassa ki: title a linkeknél, value a színeknél és színátmeneteknél, icon az ikonoknál. Egyéni key tulajdonság is megadható bármelyik kívánt almező kiolvasásához.

JSON
{
  "type": "repeater",
  "textMinimized": { "id": "href", "fallback": "Add a link" },
  "attributes": [{ "id": "href", "type": "link" }]
}

RichText és MediaPlaceholder

Mindkét sablonkomponens használható ismétlődő mezőkben is; a zárójeles jelölés a megfelelő sort célozza meg. Minden ismétlődő sorban szerkeszthetők a címek és bekezdések, valamint használhatók médiafeltöltési területek.

Twig
{% for item in a.items %}
  <div class="card">
    <MediaPlaceholder attribute="items[{{ loop.index0 }}].image" />
    <RichText tag="h2" attribute="items[{{ loop.index0 }}].heading" />
    <RichText tag="p" attribute="items[{{ loop.index0 }}].content" />
  </div>
{% endfor %}

Egyéni mezők feltételei idStructure használatával

Ha egyéni mezőhöz idStructure van beállítva, a meződefinícióban szereplő feltételek az azonosítóikat automatikusan a kibontott nevekre módosítják. Ha a betűméret-mezőcsoport egyik feltétele a enable mezőre vonatkozik, és a csoportot a idStructure: "title_font_{id}" segítségével bővíti ki, a feltétel most már helyesen a title_font_enable mezőre hivatkozik az eredeti enable helyett.

A hivatkozási szintű feltételek is támogatottak. Adja meg a conditions értéket az egyéni mező hivatkozásánál, hogy egyszerre minden kibontott mezőre alkalmazza őket.

Dinamikus populate argumentumok

A populate argumentumok mostantól más blokkattribútumokra is hivatkozhatnak a {attributes.*} szintaxis használatával. Ha a hivatkozott attribútum megváltozik, a választómező automatikusan újra lekéri a lehetőségeit. Fűzze össze a választómezőket: az egyik kiválasztja a bejegyzéstípust, a másik betölti az adott típus bejegyzéseit.

JSON
{
  "id": "selected_post",
  "type": "select",
  "populate": {
    "type": "query",
    "query": "posts",
    "arguments": {
      "post_type": "{attributes.post_type}"
    }
  }
}

Módosítsa a post_type értékét „page”-re, és a második választó oldalakat tölt be. Állítsa „post”-ra, és bejegyzéseket tölt be. Bármilyen populate-típussal és attribútummal működik.

Composer

A Blockstudio mostantól bárhonnan betöltve működik a wp-content/ alól, nem csak a bővítmények mappájából. Az eszközfájlok URL-jei a BLOCKSTUDIO_URL konstanson keresztül oldódnak fel a plugins_url() helyett, így a témába csomagolt telepítések azonnal működnek:

PHP
require_once __DIR__ . '/vendor/autoload.php';
require_once __DIR__ . '/vendor/blockstudio/blockstudio/blockstudio.php';

A composer.json futásidejű függőségeit átrendeztük. A hatókörrel ellátott csomagok (TailwindPHP, ScssPhp, Minify), amelyek már szerepelnek a lib/ csomagban, többé nem futásidejű függőségek. Csak a php >= 8.2 és a plugin-update-checker marad.

Mindhárom telepítési mód (bővítmény-zip, bővítmény a Composer segítségével, témába csomagolva a Composer révén) ugyanazt eredményezi: a teljes WordPress aktiválást, a blokkok regisztrációját és a felhasználói felületen történő megjelenítést.

A beállítási útmutatóért tekintse meg a Composer dokumentációt.

Teljesítményprofilozó

Adja hozzá a ?blockstudio-perf értéket bármely oldal URL eleméhez, és alul megjelenik egy hibakereső panel blokkonkénti megjelenítési időkkel, fázisokra bontott adatokkal és gyorsítótár-találati arányokkal. Az időzítési adatok Server-Timing fejlécként is elküldésre kerülnek, és a böngésző Fejlesztői eszközeinek Hálózat lapján láthatók.

JSON
{ "dev": { "perf": true } }

A beállításokban véglegesen bekapcsolva minden oldalbetöltés profilozható. Csak a edit_posts jogosultsággal rendelkező, bejelentkezett felhasználók láthatják.

Az önzáró blokkcímkék is gyorsítótárazódnak a memóriában. Ha egy oldalon többször szerepel ugyanaz a blokk azonos attribútumokkal, a további megjelenítések kihagyják a teljes sablonfolyamatot.

Hibajavítások

  • PHP 8.4 elavulási figyelmeztetései: Javítottuk az strpos() és az str_replace() elavulási figyelmeztetéseit, amelyeket az null átadása okozott a add_submenu_page() számára.

Továbbiak

  • SCSS kódmezők: A kódmezők támogatják az language: "scss" használatát. Az értékek a ScssPhp segítségével fordítódnak le a szerkesztőben és a felhasználói felületen is.
  • Szabványos WordPress blokkok: Az Blockstudio könyvtárak tartalmazhatnak @wordpress/create-block kimenetet az Blockstudio blokkok mellett. Külön bővítménykód nélkül, automatikusan regisztrálódnak.

Ha működés közben is látni szeretné a teljes veremű mintát, a Full-Stack Blocks útmutató végigvezeti egy felhasználónkénti teendőalkalmazás és egy nyilvános hírlevél-feliratkozási űrlap nulláról történő elkészítésén.