Dennis · 2026 m. liepos 27 d.
Blockstudio 7.6
Blockstudio 7.6 versijoje projektą galima peržiūrėti ir atvaizduoti naudojant PHP, o numatytieji gamybinės aplinkos svetainės sąsajos nustatymai perkeliami į blockstudio.json: inventoriaus API, savarankiškas atvaizdavimas, medijos ir Tailwind šablonų pagalbinės funkcijos, našumo profiliai, vienas podėlio katalogas, statinis išankstinis atvaizdavimas ir ankstyvas pateikimas, griežtesni analizės išankstiniai nustatymai bei programavimo agentams skirti sugeneruoti projektų įrankiai.
Daugumą leidimo funkcijų apima du iškvietimai. Canvas::inventory() grąžina visus projekto registruotus puslapius, blokus, šablonų rinkinius, Svetainės redaktoriaus šablonus, šablonų dalis ir įtrauktus UI pavyzdžius. Render::document() grąžina bet kurio iš jų paruoštą HTML kartu su tiksliai tais ištekliais, kuriuos naudojo atvaizdavimas.
7.6.2 naujinys: failais pagrįsti puslapiai nebesinchronizuojami įprastų WordPress užklausų metu. Taikydami šaltinio pakeitimus paleiskite
wp bs pages syncarba iškvieskiteBlockstudio\Pages::reconcile(). Kolekcijų maršrutizavimas ir numatytiejitemplateFornustatymai naudoja išsaugotą vykdymo aplinkos konfigūraciją, o aiškiai paleidžiant sutikrinimą nebeatliekama ankstesnė didelė daugiakalbė OR-meta užklausa. Trumpalaikė parinktisthemeDefaults.syncPagesInDevelopmentpašalinta, nes puslapių sinchronizavimas nebevykdomas iš užklausų kablių.Pages::init()dabar naudojamas tik paleidimo metu; integracijos, kurios perduodavoforce, turi naudotiPages::reconcile()arba CLI. Atidarant Canvas vis dar atliekamas vienas autentifikuotas, aiškiai paleistas sutikrinimas, skirtas kūrimo inventoriui.
7.6.12 atnaujinimas: redaktoriaus stilių lentelės dabar nurodomos prefiksu vienu perrašymo veiksmu, o ne kiekvienam ištekliui atskirai kompiliuojant SASS, todėl šaltas redaktoriaus kūrimas svetainėje su daug blokų nebeišsekina nedidelio atminties limito. Jei iš talpyklos pašalinama talpykloje saugomo iš anksto atvaizduoto puslapio turinio maiša pagrįsta Tailwind stilių lentelė, puslapis atvaizduojamas iš naujo, užuot pateikus jį be stilių; tai taikoma ir PHP talpyklai, ir Early Serve papildiniui. Aukščiausio lygio blokų atributai nuskaitomi atvaizduojant, o ne atmetami, todėl schemos Blockstudio registracija
WP_Block_Typetinkamai veikia programinėmis priemonėmis rašantiems įrankiams.
7.6.11 atnaujinimas: diegiant grafo artefaktus, maršruto dokumentas dabar pakeičiamas atominiu būdu, jei saugyklos kopija tuo pačiu raktu pasikeitė; identiški dokumentai paliekami nepakeisti, o paaukštinti, pakeisti, praleisti ir išsaugoti maršrutai pateikiami per
Static_Prerender_Early_Serve::last_promotion().
7.6.10 atnaujinimas: vykdymo aplinkos talpyklos pataikymų metu dabar aptinkami pašalinti kompiliuoti ištekliai net ir stebėjimo atidėjimo laikotarpiu, o senesnės nei 7.6 plokščios vykdymo aplinkos talpyklos atominiu būdu izoliuojamos ir ištrinamos riboto dydžio cron paketais. Įtraukti UI globalūs objektai išvedami po kartą kiekviename puslapyje. Grafo režimo Early Serve gali pateikti tiesiogiai atvaizduotus maršrutus, kurių nėra įdiegtų maršrutų žemėlapyje, naudodama tapatybės talpyklą. Tailwind pasirinktinai gali išvesti turinio maiša pagrįstą talpyklos failą su
tailwind.output: "link"; pagal numatytuosius nustatymus išvestis lieka įterptinė.
Trumpai:
- Projekto inventorius:
Canvas::inventory()pateikia visus registruotus įrašus su jų šaltiniais ir stabiliu rodymo eiliškumu. - Tikslinė atranka: nurodžius blokus ir puslapius, jų paieška, sinchronizavimas, atvaizdavimas ir kompiliavimas apribojami šiais įrašais.
- Savarankiškas atvaizdavimas:
Blockstudio\Renderpateikia galutinį HTML blokui, kompozicijai arba visam dokumentui. - UI komponentų grupės:
Blockstudio\Uisuskirsto įtrauktą biblioteką į po vieną viešą grupę kiekvienam komponentui ir pateikia po pavyzdį. - Stabilūs vaizdų matmenys:
bs_media_image()atvaizduoja temos išteklius su tikrais matmenimis iš sugeneruotoassets/media.json. - Tailwind klasių pagalbinės funkcijos:
bs_tw_merge()irbs_tw_variants()sujungia klases PHP ir atsižvelgia į konfliktus. - Našumo profiliai:
performance.profilevienu kartu įjungia gamybinės aplinkos sąsajos numatytąsias nuostatas; antrinių elementų reikšmės jas pakeičia. - Tipizuota nuostatų prieiga:
Settings::get_bool()ir kitos panašios funkcijos nuskaitoblockstudio.jsonsu tikraisiais tipais ir pateikia analizės klaidas. - Vienas talpyklos katalogas: visi sugeneruoti failai saugomi
cache.pathkataloge ir susiejami su vykdymo aplinkos tapatybe. - Statinis išankstinis atvaizdavimas: anoniminių HTML turinį galima išsaugoti talpykloje, negaliojančiu pažymėti pagal priklausomybių grafą ir pateikti dar prieš paleidžiant WordPress.
- Analizės išankstinės nuostatos:
theme,extreme-themeirwordpress-renderišplečiablockstudio/phpstangalimybes už blokų šablonų ribų. - Valdomas pateikimo pakeitimų kabliukas:
blockstudio-githooks syncsukuria ir valdo išankstinio pateikimo kabliuką, kuris paleidžia sukonfigūruotą išankstinę nuostatą. - Projekto sutartis:
blockstudio-agentssukuriaAGENTS.md, kuriame aprašoma, ką projekto autoriai kuria, kokias funkcijas jis įjungia ir ką užtikrina jo išankstinė nuostata. - Dokumentacijos rodyklė: AI konteksto failas dabar yra visų dokumentų, jų paskirties ir jiems priklausančių identifikatorių rodyklė.
- Kanoninės blokų žymos: atskira komanda perrašo prefiksų ir alternatyvių pavadinimų trumpinius į
<bs:namespace-slug>; galima vykdyti bandomąjį paleidimą. - Suderinamumas pagal numatytuosius nustatymus: nė vienas iš šių pakeitimų nepaveikia svetainės, kol jis nenurodomas
blockstudio.json.
Projekto skaitymas ir atvaizdavimas
Projekto inventorius
Canvas::inventory() pateikia viską, ką projektas užregistruoja, viename paprastame masyve, nieko neatvaizduodama.
use Blockstudio\Canvas;
$result = Canvas::inventory();
foreach ($result['inventory']['blocks'] as $block) {
echo $block['name'] . "\n";
}
Įrašai grupuojami pagal tipą: pages, blocks, patterns, templates, parts ir ui. order nustato stabilų visų tipų rodymo eiliškumą, sources susieja kiekvieną įrašą su jo šaltinio keliais, o warnings ir errors renka problemas kaip struktūruotus įrašus.
Blokų įrašuose yra id, name, title, source, path, provenance ir paruoštas atvaizduoti declaration. Puslapių įrašuose source išlieka stabilus identifikatorius, o path – atvaizduojantis šablonas.
Tikslinė atranka
Nurodžius įrašus, darbo apimtis sumažinama, užuot viską iš pradžių aptikus ir tik tada atrinkus.
$changed = Canvas::inventory([
'blocks' => ['mytheme/hero'],
'pages' => ['about'],
]);
Taip gaunamas vienas blokas ir vienas puslapis. patterns, templates, parts ir ui grąžinami tušti, o jų šaltiniai neskaitomi, nesinchronizuojami, neatvaizduojami ir nekompiliuojami.
Taisyklės tikslios:
- Nenurodžius nė vieno tipo rakto, įkeliami visi tipai.
- Nurodžius
true,nullarba"*", įkeliami visi to tipo įrašai. - Eilutė arba sąrašas tiksliai atitinka ID, pavadinimą, trumpąjį pavadinimą, kelią arba šaltinio kelią.
- Tuščia eilutė, tuščias sąrašas arba
falseneįkelia nė vieno to tipo įrašo. - Nurodžius bent vieną tipo raktą, nenurodyti tipai lieka nepaliesti.
Nebegzistuojantys identifikatoriai pateikiami deleted, užuot sukėlus klaidą, o Canvas REST atnaujinimo galinis taškas tą pačią taisyklę taiko parametrams blocks ir pages.
Canvas::documents() naudoja tą pačią atranką ir prie kiekvieno įrašo prideda po atvaizduotą dokumentą. Atrinkti puslapiai atvaizduojami atkurtame sąsajos kontekste, todėl užklausų sąlygos, turinio klasės, trumpieji kodai, išdėstymai, peradresavimai ir išteklių įtraukimo atgaliniai iškvietimai gauna tą puslapį, o ne užklausą, kuri jo paprašė.
Savarankiškas atvaizdavimas
Blockstudio\Render grąžina atvaizduotą HTML kaip eilutę, naudodama tą patį konvejerį kaip sąsaja.
use Blockstudio\Render;
$html = Render::composition([
'root' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
'layers' => [
['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
],
]);
Visas pagrindas yra viena deklaracijos forma su keturiais raktais: name, attributes, content ir children. root, data, inner, innerBlocks, layers ir example yra patogesni įvesties variantai, kuriuos Render::normalize() sujungia į šią formą.
Vaikiniai elementai atvaizduojami rekursyviai, o netinkama įvestis sukelia išimtį, kurioje nurodomas problemą sukėlęs blokas.
Render::document() apgaubia išvestį visu savarankišku HTML dokumentu.
$document = Render::document('mytheme/hero', [
'title' => 'Hero preview',
]);
echo $document['html'];
body yra vien bloko išvestis, html – surinktas dokumentas, blocks – prisidėjusių blokų pavadinimai, o assets suskaido žymėjimą į head, footer, styles, scripts, modules, interactivity, ui ir tailwind.
Ištekliai apribojami atvaizduotu turiniu, todėl vien redaktoriui skirti ištekliai nepateikiami.
Render::document_from_html() apgaubia kitur atvaizduotą HTML, o Render::content() atvaizduoja serializuotą blokų turinį be dokumento. Viename PHP procese tarp dokumentų iškvieskite Blockstudio\Batch_Render::reset(); Canvas::documents() tai jau atlieka.
UI komponentų grupės
Blockstudio\Ui pateikia įtrauktą UI biblioteką po vieną įrašą kiekvienam viešam komponentui, o ne vidinių dalių sąrašą.
Ui::inventory() pateikia po vieną kiekvienos grupės įrašą su pagrindiniu bloku, pavadinimu ir reikalingais įgyvendinimo blokais. Ui::examples() kiekvienai grupei prideda deterministinę deklaraciją: išsaugomos numatytosios reikšmės, būtini vaikiniai sluoksniai įterpiami po savo tėviniais, o kai laukas būtų tuščias, įrašomas stabilus pavyzdinis tekstas. Ši deklaracija yra kanoninė, todėl ją galima tiesiogiai naudoti Render::document().
Canvas grupuoja taip pat. Įtrauktas UI rodomas po tipu ui kaip po vieną kiekvienos grupės pavyzdį, o įgyvendinimo registracijos nepatenka į blocks.
Grupės sukurtos taip, kad jas būtų galima jungti: pasirinkimo sąrašas atveriamas dialogo lange, kurio sąrašo perdanga yra virš paleidiklio; meniu ir kombinuotieji sąrašai prisitvirtina prie fiksuotų peržiūros srities koordinačių, kurios išlieka slenkant; modaliniai langai kaupiami sluoksniais ir uždaromi po vieną paspaudus Escape; kiekvienoje poraštėje tas pats uždarymo valdiklis derinamas su variantu. Kaip veikia šios sąsajos ir kokie nekintamieji užtikrina jų veikimą, aprašyta kompozicijų skyriuje; /ui/examples pateikiamos veikiančios kompozicijos.
Šablonų pagalbinės funkcijos
Stabilūs vaizdų matmenys
bs_media_image() atvaizduoja temos išteklius su tikru pločiu, aukščiu ir rezervuotu kraštinių santykiu, todėl vaizdai, nepatenkantys į medijos biblioteką, nebesukelia išdėstymo poslinkių.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
]);
Išvestis yra figure.blockstudio-media su įterptine aspect-ratio aplink img, turintį tikrus width, height, loading ir decoding. Matmenys gaunami iš sugeneruoto assets/media.json, kurį kūrimo etapu įrašo Blockstudio\Media_Metadata_Builder arba kuris sukuriamas rankiniu būdu.
src priima su tema susietą santykinį kelią, absoliutų kelią arba visą URL, o attachmentId skirtas medijos bibliotekos vaizdams. eager išjungia atidėtą įkėlimą virš matomos srities, o sources išveda <picture>.
Kai įjungta performance.media.lazy, tikrasis URL perkeliamas į data-src ir pakeičiamas tinkamo dydžio vietaženkliu.
Tailwind klasių pagalbinės funkcijos
bs_tw_merge() ir bs_tw_variants() sujungia Tailwind klases PHP šablonuose naudodamos variklį, kuris jau įtrauktas į Blockstudio.
bs_tw_merge('px-2 text-sm', 'px-4') grąžina text-sm px-4: pašalinamas konfliktuojantis px-2, o pirmenybė teikiama vėlesnei reikšmei. Priimami įdėtiniai klasės reikšmių masyvai.
bs_tw_variants() grąžina nedidelę iškviečiamą funkciją komponentų variantams:
$button = bs_tw_variants([
'base' => 'inline-flex items-center',
'variants' => [
'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
],
'defaultVariants' => ['size' => 'sm'],
]);
echo $button(['size' => 'lg', 'class' => 'rounded']);
Taip išvedama inline-flex items-center h-12 px-6 rounded. Palaikomos pagrindinės klasės, variantai, numatytieji variantai, sudėtiniai variantai ir kiekvieno iškvietimo class arba className.
Gamybinės aplinkos konfigūracija
Našumo profiliai
performance.profile vienoje vietoje įjungia numatytąsias gamybinės aplinkos sąsajos nuostatas.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}
compat yra numatytoji reikšmė ir nieko nekeičia. speed ir strict įjungia tą patį nuostatų rinkinį: iš antraštės pašalinama generatoriaus, jaustukų, sklaidos kanalų, aptikimo ir susijusių įrašų išvestis; atsisakoma oEmbed aptikimo ir pagrindinio kompiuterio scenarijų; išjungiami XML-RPC, pingbacks ir nuotolinio redaktoriaus aptikimas; pašalinami bendrieji pagrindinės sistemos sąsajos ištekliai; pritaikomos numatytosios vaizdų išvesties nuostatos; „Heartbeat“ ribojamas ne redaktoriaus aplinkose; tos pačios kilmės dokumentai iš anksto įkeliami užvedus žymeklį arba sufokusavus; naudojama Blockstudio vaizdų įkėlimo priemonė.
Kiekviena antrinio elemento reikšmė pakeičia profilio nuostatą, kaip parodyta aukščiau su preload.links. Pirmiausia reikėtų išbandyti pagrindinės sistemos sąsajos išteklių šalinimą, nes nuo jų priklausantis puslapis akivaizdžiai sutriks. Runtime_Settings::current() pateikia išspręstą profilį.
themeDefaults apima du dalykus, kuriuos temos kitu atveju turėtų įgyvendinti pačios: titleTag ir suppressDirectoryUpdates, kurie pašalina aktyvią antrinę ir pagrindinę temas iš naujinimų rezultatų.
Tipizuota nuostatų prieiga
Blockstudio\Settings nuskaito konfigūraciją su tikraisiais tipais, užuot grąžinusi bet ką, kas buvo saugoma JSON.
use Blockstudio\Settings;
$lazy = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);
$roles = Settings::get_array('users/roles');
foreach (Settings::errors() as $error) {
error_log($error);
}
Apie netaisyklingą JSON pranešama per Settings::errors(), užuot vietoj jo naudojus numatytąsias reikšmes. Settings::get_raw() pateikia tik tai, ką apibrėžė aktyvus šaltinis, todėl galima atskirti reikšmę, nustatytą į false, nuo niekada nenustatytos reikšmės.
Settings::fingerprint() pateikia stabilų veiksmingų nuostatų identifikatorių, o pasikeitus blockstudio.json prieiga iš naujo įkelia nuostatas.
Vienas talpyklos katalogas
Visi sugeneruoti failai dabar saugomi cache.path kataloge, kurio numatytoji vieta yra wp-content/blockstudio/cache.
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Kūrimo duomenys, blokų registracijos informacija, redaktoriaus ištekliai, sukompiliuoti Tailwind CSS, atvaizdavimo dokumentai, salų fragmentai, statiniai HTML, grafų indeksai, apšilimo eilės ir diagnostikos duomenys saugomi šiame pagrindiniame kataloge. Santykinis kelias skaičiuojamas nuo WP_CONTENT_DIR, o absoliutus kelias nurodo atskirą tomą.
Objektai saugomi pagal dabartinį tinklą ir svetainę, o tada pagal vykdymo aplinkos tapatybę: Blockstudio, WordPress ir PHP versijų kontrolinę santrauką, veiksmingas nuostatas, aktyvią temą ir papildinius, aptikimo šaltinius bei susijusius šaltinio failus. Pasikeitus įvesčiai, paveikti objektai sukuriami iš naujo, o senieji pašalinami.
Šalti kūrimo procesai vykdomi po vieną: viena užklausa sukuria ir atominiu būdu paskelbia rezultatą, o kitos laukia. Nepavykus atnaujinti, toliau pateikiamas paskutinis geras objektas, o apie klaidą ir toliau pranešama; Blockstudio\Runtime_Cache::purge('tailwind') išvalo vieną apimtį.
Statinis išankstinis atvaizdavimas
Statinis išankstinis atvaizdavimas talpykloje saugo visus anoniminius HTML dokumentus ir gali juos pateikti dar prieš paleidžiant WordPress. Pagal numatytuosius nustatymus ši funkcija išjungta.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}
Tinkamumo sąlygos
Tinka tik visi anoniminiai HTML dokumentai. Praleidžiamos ne GET užklausos, užklausos eilutės, administravimo skiltis, REST, Ajax, cron, sklaidos kanalai, paieška, peržiūros, užklausos su nonce, personalizuojantys slapukai ir visi keliai, prasidedantys dynamicPaths. Atsakymo galima visiškai atsisakyti naudojant <!-- blockstudio:no-cache --> žymeklį.
Keliai tikrinami atsižvelgiant į ribas, todėl /account apima /account/orders, bet ne /accounting.
Parašo ir grafo režimai
invalidate parenka įrašų galiojimo pabaigos tvarką. Numatytojo signature režimo atveju, gavus anoniminę užklausą, sukuriamas su tapatybe susietas atsakymas, o pasikeitus svetainės lygio nuostatoms jis pakeičiamas. Šis režimas tinka įprastai svetainei.
graph režimas skirtas specialiai kūrimo ir diegimo įrankiams. Jis įrašo kiekvieno puslapio šaltinio priklausomybes, todėl planas atkuria tik paveiktus URL adresus.
use Blockstudio\Static_Prerender_Runtime;
$plan = Static_Prerender_Runtime::build_plan($sourceUrls);
foreach ($plan['affectedUrls'] as $url) {
$result = render_with_dependencies($url);
Static_Prerender_Runtime::persist_built_response(
$url,
$result['html'],
$result['files'],
$result['virtualHashes']
);
}
Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));
Ankstyvas pateikimas
Įjungus earlyServe, Blockstudio valdo nedidelį kiekvienos svetainės maršrutų žemėlapį ir advanced-cache.php papildinį, kuris pateikia srautą, jei užklausa atitinka sąlygas, dar prieš paleidžiant WordPress, papildinius ar temą.
Ši funkcija niekada neperrašo kito savininko žemėlapio, papildinio ar WP_CACHE deklaracijos. Prieš pakeičiant žemėlapį, grafo artefaktas patikrina kiekvieną nurodytą HTML failą, todėl iš dalies atvaizduotas diegimas palieka aktyvų ankstesnį grafą. Daugelio svetainių įrašai atskiriami pagal pagrindinio kompiuterio vardą, pagrindinį kelią ir svetainės ID.
Apšilimas ir būsena
Kasdieniam naudojimui skirtos trys WP-CLI komandos:
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
status pateikia aktyvią tapatybę, failų ir baitų skaičių, grafo įrašus, eilės būseną bei kiekvienos apimties pataikymų, praleidimų, kūrimo procesų ir klaidų skaitiklius.
Analizės ir agentų įrankiai
Analizės išankstinės nuostatos
blockstudio/phpstan prie blokų analizės prideda tris sluoksnius ir vieną komandą, paleidžiančią projekto pasirinktą sluoksnį.
| Išankstinė nuostata | Ką prideda |
|---|---|
base |
Esamos schemos, šablonų, kabliukų, nuostatų ir API analizė. |
theme |
Temų šakniniai katalogai, stilių antraštės, ištekliai, selektorių aprėpties apribojimai, laukų numatytosios reikšmės, pasikartojančių laukų ribos. |
extreme-theme |
PHPStan max, nesaugūs PHP, escapinimas, Tailwind, JavaScript ir „Interactivity“ patikros. |
wordpress-render |
Skambintojo pateiktas aktyvaus atvaizdavimo patikrinimas, papildantis extreme-theme. |
Numatytosios reikšmės gaunamos iš blockstudio.json, todėl interaktyviuose paleidimuose, CI ir pateikimo pakeitimų kabliukuose naudojama ta pati konfigūracija:
{
"phpstan": {
"preset": "theme",
"roots": ["."],
"excludePaths": ["fixtures/**"],
"maxFiles": 10000
}
}
vendor/bin/blockstudio-phpstan --root . -- --no-progress
Sėkmingo vykdymo išėjimo kodas yra 0, diagnostikos atveju – 1, netinkamo naudojimo atveju – 2. Apvalkalas sujungia konfigūraciją sistemos laikinajame kataloge, todėl projekte neatsiranda sugeneruotos konfigūracijos, bazinės linijos ar talpyklos, taip pat padidina PHPStan atminties limitą iki 1G.
Taip pat įtrauktas BC Math teikėjas, todėl JavaScript patikroms nebereikia ext-bcmath.
Valdomas pateikimo pakeitimų kabliukas
Viena nuostata ir viena komanda paverčia sukonfigūruotą išankstinę nuostatą pateikimo pakeitimų patikra.
{
"githooks": {
"commit": true
}
}
vendor/bin/blockstudio-githooks sync
Sinchronizavimo komanda įrašo kabliuką ir nuosavybės įrašą Git bendrame kataloge, nustato, kad core.hooksPath rodytų į valdomą katalogą, ir iškviečia anksčiau sukonfigūruotą išankstinio pateikimo kabliuką. Kabliukas pateikimo metu nustato saugyklos ir projekto šakninį katalogą, todėl veikia susietos darbinės kopijos ir keliai su tarpais.
Kabliukas paleidžia tik vendor/bin/blockstudio-phpstan; jis niekada neformatuoja ir neperrašo failų. Nustačius commit į false ir vėl sinchronizavus arba paleidus blockstudio-githooks remove, atkuriamas įraše nurodytas kabliuko kelias, o ištrinami tik Blockstudio priklausantys failai.
Projekto sutartis
blockstudio-agents sukuria AGENTS.md, kuriame nurodoma, kur yra blokai, kas šiame projekte laikoma puslapiu, kokios funkcijos įjungtos ir ką analizatorius atmes.
vendor/bin/blockstudio-agents
Dokumentas generuojamas pagal aptiktus duomenis, o ne iš šablono. Temos su style.css antrašte, blokais ir failais pagrįstais puslapiais sutartis skiriasi nuo papildinio, registruojančio tik blokus; joje pateikiami skaitytuvo aptikti skaičiai, katalogai, vardų sritys ir šablonų kalbos. blockstudio.json lemia, kurios funkcijos įtraukiamos, todėl projekte be statinio išankstinio atvaizdavimo ši funkcija neminima.
Teisingumo skyrius skaitomas iš pasirinktos išankstinės nuostatos taisyklių failų sluoksnis po sluoksnio, todėl pridėjus taisyklę prie išankstinės nuostatos pasikeičia kiekviena pagal ją sugeneruota sutartis.
Nuosavybės valdymas veikia taip pat kaip pateikimo pakeitimų kabliukas. Jei faile nėra sugeneruoto žymeklio, jo pakeisti neleidžiama, nebent --force nurodo kitaip; pabaigoje esanti pastabų sritis išsaugoma generuojant iš naujo; kai sutartis pasenusi, --check baigiasi kodu 1; o --stdout pateikia sutartį neliesdamas failų sistemos.
Dokumentacijos rodyklė
blockstudio-llm.txt dabar yra rodyklė, o ne sujungtas tekstas. Kiekvienas paskelbtas dokumentas pateikiamas vieną kartą, nurodant jo skyrių ir poskyrį, maršrutą, šaltinio failą, vienos eilutės paskirties aprašą ir jam priklausančius identifikatorius: nuostatų kelius, kabliukų pavadinimus, PHP funkcijas bei klases ir komandas.
## Docs / Dev / Inspection Tools
### Canvas
route: /docs/dev/canvas
file: docs/docs/dev/canvas.md
purpose: A visual workspace and public inventory API for Blockstudio content.
settings: dev/canvas/enabled, ui
hooks: blockstudio/settings/dev/canvas/admin_bar, blockstudio/settings/dev/canvas/enabled
php: Blockstudio\Canvas, Canvas::documents(), Canvas::inventory()
Agentas perskaito rodyklę, randa vienintelį dokumentą, kuriame apibrėžtas jam reikalingas identifikatorius, ir atidaro tą dokumentą. Ankstesnis pusės megabaito sujungtas failas vis dar generuojamas ir skelbiamas adresu /blockstudio-llm-full.txt; jis nebėra pirmasis dalykas, kurį kam nors pateikiame.
Kanoninės blokų žymos
Atskira komanda perrašo prefiksų ir slapyvardžių trumpinius į kanoninę <bs:namespace-slug> rašybą, kurioje nurodomas tikrasis bloko pavadinimas ir kuri išsprendžiama neįkėlus projekto filtro.
Kai brand yra prefiksas, taikomas theme-components, o ui – prefiksas, taikomas bsui, šis trumpinys:
<brand-card>
<ui-input />
</brand-card>
reiškia tą patį kaip:
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Prefiksai ir tikslūs slapyvardžiai vis dar veikia ir nėra pasenę. Komanda neįkelia WordPress ir nieko neįrašo be --apply:
php vendor/blockstudio/blockstudio/bin/migrate-block-tags.php \
--root="$PWD" \
--prefix-map=/tmp/prefixes.json \
--known-blocks=/tmp/blocks.json \
--report=/tmp/tag-migration.json \
--dry-run
--prefix-map susieja kiekvieną prefiksą su jo vardų sritimis, o --known-blocks pateikia registruotų blokų pavadinimus. Ataskaitoje įrašomi senųjų žymų ir kanoninių atitikmenų susiejimai su pasikartojimų skaičiumi, kiekvieno failo maišos reikšmės ir atskiri nežinomų žymų, dviprasmiškų slapyvardžių bei dinaminių žymų sąrašai. --apply atsisako įrašyti pakeitimus, kol jų dar yra, nebent perduodamas --allow-unresolved.
Apdorojamas suporuotas, įdėtinis ir savaime užsidarantis žymėjimas, įskaitant pažodines žymas PHP eilutėse. Keičiami tik žymų pavadinimai, antras paleidimas pakeitimų neatlieka, o pavyzdžiai komentaruose, kodo blokuose, <pre> arba <code> pateikiami tik ataskaitoje.
Numatytoji elgsena
Įdiegus 7.6, niekas savaime nepasikeičia.
Pagal numatytuosius nustatymus našumo profilis yra compat. Antraštės išvestis, oEmbed, XML-RPC, Heartbeat, numatytieji vaizdų nustatymai, nuorodų išankstinis įkėlimas, tingusis įkėlimas ir priekinės dalies <title> lieka tokie, kokius nustatė WordPress ir tema.
Šios funkcijos lieka išjungtos, kol neįjungtos: visi performance.staticPrerender, performance.measurement, performance.media ir themeDefaults raktai, taip pat githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled ir blockTags.enabled. Kol statinis išankstinis generavimas išjungtas, jokie failai nerašomi ir joks papildomas įskiepis neįdiegiamas.
Canvas ir Render veikia pasyviai. Jie nuskaito esamus registrus ir atvaizduoja tik tai, ko paprašo iškvietėjas; nė vienas nesikiša į priekinės dalies išvestį ir neregistruoja maršrutų. Norint pasiekti Canvas administravimo ekraną, vis dar reikia dev.canvas.enabled ir edit_posts.
Griežtesnė analizė įjungiama ją nurodžius. Įdiegus blockstudio/phpstan įjungiamas tik pagrindinis plėtinys, o kanoninė komanda vykdo base, nebent projektas nurodo išankstinį nustatymą.
Generuojami failai sukuriami paleidus jų komandą. githooks.commit nieko nedaro, kol nepaleidžiamas blockstudio-githooks sync, o AGENTS.md – kol to nepadaro blockstudio-agents.
Naujovinimas iš 7.5
Reikalavimai nepasikeitė: PHP 8.2 arba naujesnė versija, WordPress 6.7 arba naujesnė versija.
composer require blockstudio/blockstudio
Talpyklos atkuriamos vieną kartą. Vykdymo aplinkos tapatybėje yra Blockstudio versija, todėl po naujovinimo pirmoji užklausa vykdoma be talpyklos, o seni objektai pašalinami. Senąją Tailwind talpyklą, esančią wp-content/uploads/blockstudio/tailwind/cache, galima ištrinti; fragmentas, kuris ieškojo failų pagal šį šabloną, turėtų vietoj to iškviesti Blockstudio\Runtime_Cache::purge('tailwind').
Plokščiasis wp-content/blockstudio/cache/runtime aplankas, naudotas iki 7.6 versijos, automatiškai pervadinamas, kad nebebūtų aktyviame kelyje, o pašalinamas ribotais WP-Cron etapais. Todėl diegimo užklausos metu nereikia ištrinti didelių senųjų užrakinimo failų medžių.
Generuojami failai turi savininkus. assets/media.json turi būti saugomas versijų valdymo sistemoje arba sukurtas atliekant komponavimo veiksmą. Maršrutų žemėlapis, papildomas advanced-cache.php failas ir WP_CACHE deklaracija egzistuoja tik tada, kai įjungtas earlyServe, o išankstinio patvirtinimo kablys – tik sinchronizavus. Visi kiti generuojami failai saugomi aplanke cache.path ir juos saugu ištrinti.
Nieko nepašalinta ir nepervadinta. bs_render_block(), bs_block(), Blockstudio\Pages ir Blockstudio\Patterns tebėra kanoniniai turinio šaltiniai, kurių turinys laikomas failuose.
Sugrąžinti galima atskiras funkcijas. Grąžinus performance.profile į compat, staticPrerender.enabled į false, githooks.commit į false ir pridėjus sync, taip pat cache.enabled į false, kiekvienu atveju atšaukiamas vienas sluoksnis.
Tinkama diegimo tvarka:
- Nustatykite
performance.profileįspeed, tada patikrinkite antraštės išvestį, sklaidos kanalus ir visus įskiepius, kuriems reikia oEmbed arba XML-RPC. - Sugeneruokite
assets/media.json, perkelkite šablonus įbs_media_image(), tada įjunkiteperformance.media.lazy. - Įjunkite
performance.staticPrerender, palikiteearlyServeišjungtą, patikrinkite užklausas naudodamiwp bs prerender status, tada įjunkiteearlyServe. - Vykdykite
blockstudio-phpstan --preset theme, kol neliks klaidų, ir tik tada susiekite išankstinį nustatymą sugithooks.commit.
Kur rasti išsamią informaciją
- Canvas ir jo inventorius bei dokumento API
- Atvaizdavimas, UI komponentai ir UI komponavimas
- Nustatymai ir našumas
- Našumas, Talpyklos naudojimas ir Statinis išankstinis generavimas
- Tailwind CSS
- PHPStan: išankstiniai nustatymai, kanoninė komanda, valdomas patvirtinimo kablys ir projekto sutartis
- DI integravimas: dokumentacijos rodyklė ir visas tekstas
- Perkėlimas ir PHP kabliai