Preskoči na vsebino

Dennis · 14. marec 2026

Blockstudio 7.1

Blockstudio 7.1 je prva funkcijska izdaja po prepisu v7. Medtem ko je v7 na novo zgradil temelje, 7.1 dodaja gradnike, ki bloke spreminjajo v nekaj več: plast podatkovne zbirke, strežniške funkcije, načrtovana opravila in CLI. Mapa bloka je zdaj lahko popolna aplikacija.

Tukaj je vse, kar je novega.

Komponente

Vedno je obstajala napetost med bloki, ki jih uredniki uporabljajo v vstavljalniku, in bloki, ki jih razvijalci uporabljajo kot gradnike za druge stvari. Kartica, značka, statistični gradnik, vnosno polje obrazca. Potrebujejo celoten cevovod Blockstudio (atributi, predloge, sredstva, Tailwind), vendar nimajo kaj iskati v vstavljalniku.

Različica 7.1 uvaja komponente, ki to rešujejo. Nastavite "component": true v svojem block.json in blok bo šel skozi celoten graditveni cevovod, vendar ne bo registriran v registru vrst blokov WordPress. Ne prikaže se v vstavljalniku in ni v podatkih urejevalnika, poslanih v JavaScript, je pa v celoti na voljo za programsko upodabljanje.

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

Upodobite jih iz PHP:

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

Ali pa uporabite novo sintakso oznake HTML:

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

Oznake blokov

Bloke lahko zdaj vdelate kot oznake HTML z uporabo dveh zamenljivih sintaks:

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

Obe ustvarita enak rezultat. Obe delujeta z bloki Blockstudio in jedrnimi bloki WordPress. Znotraj predlog blokov se upodobita samodejno, brez dodatnega omogočanja. Tako lahko v predlogi sestavite celotne postavitve neposredno iz drugih blokov:

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>

Sintaksi se lahko poljubno gnezdita. Bloki Blockstudio se upodobijo skozi celoten cevovod (predloge, Tailwind, sredstva). Jedrni bloki se upodobijo prek WordPress z istimi upodabljalniki, ki poganjajo Pages and Patterns.

Za upodabljanje na ravni strani (vsebina objav, območja gradnikov) to omogočite v blockstudio.json:

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

Seznami dovoljenih in zavrnjenih blokov z vzorci z nadomestnimi znaki določajo, kateri bloki se lahko upodobijo z oznakami. Atributa data-* in html-* se preneseta v korenski element HTML upodobljenega bloka. Registrirate lahko lastne upodabljalnike prek filtra blockstudio/block_tags/renderers.

Razčlenjevalnik oznak v ozadju uporablja nov lahek pregledovalnik nizov, ki v celoti nadomešča DOMDocument. Obdeluje gnezdene oznake s sledenjem globini, rekurzivne vsebniške bloke in mešano sintakso v enem prehodu. Na primerjalnih testih razčleni 1,000 ravnih oznak v 2.4ms in 100 ravni gnezdenja v 3.7ms, pri čemer je dosledno hitrejši od DOMDocument in WordPress’s WP_HTML_Tag_Processor. Isti razčlenjevalnik obravnava tudi razčlenjevanje surovih elementov HTML za Pages and Patterns in nadomešča razčlenjevalnik na osnovi DOMDocument, ki je prej obravnaval elemente <p>, <div> in druge elemente HTML.

Nove vrste polj

Block

Nova vrsta polja block omogoča, da se v atributu sklicujete na drug blok Blockstudio. Polja sklicanega bloka se razširijo neposredno z uporabo idStructure in overrides, tako kot polja po meri. Razlika je v tem, da dostop do vrednosti v predlogi vrne izhod upodobljenega bloka.

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

Če ima mytheme/card polji heading in content, gostiteljski blok v stranski vrstici dobi card_heading in card_content. V predlogi {{ a.card }} izpiše upodobljeno kartico. Deluje z običajnimi bloki in komponentami.

Oznaka HTML

Vsaka tema ima bloke, pri katerih se mora raven naslova spreminjati glede na kontekst. H1 na domači strani, H2 na notranjih straneh. Namesto da bi vsakič ustvarili izbirno polje z vnaprej določenimi možnostmi, je zdaj na voljo namenska vrsta polja html-tag z vgrajenimi prednastavitvami.

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

Prednastavitve: heading (h1-h6), text (naslovi + p, span, div), structural (div, section, article, aside, main, header, footer, nav), all. Lahko podate tudi lastno polje. exclude odstrani določene oznake iz katere koli prednastavitve.

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

Zbirka podatkov

To je osrednji del izdaje. V poljuben imenik bloka dodajte datoteko db.php in Blockstudio ustvari pet končnih točk REST CRUD, vsako zapisovanje preveri glede na shemo, samodejno upravlja zaledje za shranjevanje ter zagotavlja odjemalca JavaScript (bs.db()) in PHP API (Db::get()). Brez datotek za migracije, razredov krmilnikov ali registracije poti.

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']],
        ],
    ],
];

Že sama ta shema ustvari v celoti delujoč API s končnimi točkami za ustvarjanje, seznam, pridobivanje, posodabljanje in brisanje, vse z validacijo vnosa.

Shranjevanje

Pet zaledij za shranjevanje, vsako primerno za različne primere uporabe:

  • table: Tabela po meri MySQL, ki jo upravlja dbDelta(). Dodajanje polj v shemo ob naslednjem nalaganju strani doda stolpce. Privzeta izbira za produkcijo.
  • sqlite: Ena datoteka SQLite v mapi bloka db/. Prave poizvedbe SQL, način WAL za sočasno branje in popolna prenosljivost. Kopirajte mapo in kopirali boste zbirko podatkov.
  • jsonc: En objekt JSON v vsaki vrstici navadne datoteke. Berljivo za ljudi, primerno za nadzor različic in git.
  • meta: Polje JSON, ki vsebuje polje WordPress v metapodatkih objave, povezano z določeno objavo.
  • post_type: Vsak zapis postane objava WordPress v vrsti objav po meri. Polja so shranjena kot posamezni vnosi v metapodatkih objave, po njih je mogoče poizvedovati z WP_Query.

Odjemalci

Na strani JavaScript vam bs.db() ponuja popolnega odjemalca CRUD:

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

Z njim so priloženi trije pomožni pripomočki:

  • bs.cache: Predpomnilnik poizvedb v pomnilniku z get, set, invalidate in clear. Skupen je vsem klicem poizvedb in sprememb.
  • bs.query(key, fn, options): Poljubno asinhrono funkcijo ovije s predpomnjenjem, združevanjem podvojenih zahtev in nastavljivim staleTime. Več klicev z istim ključem med izvajanjem zahteve vrne isto obljubo.
  • bs.mutate(options): Upravlja optimistične spremembe s samodejno povrnitvijo. Podajte odzivni objekt stanja, dejanje (create, update, delete) in optimistične podatke. UI se takoj posodobi. Če klic strežnika spodleti, se stanje povrne na posnetek pred spremembo.

Skupaj pokrivajo celoten cikel branja in zapisovanja: bs.query za branje iz predpomnilnika, bs.mutate za optimistično zapisovanje in bs.cache za ročno upravljanje.

Na strani PHP razred Db ponuja enake operacije:

PHP
use Blockstudio\Db;

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

Preverjanje veljavnosti

Napake pri preverjanju veljavnosti se vrnejo kot polja napak za posamezno polje, po vzoru oblike fieldErrors v Zod. Za isto polje lahko ne ustreza več pravilom, struktura pa omogoča preprosto povezavo napak s polji obrazca v ospredju:

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

Povratni klici po meri validate se izvajajo na strežniku za vse, česar vgrajena pravila ne pokrivajo: blokiranje domen, preverjanje veljavnosti med polji in zunanja iskanja.

Podatki za posameznega uporabnika

Za podatke posameznega uporabnika, kot so opravila, priljubljene vsebine ali osnutki, nastavite userScoped na true, za ostalo pa poskrbi Blockstudio. Doda stolpec user_id, ga samodejno nastavi ob ustvarjanju in vsako poizvedbo omeji na trenutnega uporabnika. Pri posodobitvah in brisanjih preveri lastništvo. Brez ročnega polja user_id, kavlja before_create ali filtriranja v RPC. Ena vrstica konfiguracije. Pri uporabi shrambe post_type se userScoped preslika v post_author namesto v ločen stolpec.

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

Redno preverjanje sprememb

V shemi nastavite 'realtime' => true in odjemalec bo samodejno preverjal spremembe. Ko se na strežniku kaj spremeni, se posodobi shramba Interactivity API, UI pa se znova upodobi, ne da bi morali na svoji strani spremeniti JavaScript. Nastavite 'realtime' => ['key' => 'todos', 'interval' => 5000] za ključe stanja po meri in intervale. Preverjanje uporablja primerjavo zgoščenih vrednosti, da so zahteve manjše, in se ustavi, ko je zavihek brskalnika skrit.

Varnost, kavlji, prenosljivost

Javne končne točke so zaščitene s samodejno dodano glavo CSRF X-BS-Token. Za dostop brez preverjanja pristnosti, na primer za dohodne spletne kavlje, uporabite 'open'.

Kavlji življenjskega cikla se sprožijo pred vsakim zapisovanjem in po njem. Določite jih neposredno v db.php ali globalno prek dejanj WordPress.

Polja lahko določijo ključ component za upodabljanje obrazcev na podlagi sheme prek bs_db_form().

Pri shrambi SQLite ali JSONC celotna aplikacija živi v eni mapi: koda, logika, nadzor dostopa in podatki. Za namestitev jo kopirajte.

RPC

Včasih CRUD ne zadostuje. Potrebujete logiko po meri na strežniku: preklop opravila, pošiljanje obvestila, zbiranje statistike. Temu služijo rpc.php. Določite funkcijo PHP, jo pokličite iz ospredja z bs.fn(), Blockstudio pa poskrbi za končno točko REST, preverjanje pristnosti, zaščito CSRF in serializacijo JSON. Vzorec se zgleduje po tRPC: postopki so določeni na strežniku, odjemalec pa jih kliče po imenu.

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

Vdelani skripti (script-inline.js) samodejno prepoznajo ime bloka iz atributa data-block v svoji oznaki script, zato vam ga ni treba podati ročno. Skripti modulov ga posredujejo kot tretji argument.

Možnosti nadzora dostopa vključujejo public (s CSRF), 'open' (brez zaščite), nize zmogljivosti ali polja. Podprti so tudi nadzor metode HTTP za posamezno funkcijo, kavlji življenjskega cikla in klicanje med bloki iz JS ter PHP.

Cron

Opravila v ozadju so določena v datoteki cron.php. Nastavite urnik in povratni klic, Blockstudio pa jih ob inicializaciji registrira v WordPress Cron. Ob deaktivaciji vtičnika so vsa opravila pravilno odstranjena iz urnika.

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

Podprti so vsi vgrajeni urniki WordPress, pa tudi intervali po meri prek filtra cron_schedules.

CLI

Nov ukaz wp bs pokriva celoten nabor funkcij Blockstudio: bloke, zbirko podatkov, RPC, cron, nastavitve, prevajanje Tailwind, prevajanje SCSS, polja po meri in upravljanje sredstev.

Lupina
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

Vsi ukazi podpirajo --format=json za skriptiranje.

Izboljšave ponavljalnika

textMinimized za polja objektov

Zložene vrstice ponavljalnika zdaj pravilno obravnavajo vrednosti polj objektov. Prej se je pri usmeritvi textMinimized na polje povezave prikazalo [object Object]. Zdaj Blockstudio samodejno prebere pravo podlastnost glede na vrsto polja: title za povezave, value za barve in prelive, icon za ikone. Nastavite lahko tudi izrecno lastnost key, da preberete katero koli želeno podlastnost.

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

RichText in MediaPlaceholder

Obe komponenti predloge zdaj delujeta znotraj polj ponavljalnika, kjer zapis v oglatih oklepajih določi pravo vrstico. Tako lahko v vsaki vrstici ponavljalnika sproti urejate naslove in odstavke ter območja za nalaganje predstavnostnih datotek.

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 %}

Pogoji polj po meri z idStructure

Pri uporabi polja po meri z idStructure se identifikatorji pogojev v definiciji polja zdaj samodejno prepišejo tako, da se ujemajo z razširjenimi imeni. Če ima skupina polj za velikost pisave pogoj za enable in jo razširite z idStructure: "title_font_{id}", se pogoj zdaj pravilno sklicuje na title_font_enable namesto na izvirni enable.

Podprti so tudi pogoji na ravni sklica. Na sklicu polja po meri dodajte conditions in pogoj bo hkrati veljal za vsako razširjeno polje.

Dinamični argumenti za izpolnjevanje

Argumenti za izpolnjevanje se lahko zdaj s sintakso {attributes.*} sklicujejo na druge atribute bloka. Ko se sklicevani atribut spremeni, izbirno polje samodejno znova pridobi svoje možnosti. Povežite izbirna polja: prvo izbere vrsto objave, drugo pa naloži objave te vrste.

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

Spremenite post_type v “page” in drugo izbirno polje naloži strani. Spremenite ga v “post” in naloži objave. Deluje s katero koli vrsto izpolnjevanja in katerim koli atributom.

Composer

Blockstudio zdaj deluje, ko je naložen s katere koli lokacije pod wp-content/, ne le iz imenika vtičnikov. URL-ji sredstev se razrešijo prek konstante BLOCKSTUDIO_URL namesto prek plugins_url(), zato namestitve, vključene v temo, delujejo takoj:

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

Odvisnosti izvajalnega okolja composer.json so bile urejene. Paketi z obsegom (TailwindPHP, ScssPhp, Minify), ki so že vključeni v lib/, niso več navedeni kot odvisnosti izvajalnega okolja. Ostajata samo php >= 8.2 in plugin-update-checker.

Vsi trije načini namestitve (datoteka zip vtičnika, vtičnik prek Composer, vključitev v temo prek Composer) se zaženejo enako: s polno aktivacijo WordPress, registracijo blokov in upodabljanjem v ospredju.

Za navodila za nastavitev si oglejte dokumentacijo Composer.

Profilnik zmogljivosti

Dodajte ?blockstudio-perf na katero koli stran URL in na dnu se prikaže razhroščevalna plošča s časi upodabljanja posameznih blokov, razčlenitvijo faz in stopnjami zadetkov v predpomnilniku. Časovni podatki so poslani tudi v glavah Server-Timing, ki so vidne v zavihku Network v orodjih DevTools brskalnika.

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

Trajno ga omogočite v nastavitvah, da profilirate vsako nalaganje strani. Viden je samo prijavljenim uporabnikom z zmožnostjo edit_posts.

Samozapiralne oznake blokov se zdaj prav tako shranijo v predpomnilnik v pomnilniku. Ko se isti blok z enakimi atributi na strani pojavi večkrat, nadaljnje upodobitve preskočijo celoten cevovod predlog.

Popravki napak

  • Opozorila o opustitvi v PHP 8.4: Odpravljeni sta bili opozorili o opustitvi strpos() in str_replace(), ki ju je povzročalo posredovanje null v add_submenu_page().

Več

  • Polja kode SCSS: Polja kode podpirajo language: "scss". Vrednosti se prevedejo prek ScssPhp tako v urejevalniku kot v ospredju.
  • Standardni bloki WordPress: Imeniki Blockstudio lahko vsebujejo izhod @wordpress/create-block poleg blokov Blockstudio. Registrirajo se samodejno, brez ločene kode vtičnika.

Če si želite ogledati vzorec aplikacije s celotnim skladom v praksi, vodnik Full-Stack Blocks guide prikazuje izdelavo aplikacije za opravila za posameznega uporabnika in javnega obrazca za prijavo na e-novice od začetka.