Pereiti prie turinio

Dennis · 2026 m. kovo 14 d.

Blockstudio 7.1

Blockstudio 7.1 – pirmasis funkcijų leidimas po v7 perrašymo. v7 atkūrė pagrindą, o 7.1 prideda elementus, paverčiančius blokus kai kuo daugiau: duomenų bazės sluoksnį, serverio funkcijas, suplanuotas užduotis ir CLI. Dabar bloko aplankas gali būti visa programa.

Štai visos naujovės.

Komponentai

Visada buvo įtampa tarp blokų, kuriuos redaktoriai naudoja įterpimo priemonėje, ir blokų, kuriuos kūrėjai naudoja kaip pagrindą kitiems dalykams kurti. Kortelei, ženkleliui, statistikos valdikliui ar formos laukui reikia viso Blockstudio proceso (atributų, šablonų, išteklių, Tailwind), tačiau jiems nėra reikalo rodytis įterpimo priemonėje.

7.1 pristato komponentus, kurie išsprendžia šią problemą. Nustatykite "component": true savo block.json, ir blokas pereis visą kūrimo procesą, tačiau nebus užregistruotas WordPress blokų tipų registre. Jis nepasirodys įterpimo priemonėje ir nebus įtrauktas į redaktoriaus duomenis, siunčiamus į JavaScript, tačiau bus visiškai pasiekiamas programiniam atvaizdavimui.

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

Atvaizduokite juos iš PHP:

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

Arba naudokite naują HTML žymų sintaksę:

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

Blokų žymos

Dabar blokus galima įterpti kaip HTML žymas, naudojant vieną iš dviejų lygiaverčių sintaksių:

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

Abi sintaksės sukuria tą patį rezultatą. Abi veikia su Blockstudio blokais ir pagrindiniais WordPress blokais. Blokų šablonuose jos atvaizduojamos automatiškai, nieko papildomai neįjungus. Tai reiškia, kad visus maketus galite sudaryti tiesiai šablone iš kitų blokų:

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>

Abi sintaksės gali laisvai būti įdėtos viena į kitą. Blockstudio blokai atvaizduojami per visą procesą (šablonus, Tailwind, išteklius). Pagrindiniai blokai atvaizduojami per WordPress, naudojant tuos pačius atvaizduoklius kaip ir Puslapiuose ir šablonuose.

Norėdami įjungti puslapio lygmens atvaizdavimą (įrašo turiniui, valdiklių sritims), tai nustatykite faile blockstudio.json:

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

Leidžiamų ir draudžiamų elementų sąrašai pagal pakaitos simbolių šablonus nustato, kuriuos blokus galima atvaizduoti naudojant žymas. Atributai data-* ir html-* perduodami atvaizduojamo bloko šakniniam HTML elementui. Pasirinktinius atvaizduoklius galima užregistruoti naudojant filtrą blockstudio/block_tags/renderers.

Po gaubtu žymų analizatorius yra naujas lengvasis eilučių skaitytuvas, visiškai pakeičiantis DOMDocument. Jis apdoroja įdėtas žymas sekdamas jų gylį, rekursinius konteinerių blokus ir mišrią sintaksę vienu perėjimu. Atliekant našumo bandymus, jis išanalizuoja 1,000 plokščių žymų per 2.4ms ir 100 įdėjimo lygių per 3.7ms – nuosekliai greičiau nei DOMDocument ir WordPress WP_HTML_Tag_Processor. Tas pats analizatorius taip pat apdoroja neapdorotas HTML elementų žymas, skirtas Puslapiams ir šablonams, pakeisdamas DOMDocument pagrįstą analizatorių, kuris anksčiau apdorojo <p>, <div> ir kitus HTML elementus.

Nauji laukų tipai

Blokas

Naujas block lauko tipas, leidžiantis kaip atributą nurodyti kitą Blockstudio bloką. Nurodyto bloko laukai išskleidžiami tiesiogiai, naudojant idStructure ir overrides, kaip ir pasirinktinių laukų atveju. Skirtumas tas, kad šablone pasiekus reikšmę grąžinamas atvaizduotas bloko turinys.

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

Jei mytheme/card turi heading ir content laukus, pagrindinis blokas šoninėje juostoje gauna card_heading ir card_content. Šablone {{ a.card }} pateikia atvaizduotą kortelę. Veikia ir su įprastais blokais, ir su komponentais.

Žyma HTML

Kiekvienoje temoje yra blokų, kurių antraštės lygis turi keistis priklausomai nuo konteksto: H1 pagrindiniame puslapyje, H2 vidiniuose puslapiuose. Užuot kaskart kūrus pasirinkimo lauką su iš anksto nustatytomis parinktimis, dabar yra atskiras html-tag lauko tipas su integruotais rinkiniais.

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

Rinkiniai: heading (h1-h6), text (antraštės + p, span, div), structural (div, section, article, aside, main, header, footer, nav), all. Arba pateikite pasirinktinį masyvą. exclude pašalina konkrečias žymas iš bet kurio rinkinio.

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

Duomenų bazė

Tai pagrindinė šio leidimo naujovė. Įtraukite db.php failą į bet kurio bloko katalogą, ir Blockstudio sugeneruos penkis REST CRUD galinius taškus, patikrins kiekvieną įrašymo operaciją pagal schemą, automatiškai valdys saugyklos posistemę ir pateiks tiek JavaScript klientą (bs.db()), tiek PHP API (Db::get()). Nereikia migracijos failų, valdiklių klasių ar maršrutų registravimo.

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

Vien ši schema sukuria visiškai veikiantį API su kūrimo, sąrašo, gavimo, atnaujinimo ir ištrynimo galiniais taškais, kuriuose visi įvesties duomenys patikrinami.

Saugykla

Penkios saugyklos posistemės, pritaikytos skirtingiems naudojimo atvejams:

  • table: Tinkinta MySQL lentelė, valdoma per dbDelta(). Pridėjus laukų prie schemos, stulpeliai atsiranda įkėlus kitą puslapį. Numatytasis pasirinkimas gamybinėje aplinkoje.
  • sqlite: Vienas SQLite failas bloko db/ aplanke. Tikros SQL užklausos, WAL režimas lygiagrečiam skaitymui ir visiškas perkeliamumas. Nukopijuokite aplanką, nukopijuokite duomenų bazę.
  • jsonc: Po vieną JSON objektą kiekvienoje eilutėje paprastame faile. Žmogui suprantama, versijų valdymui tinkama, git pritaikyta.
  • meta: JSON masyvas WordPress įrašo metaduomenyse, susietas su konkrečiu įrašu.
  • post_type: Kiekvienas įrašas tampa WordPress įrašu tinkintame įrašų tipe. Laukai saugomi kaip atskiri įrašo metaduomenų įrašai, juos galima visapusiškai užklausti naudojant WP_Query.

Klientai

JavaScript pusėje bs.db() suteikia visavertį CRUD klientą:

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

Kartu pateikiamos trys pagalbinės priemonės:

  • bs.cache: atmintyje saugoma užklausų talpykla su get, set, invalidate ir clear. Bendrinama tarp visų užklausų ir keitimo operacijų.
  • bs.query(key, fn, options): bet kurią asinchroninę funkciją apgaubia talpykla, užklausų dublikatų šalinimu ir konfigūruojamu staleTime. Kelios užklausos su tuo pačiu raktu, kol pirmoji dar vykdoma, grąžina tą patį pažadą.
  • bs.mutate(options): tvarko optimistinius pakeitimus ir automatiškai juos atšaukia. Perduokite reaktyviosios būsenos objektą, veiksmą (create, update, delete) ir optimistinius duomenis. UI atnaujinamas iškart. Jei serverio iškvietimas nepavyksta, būsena grąžinama į pradinę, prieš pakeitimą užfiksuotą kopiją.

Kartu jos apima visą skaitymo ir rašymo ciklą: bs.query talpykloje saugomiems duomenims skaityti, bs.mutate optimistiniams duomenims įrašyti, bs.cache rankiniam valdymui.

PHP pusėje Db klasė suteikia tas pačias operacijas:

PHP
use Blockstudio\Db;

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

Tikrinimas

Tikrinimo klaidos pateikiamos kaip kiekvieno lauko klaidų masyvai, įkvėpti Zod fieldErrors formato. Tame pačiame lauke gali nepavykti kelios taisyklės, o struktūra leidžia lengvai susieti klaidas su formos laukais sąsajoje:

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

Pasirinktiniai validate atgaliniai iškvietimai vykdomi serveryje viskam, ko negali apimti integruotos taisyklės: domenų blokavimui, kelių laukų tikrinimui, išorinėms paieškoms.

Vartotojui priskirti duomenys

Jei duomenys priklauso atskiriems vartotojams, pavyzdžiui, darbų sąrašai, parankiniai ar juodraščiai, nustatykite userScoped į true, o Blockstudio pasirūpins likusiais dalykais. Jis prideda user_id stulpelį, automatiškai jį nustato kuriant įrašą ir filtruoja visas užklausas pagal dabartinį vartotoją. Atnaujinant ir trinant tikrinama nuosavybė. Nereikia rankinio lauko user_id, kablio before_create ar filtravimo RPC. Pakanka vienos konfigūracijos eilutės. Naudojant post_type saugyklą, userScoped susiejamas su post_author, o ne atskiru stulpeliu.

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

Apklausa realiuoju laiku

Nustatykite schemoje 'realtime' => true, ir klientas automatiškai tikrins, ar nėra pakeitimų. Kai serveryje kas nors pasikeičia, atnaujinama Interactivity API saugykla, o UI pateikiamas iš naujo be jokių JavaScript pakeitimų jūsų pusėje. Konfigūruokite naudodami 'realtime' => ['key' => 'todos', 'interval' => 5000], kad nustatytumėte pasirinktinius būsenos raktus ir intervalus. Apklausa naudoja maišos reikšmių palyginimą, kad užklausos būtų lengvos, ir pristabdoma, kai naršyklės kortelė paslėpta.

Saugumas, kabliai, perkeliamumas

Viešieji galiniai taškai apsaugomi automatiškai įterpiama X-BS-Token CSRF antrašte. Kai reikia tikrai neautentifikuotos prieigos, pavyzdžiui, gaunamoms tinklo kabliukų užklausoms, naudokite 'open'.

Gyvavimo ciklo kabliai suveikia prieš kiekvieną įrašymo operaciją ir po jos. Apibrėžkite juos tiesiogiai db.php arba visuotinai per WordPress veiksmus.

Laukai gali apibrėžti component raktą, kad formos būtų atvaizduojamos pagal schemą per bs_db_form().

Naudojant SQLite arba JSONC saugyklą, visa programa telpa viename aplanke: kodas, logika, prieigos valdymas ir duomenys. Norėdami ją įdiegti, nukopijuokite aplanką.

RPC

Kartais CRUD funkcijų nepakanka. Reikia pasirinktinės serverio logikos: pakeisti užduoties būseną, išsiųsti pranešimą, apibendrinti statistiką. Tam skirta rpc.php. Apibrėžkite PHP funkciją, iškvieskite ją iš priekinės sąsajos naudodami bs.fn(), o Blockstudio pasirūpins REST galiniu tašku, autentifikavimu, CSRF apsauga ir JSON serializavimu. Šis metodas įkvėptas tRPC: procedūros apibrėžiamos serveryje, o iš kliento iškviečiamos pagal pavadinimą.

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

Įterptieji scenarijai (script-inline.js) automatiškai aptinka bloko pavadinimą pagal scenarijaus žymos atributą data-block, todėl jo nereikia perduoti rankiniu būdu. Modulių scenarijai jį perduoda kaip trečią argumentą.

Prieigos valdymo parinktys apima public (su CSRF), 'open' (be apsaugos), galimybių eilutes arba masyvus. Taip pat palaikomas kiekvienos funkcijos HTTP metodo valdymas, gyvavimo ciklo kabliai ir skirtingų blokų funkcijų iškvietimas iš JS ir PHP.

Cron

Foninės užduotys apibrėžiamos cron.php faile. Nustatykite grafiką ir atgalinio iškvietimo funkciją, o Blockstudio inicijavimo metu užregistruos jas WordPress Cron. Išaktyvinus įskiepį, visos užduotys tvarkingai pašalinamos iš grafiko.

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

Palaikomi visi integruoti WordPress grafikai, taip pat pasirinktiniai intervalai per filtrą cron_schedules.

CLI

Nauja komanda wp bs apima visą Blockstudio funkcijų rinkinį: blokus, duomenų bazę, RPC, cron, nustatymus, Tailwind kompiliavimą, SCSS kompiliavimą, pasirinktinius laukus ir išteklių valdymą.

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

Visos komandos palaiko --format=json scenarijams.

Kartotuvų patobulinimai

textMinimized objektų laukams

Dabar sutrauktos kartotuvo eilutės tinkamai apdoroja objektų laukų reikšmes. Anksčiau, nurodžius nuorodos lauką textMinimized, buvo rodoma [object Object]. Dabar Blockstudio automatiškai nuskaito tinkamą laukelio savybę pagal lauko tipą: nuorodoms – title, spalvoms ir gradientams – value, piktogramoms – icon. Taip pat galite aiškiai nustatyti key savybę, kad būtų nuskaitoma bet kuri norima antrinė savybė.

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

RichText ir MediaPlaceholder

Dabar abu šablono komponentai veikia kartotuvo laukuose, naudojant laužtinių skliaustų žymėjimą, kad būtų nurodyta tinkama eilutė. Kiekvienoje kartotuvo eilutėje esančias antraštes, pastraipas ir medijos įkėlimo sritis galima redaguoti tiesiogiai.

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

Pasirinktinių laukų sąlygos naudojant idStructure

Naudojant pasirinktinį lauką su idStructure, lauko apraše esančių sąlygų ID dabar automatiškai perrašomi taip, kad atitiktų išplėstus pavadinimus. Jei šrifto dydžio laukų grupėje yra sąlyga su enable, o grupę išplečiate naudodami idStructure: "title_font_{id}", dabar sąlyga teisingai nurodo title_font_enable, o ne pradinį enable.

Taip pat palaikomos nuorodos lygmens sąlygos. Pridėkite conditions prie pasirinktinio lauko nuorodos, kad jos būtų taikomos iškart visiems išplėstiems laukams.

Dinaminiai užpildymo argumentai

Dabar užpildymo argumentai gali nurodyti kitus bloko atributus naudodami sintaksę {attributes.*}. Pasikeitus nurodytam atributui, pasirinkimo laukas automatiškai iš naujo gauna parinktis. Susiekite pasirinkimo laukus: vienu pasirinkite įrašo tipą, kitu įkelkite to tipo įrašus.

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

Pakeiskite post_type į „page“ ir antrajame pasirinkimo lauke bus įkeliami puslapiai. Pakeiskite į „post“ ir bus įkeliami įrašai. Veikia su bet kuriuo užpildymo tipu ir bet kuriuo atributu.

Composer

Blockstudio dabar veikia įkeltas iš bet kurios vietos po wp-content/, ne tik iš įskiepių katalogo. Išteklių URL nustatomi naudojant konstantą BLOCKSTUDIO_URL, o ne plugins_url(), todėl temoje įdiegtas variantas veikia iškart:

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

composer.json vykdymo aplinkos priklausomybės sutvarkytos. Aprėptį turintys paketai (TailwindPHP, ScssPhp, Minify), jau įtraukti į lib/, nebenurodomi kaip vykdymo aplinkos priklausomybės. Liko tik php >= 8.2 ir plugin-update-checker.

Visi trys diegimo būdai (įskiepio ZIP failas, įskiepis per Composer, temoje įdiegtas variantas per Composer) užsikrauna vienodai: visiškai suaktyvinamas WordPress, užregistruojami blokai ir atvaizduojama sąsaja.

Sąrankos instrukcijas rasite Composer dokumentacijoje.

Našumo profiliuoklis

Pridėkite ?blockstudio-perf prie bet kurio puslapio URL, ir apačioje atsiras derinimo skydelis, kuriame matysite kiekvieno bloko atvaizdavimo trukmę, etapų trukmių išskaidymą ir talpyklos pataikymų dažnį. Laiko duomenys taip pat siunčiami Server-Timing antraštėmis, kurias galima matyti naršyklės kūrėjų įrankių tinklo skirtuke.

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

Įjunkite tai nustatymuose visam laikui, kad būtų profiliuojamas kiekvienas puslapio įkėlimas. Matoma tik prisijungusiems vartotojams, turintiems galimybę edit_posts.

Dabar atmintyje taip pat talpykloje saugomos neuždaromosios blokų žymos. Jei tame pačiame puslapyje kelis kartus pasirodo tas pats blokas su identiškais atributais, vėliau jį atvaizduojant visas šablono procesas praleidžiamas.

Klaidų taisymai

  • PHP 8.4 pasenusių funkcijų įspėjimai: ištaisyti strpos() ir str_replace() pasenusių funkcijų įspėjimai, atsiradę perduodant null į add_submenu_page().

Daugiau

  • SCSS kodo laukai: kodo laukai palaiko language: "scss". Reikšmės kompiliuojamos per ScssPhp ir redaktoriuje, ir sąsajoje.
  • Standartiniai WordPress blokai: Blockstudio kataloguose gali būti @wordpress/create-block išvestis kartu su Blockstudio blokais. Jie automatiškai užregistruojami be jokio atskiro įskiepio kodo.

Jei norite pamatyti viso steko modelį praktiškai, vadove „Viso steko blokai“ žingsnis po žingsnio parodoma, kaip nuo nulio sukurti vartotojui skirtą darbų sąrašo programą ir viešą naujienlaiškio prenumeratos formą.