Dennis · 27. juuli 2026
Blockstudio 7.6
Blockstudio 7.6 võimaldab projekti lugeda ja renderdada PHP abil ning viib kasutajaliidese tootmiskeskkonna vaikeväärtused üle blockstudio.json-i: inventar API, eraldiseisev renderdamine, meedia ja Tailwind malliabid, jõudlusprofiilid, üks vahemälukaust, staatiline eeljrenderdus varajase teenindamisega, rangemad analüüsieelistused ja loodud projektitööriistad koodiagentidele.
Suurema osa väljalaskest kannavad kaks kutset. Canvas::inventory() tagastab kõik registreeritud lehed, plokid, mustrid, Site Editori mallid, malliosad ja komplekteeritud UI näited. Render::document() tagastab neist igaühe jaoks valmis HTML koos täpselt nende varadega, mida renderdus kasutas.
7.6.2 uuendus: failipõhiseid lehti ei kooskõlastata enam tavaliste WordPress päringute käigus. Allikamuudatuste rakendamiseks käivitage
wp bs pages syncvõi kutsugeBlockstudio\Pages::reconcile(). Kogumite marsruutimine jatemplateForvaikeväärtused kasutavad salvestatud käitusaja konfiguratsiooni ning selgesõnaline kooskõlastamine väldib varasemat suurt mitmekeelset OR-meta päringut. Lühiajaline suvandthemeDefaults.syncPagesInDevelopmenton eemaldatud, sest lehti ei sünkroonita enam päringukonksudest.Pages::init()toimib nüüd ainult alglaadimisel; integratsioonid, mis edastasid väärtuseforce, peavad kasutama väärtustPages::reconcile()või CLI. Canvase avamine käivitab endiselt autori inventari jaoks ühe autentitud ja selgesõnalise kooskõlastamise.
7.6.12 uuendus: Redaktori stiilitabelid lisatakse nüüd prefiksiga ühe ümberkirjutamise läbimisega, mitte iga vara eraldi SASS-i kompileerimisega, nii et paljude plokkidega saidi redaktori külmkäivitus ei ohusta enam mõõduka mälupiiri ületamist. Vahemällu salvestatud eeltöödeldud leht, mille sisu räsi sisaldava Tailwind stiilitabel on eemaldatud, renderdatakse uuesti, mitte ei väljastata stiilideta; see toimib nii PHP vahemälu kui ka Early Serve’i drop-in’i kaudu. Tipptasemele kirjutatud plokiatribuute loetakse renderdamisel, mitte ei jäeta kõrvale, seega skeemi Blockstudio registreeringut
WP_Block_Type-is arvestatakse programmipõhiste kirjutajate puhul.
7.6.11 uuendus: Graafi artefaktide paigaldamisel asendatakse marsruudi dokument aatomiliselt, kui poe koopia sama võtme all muutus; identsed dokumendid jäetakse puutumata ning edendatud, asendatud, vahele jäetud ja alles hoitud marsruutidest antakse teada
Static_Prerender_Early_Serve::last_promotion()kaudu.
7.6.10 uuendus: Käitusaja vahemälupäringud tuvastavad nüüd eemaldatud kompileeritud varad ka jälgimise viiteaja jooksul ning varasemad kui 7.6 lamedad käitusaja vahemälud paigutatakse aatomiliselt karantiini ja kustutatakse piiratud cron partiidena. Komplekteeritud UI globaalsed muutujad väljastatakse lehe kohta üks kord. Graafirežiimi Early Serve saab identiteedivahemälust edastada reaalajas renderdatud marsruute, mis pole juurutatud marsruudikaardil. Tailwind saab soovi korral väljastada sisuräsi sisaldava vahemälufaili koos
tailwind.output: "link"-ga; vaikimisi väljastatakse sisu reas.
Lühidalt:
- Projekti loend:
Canvas::inventory()tagastab kõik registreeritud kirjed koos nende allikate ja püsiva kuvamisjärjestusega. - Sihitud valik: plokkide ja lehtede nimetamine piirab avastamise, sünkroonimise, renderdamise ja kompileerimise nende kirjetega.
- Eraldiseisev renderdamine:
Blockstudio\Rendertagastab valmis HTML-e ploki, kompositsiooni või tervikliku dokumendi jaoks. - UI komponendipered:
Blockstudio\Uirühmitab komplekteeritud teegi üheks avalikuks pereks komponendi kohta ja lisab igaühe juurde näite. - Püsivad pildimõõtmed:
bs_media_image()renderdab teema varad tegelike mõõtmetega, mis pärinevad loodud failistassets/media.json. - Tailwind klassiabitööriistad:
bs_tw_merge()jabs_tw_variants()koostavad klassid keeles PHP, liites need konfliktiteadlikult. - Jõudlusprofiilid:
performance.profilelülitab tootmise kasutajaliidese vaikeväärtused korraga sisse; alamelemendi väärtused kirjutavad profiili omad üle. - Tüübistatud seadete juurdepääs:
Settings::get_bool()ja selle kaasfunktsioonid loevadblockstudio.jsontegelike tüüpidega ning toovad esile parsimisvead. - Üks vahemälukataloog: kõik loodud failid asuvad
cache.pathall ja on seotud käitusaja identiteediga. - Staatiline eeltöötlus: anonüümseid HTML saab vahemällu salvestada, sõltuvusgraafi kaudu kehtetuks muuta ning edastada enne WordPress käivitumist.
- Analüüsi eelseadistused:
theme,extreme-themejawordpress-renderlaiendavadblockstudio/phpstanvõimalusi plokimallidest kaugemale. - Hallatud sissekandekonks:
blockstudio-githooks syncloob sissekandmiseelse konksu ja haldab seda; konks käivitab seadistatud eelseadistuse. - Projekti leping:
blockstudio-agentsloob failiAGENTS.md, mis kirjeldab, mida projekti autorid loovad, millised funktsioonid on lubatud ja mida eelseadistus nõuab. - Dokumentatsiooni register: tehisintellekti kontekstifail sisaldab nüüd kõigi dokumentide registrit, nende eesmärke ja neile kuuluvaid tunnuseid.
- Kanoonilised plokisildid: eraldiseisev käsk asendab prefiksi- ja aliasekujud nimega
<bs:namespace-slug>; saadaval on ka kuivkäivitus. - Ühilduvus vaikimisi: ükski ülaltoodust ei muuda saiti enne, kui see on nimetatud failis
blockstudio.json.
Projekti lugemine ja renderdamine
Projekti loend
Canvas::inventory() tagastab lihtsa massiivina kõik, mida projekt registreerib, ilma midagi renderdamata.
use Blockstudio\Canvas;
$result = Canvas::inventory();
foreach ($result['inventory']['blocks'] as $block) {
echo $block['name'] . "\n";
}
Kirjed on rühmitatud tüübi järgi: pages, blocks, patterns, templates,
parts ja ui. order määrab kõigi tüüpide püsiva kuvamisjärjestuse,
sources seostab iga kirje lähtefailide radadega ning warnings ja errors
koondavad probleemid struktureeritud kirjeteks.
Plokikirjed sisaldavad id, name, title, source, path, provenance ja
valmis renderdamiseks mõeldud declaration-e. Lehekirjete püsivaks tunnuseks jääb
source ning renderdavaks malliks path.
Sihitud valik
Kirjete nimetamine piirab tööd, selle asemel et tulemusi hiljem filtreerida.
$changed = Canvas::inventory([
'blocks' => ['mytheme/hero'],
'pages' => ['about'],
]);
See tagastab ühe ploki ja ühe lehe. patterns, templates, parts ja ui
tagastatakse tühjana ning nende allikaid ei loeta, sünkroonita, renderdata ega
kompileerita.
Reeglid on täpsed:
- Kui ühtegi tüübi võtit pole, laaditakse kõik tüübid.
true,nullvõi"*"laadib kõik seda tüüpi kirjed.- String või loend leiab täpse vaste ID, nime, slugi, raja või lähteraja järgi.
- Tühi string, tühi loend või
falseei laadi seda tüüpi kirjeid. - Kui olemas on vähemalt üks tüübi võti, jäävad väljajäetud tüübid puutumata.
Tunnused, mida enam ei eksisteeri, tagastatakse vea asemel jaotises deleted,
ning Canvas REST värskendusotspunkt rakendab sama reeglit oma parameetritele blocks ja
pages.
Canvas::documents() kasutab sama valikut ja lisab iga kirje juurde ühe renderdatud dokumendi.
Valitud lehed renderdatakse taastatud kasutajaliidese kontekstis, nii et päringu
tingimused, body-klassid, lühikoodid, paigutused, ümbersuunamised ja laadimise
tagasikutsed käsitlevad seda lehte, mitte päringut, millega seda küsiti.
Eraldiseisev renderdamine
Blockstudio\Render tagastab renderdatud HTML-e stringina, kasutades sama
konveierit nagu kasutajaliides.
use Blockstudio\Render;
$html = Render::composition([
'root' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
'layers' => [
['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
],
]);
Aluseks on üks deklaratsiooni kuju nelja võtmega: name, attributes,
content ja children. root, data, inner, innerBlocks, layers ja
example on mugavad sisendkujud, mille Render::normalize() sellesse koondab.
Alamelemendid renderdatakse rekursiivselt ning vigase sisendi korral visatakse
viga, milles nimetatakse probleemset plokki.
Render::document() ümbritseb väljundi tervikliku eraldiseisva HTML dokumendiga.
$document = Render::document('mytheme/hero', [
'title' => 'Hero preview',
]);
echo $document['html'];
body on ainult ploki väljund, html koostatud dokument, blocks
sisendi andnud plokkide nimed ning assets jagab märgenduse osadeks: head,
footer, styles, scripts, modules, interactivity, ui ja tailwind.
Varad piirduvad renderdatud sisuga, nii et redaktori varasid ei lisata.
Render::document_from_html() ümbritseb mujal renderdatud HTML-e ja
Render::content() renderdab serialiseeritud plokisisu ilma dokumendita. Kutsu
Blockstudio\Batch_Render::reset() välja ühe PHP protsessi dokumentide vahel;
Canvas::documents() teeb seda juba.
UI komponendipered
Blockstudio\Ui esitab komplekteeritud teegi UI ühe kirjena avaliku
komponendi kohta, mitte sisemiste osade loendina.
Ui::inventory() tagastab iga pere kohta ühe kirje koos juurploki, pealkirja ja vajalike
teostusplokkidega. Ui::examples() lisab iga pere kohta deterministliku deklaratsiooni: vaikeväärtused säilivad, nõutavad alamkihid pesastatakse vanemelemendi alla ning tühjade väljade asemel kasutatakse püsivat näiteteksti. See deklaratsioon on kanooniline ja sobib otse Render::document()-i.
Canvas rühmitab samamoodi. Komplekti UI kuvatakse tüübi ui all ühe näitena pere kohta ning teostuse registreeringuid blocks-is ei kuvata.
Pered on loodud kokkupanekuks: valik avaneb dialoogis ja selle loendikast katab päästiku; menüüd ja liitkastid kinnituvad fikseeritud vaateava koordinaatidele, mis säilivad kerimisel; modaalaknad kuhjuvad ja sulguvad ükshaaval Escape-klahviga; iga jalus ühendab sama sulgemisnupu variandiga. Nende ühenduskohtade toimimist ja seda tagavaid muutumatuid tingimusi käsitleb kompositsiooni peatükk; /ui/examples näitab kompositsioone töötavana.
Malli abitööriistad
Püsivad pildimõõtmed
bs_media_image() renderdab teema varad tegeliku laiuse ja kõrgusega ning reserveeritud
kuvasuhtega, nii et väljaspool meediateeki olevad pildid ei nihuta enam paigutust.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
]);
Väljund on figure.blockstudio-media, mille ümber on reas aspect-ratio ning mille
img sisaldab tegelikke väärtusi width, height, loading ja decoding. Mõõtmed
pärinevad loodud failist assets/media.json, mille kirjutab ehitussammus Blockstudio\Media_Metadata_Builder või mis luuakse käsitsi.
src võtab teema suhtelise raja, absoluutse raja või täieliku URL-i; meediateegi pilte käsitleb attachmentId. eager lülitab laiska laadimise välja lehe ülaosas ning sources väljastab <picture>.
Kui performance.media.lazy on sisse lülitatud, liigub tegelik URL taustal asukohta data-src ning selle ees on õigete mõõtmetega kohatäide.
Tailwind klassiabitööriistad
bs_tw_merge() ja bs_tw_variants() koostavad klasse mallides Tailwind keeles PHP, kasutades mootorit, mille Blockstudio juba komplekti lisab.
bs_tw_merge('px-2 text-sm', 'px-4') tagastab text-sm px-4: konfliktne
px-2 jäetakse välja ja hilisem väärtus jääb kehtima. Toetatud on ka pesastatud klassiväärtuste massiivid.
bs_tw_variants() tagastab komponendivariantide jaoks väikese väljakutsutava funktsiooni:
$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']);
See väljastab inline-flex items-center h-12 px-6 rounded. Toetatud on baasklassid,
variandid, vaikevariandid, liitvariandid ning päringupõhine class või
className.
Tootmise konfiguratsioon
Jõudlusprofiilid
performance.profile lülitab tootmise kasutajaliidese vaikeväärtused ühest kohast sisse.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}
compat on vaikevalik ega muuda midagi. speed ja strict lubavad
sisse sama komplekti: generaator, emotikonid, voog, avastamine ja seotud postitused eemaldatakse päisest; oEmbedi avastamine ja hosti skriptid jäetakse välja; XML–RPC, pingbackid ja redaktori kaugavastamine lülitatakse välja; üldised tuuma kasutajaliidese varad eemaldatakse; rakendatakse pildi väljundi vaikeväärtusi; Heartbeat’i piiratakse väljaspool redaktoreid; sama päritoluga dokumendid eellaaditakse hõljutamisel või fookuse kavatsuse korral; ning kasutatakse Blockstudio pildilaadijat.
Iga alamväärtus kirjutab profiili üle, nagu ülal teeb preload.links. Tuuma kasutajaliidese varade eemaldamist tasub esimesena katsetada, sest neist sõltuv leht läheb nähtavalt katki. Runtime_Settings::current() näitab lahendatud profiili.
themeDefaults katab kaks ülesannet, mida teemad muidu käsitsi lahendavad: titleTag ning suppressDirectoryUpdates, et aktiivne alam- ja emateema värskendustulemustest peita.
Tüübistatud seadete juurdepääs
Blockstudio\Settings loeb konfiguratsiooni tegelike tüüpidega, selle asemel et tagastada
JSON-is leiduvat suvalist väärtust.
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);
}
Vigast JSON-i kohta antakse teada Settings::errors() kaudu, selle asemel et kasutada vaikeväärtusi. Settings::get_raw() tagastab ainult aktiivse allika deklareeritud väärtused,
mis võimaldab eristada väärtuseks määratud false-i väärtusest, mida pole kunagi määratud.
Settings::fingerprint() tagastab tõhusa seadistuse püsiva identiteedi,
ja juurdepääs laetakse uuesti, kui blockstudio.json muutub.
Üks vahemälukataloog
Kõik loodud failid asuvad nüüd cache.path all, mille vaikeväärtus on
wp-content/blockstudio/cache.
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Ehituse kasulikud andmed, plokkide registreerimisandmed, redaktori varad, kompileeritud Tailwind CSS,
renderdamisdokumendid, saarekesefragmendid, staatilised HTML-id, graafide indeksid, soojendamisjärjekorrad ja diagnostika asuvad kõik selle juure all. Suhteline rada lahendatakse alates asukohast WP_CONTENT_DIR; absoluutse rajaga saab määrata eraldi köite.
Objektid talletatakse praeguse võrgu ja saidi alla ning seejärel käitusaja identiteedi järgi: see on sõrmejälg versioonidest Blockstudio, WordPress ja PHP, tõhusatest seadetest, aktiivsest teemast ja pluginatest, avastusallikatest ning kaasatud lähtefailidest. Sisendi muutmisel luuakse mõjutatud objektidest uued versioonid ja vanad kärbitakse.
Külmkäivituse ehitused toimuvad ühe päringu kaupa: üks päring ehitab ja avaldab tulemuse aatomiliselt, teised ootavad. Ebaõnnestunud värskenduse korral edastatakse edasi viimane hea objekt, samal ajal kui tõrge jääb nähtavaks, ning
Blockstudio\Runtime_Cache::purge('tailwind') tühjendab ühe ulatuse.
Staatiline eeltöötlus
Staatiline eeltöötlus salvestab vahemällu terviklikud anonüümsed HTML dokumendid ja saab neid edastada enne WordPress käivitumist. Vaikimisi on see välja lülitatud.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}
Sobivus
Sobivad ainult terviklikud anonüümsed HTML dokumendid. Vahele jäetakse GET-ist erinevad päringud, päringustringid, halduslehed, REST, Ajax, cron, vood, otsing, eelvaated, nonce’i sisaldavad päringud, isikupärastatud küpsised ja kõik rajad dynamicPaths all.
Vastus saab sellest täielikult loobuda markeriga <!-- blockstudio:no-cache -->.
Rajavaste järgib piire, nii et /account hõlmab rada /account/orders, kuid
mitte rada /accounting.
Allkirja- ja graafirežiimid
invalidate määrab kirjete aegumise. Vaikimisi kasutatav režiim signature täidab anonüümse vahemälupäringu korral identiteedipõhise vastuse ning vahetab selle saidi tasemel muudatuste järel välja; see sobib tavalisele saidile.
Režiim graph on mõeldud selgesõnaliste ehitus- ja juurutustööriistade jaoks. See salvestab iga lehe enda lähtefailide sõltuvused, nii et plaan koostab uuesti ainult mõjutatud URL-id.
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']));
Varajane edastamine
Kui earlyServe on sisse lülitatud, haldab Blockstudio väikest saidipõhist marsruudikaarti ja advanced-cache.php drop-in’i, mis edastab sobiva vahemälutulemuse enne kui WordPress, pluginad või teema käivituvad.
See ei kirjuta kunagi üle võõrast kaarti, drop-in’i ega WP_CACHE deklaratsiooni. Graafi artefakt kontrollib kõiki viidatud HTML faile enne kaardi vahetamist, nii et pooleliolev juurutus jätab eelmise graafi aktiivseks. Mitme saidiga keskkonnas eraldatakse kirjed hosti, kodutee ja saidi ID järgi.
Soojendamine ja olek
Igapäevaseks kasutuseks on kolm WP-CLI käsku:
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
status esitab aktiivse identiteedi, failide ja baitide arvu, graafikirjed, järjekorra oleku ning iga ulatuse tabamuste, möödalaskmiste, ehituste ja tõrgete loendurid.
Analüüs ja agenditööriistad
Analüüsi eelseadistused
blockstudio/phpstan lisab plokianalüüsile kolm tasandit ning ühe käsu, mis käivitab projektis valitud tasandi.
| Eelseadistus | Lisatav |
|---|---|
base |
Olemasoleva skeemi, mallide, konksude, seadete ja API analüüs. |
theme |
Teema juurkataloogid, stiilipäised, varad, valijate ulatus, välja vaikeväärtused, kordaja piirid. |
extreme-theme |
PHPStan max, ohtlik PHP, paomärgid, Tailwind, JavaScript ja interaktiivsuse kontrollid. |
wordpress-render |
Kutsuja antud reaalajas renderdamise kontroll lisaks tasandile extreme-theme. |
Vaikeväärtused pärinevad asukohast blockstudio.json, nii et interaktiivsed käitused, CI ja sissekandekonksud kasutavad sama seadistust:
{
"phpstan": {
"preset": "theme",
"roots": ["."],
"excludePaths": ["fixtures/**"],
"maxFiles": 10000
}
}
vendor/bin/blockstudio-phpstan --root . -- --no-progress
Väljumiskoodid on 0 edukal läbimisel, 1 diagnostika korral ja 2 vigase kasutuse puhul. Ümbris koostab konfiguratsiooni süsteemi ajutises kataloogis, nii et projekti ei teki loodud konfiguratsiooni, lähtealust ega vahemälu, ning tõstab PHPStan mälupiiri väärtuseni 1G.
Komplektis on ka BC Mathi pakkuja, nii et JavaScript kontrollid ei vaja enam ext-bcmath-i.
Hallatud sissekandekonks
Üks seade ja üks käsk muudavad seadistatud eelseadistuse sissekande eeltingimuseks.
{
"githooks": {
"commit": true
}
}
vendor/bin/blockstudio-githooks sync
Sünkroonimine kirjutab konksu ja omandikirje asukohta Git-i ühiskasutatavasse kataloogi, suunab core.hooksPath hallatud kataloogi ning seob sellega varem seadistatud sissekandmiseelse konksu. Konks tuvastab sissekandmise ajal hoidla ja projekti juurkataloogi, nii et seotud väljavõtted ja tühikuid sisaldavad rajad toimivad.
Konks käivitab ainult vendor/bin/blockstudio-phpstan ega tee midagi muud; see ei vorminda ega kirjuta faile ümber. Kui määrate commit väärtuseks false ja sünkroonite uuesti või käivitate blockstudio-githooks remove, taastatakse salvestatud konksu rada ning kustutatakse ainult Blockstudio omandis olevad failid.
Projekti leping
blockstudio-agents loob faili AGENTS.md, mis kirjeldab, kus plokid asuvad, mida leht selles projektis tähendab, millised funktsioonid on lubatud ja mida analüsaator tagasi lükkab.
vendor/bin/blockstudio-agents
Dokument koostatakse projekti põhjal, seda ei täideta mallist. Päisega style.css teema, plokkide ja failipõhiste lehtede leping erineb ainult plokke registreeriva plugina omast ning sisaldab skanneri leitud arve, katalooge, nimeruume ja mallikeeli. blockstudio.json määrab, millised funktsioonid lepingusse lisatakse, nii et staatilise eeltöötluseta projektis ei mainita seda üldse.
Korrektsuse jaotis loetakse valitud eelseadistuse enda reeglifailidest tasandite kaupa, nii et uue reegli lisamine eelseadistusse muudab kõiki selle põhjal loodavaid lepinguid.
Omandihaldus toimib nagu sissekandekonks. Loodud markerita faili ei asendata, välja arvatud juhul, kui --force määrab teisiti; lõpus olev märkmete jaotis säilib regenereerimisel; --check väljub koodiga 1, kui leping on aegunud; ning --stdout kuvab selle failisüsteemi muutmata.
Dokumentatsiooni register
blockstudio-llm.txt on nüüd register, mitte dokumentide kokkuliitmine. Iga avaldatud dokument esineb oma jaotises ja alajaotises ühe korra ning sisaldab marsruuti, lähtefaili, üherealist eesmärki ja talle kuuluvaid tunnuseid: seadete radu, konksude nimesid, PHP funktsioone ja klasse ning käske.
## 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()
Agent loeb indeksit, leiab dokumendi, millele kuulub teda huvitav tunnus, ja avab selle dokumendi. Varasemat poole megabaidi suurust ühendatud faili luuakse ja avaldatakse endiselt aadressil /blockstudio-llm-full.txt; see ei ole enam esimene asi, mida kellelegi kätte antakse.
Kanoonilised plokisildid
Eraldiseisev käsk asendab eesliite- ja aliase-lühivormid kanoonilise <bs:namespace-slug> kirjapildiga, mis salvestab tegeliku ploki nime ja lahendatakse ka ilma projekti filtrit laadimata.
Kui eesliide brand käib üle theme-components ja eesliide ui üle bsui, tähendab see lühivorm järgmist:
<brand-card>
<ui-input />
</brand-card>
tähendab sama mis:
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Eesliited ja täpsed aliased töötavad endiselt ning neid ei ole aegunud kasutusest eemaldatud. Käsk ei laadi WordPress ega kirjuta midagi ilma valikuta --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 seostab iga eesliite selle nimeruumidega ja --known-blocks loetleb registreeritud plokinimed. Aruanne sisaldab vastendusi pärandkujult kanoonilisele kujule koos esinemiskordade arvu ja failipõhiste räsidega ning eraldi loendeid tundmatute siltide, mitmetähenduslike aliaste ja dünaamiliste siltide kohta. --apply keeldub kirjutamast, kui mõni neist alles on, välja arvatud juhul, kui antakse --allow-unresolved.
Töödeldakse paaris-, pesastatud ja isesulguvat märgendust, sealhulgas sõnasõnalisi silte stringides PHP. Muutuvad ainult siltide nimed, teine käivituskord ei tee muudatusi ning kommentaarides, koodiplokkides, <pre> või <code> sisalduvaid näiteid kajastatakse ainult aruandes.
Vaikekäitumine
Versiooni 7.6 paigaldamine ei muuda iseenesest midagi.
Jõudlusprofiili vaikeväärtus on compat. Päise väljund, oEmbed, XML-RPC, Heartbeat, piltide vaikeväärtused, linkide eellaadimine, laisk laadimine ja esiosa <title> jäävad selliseks, nagu WordPress ja teema need jätsid.
Need on välja lülitatud, kuni need lubatakse: iga performance.staticPrerender, performance.measurement, performance.media ja themeDefaults võti ning githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled ja blockTags.enabled. Kui staatiline eelpärendus on välja lülitatud, ei kirjuta see faile ega paigalda lisamoodulit.
Canvas ja Render töötavad passiivselt. Need loevad olemasolevaid registreid ja renderdavad ainult seda, mida helistaja küsib; kumbki ei haaku esiosa väljundiga ega registreeri marsruute. Canvas-e halduskuva nõuab endiselt dev.canvas.enabled ja edit_posts.
Rangema analüüsi jaoks tuleb see nimetada. blockstudio/phpstan paigaldamine lubab ainult põhilaienduse ning kanooniline käsk käivitab base, kui projekt pole eelseadistust nimetanud.
Genereeritud failid nõuavad käsu käivitamist. githooks.commit ei tee midagi enne, kui käivitatakse blockstudio-githooks sync, ja AGENTS.md enne, kui seda teeb blockstudio-agents.
Uuendamine versioonilt 7.5
Nõuded ei ole muutunud: PHP 8.2 või uuem, WordPress 6.7 või uuem.
composer require blockstudio/blockstudio
Vahemälud luuakse üks kord uuesti. Käitusaja identiteet sisaldab Blockstudio versiooni, seega on esimene päring pärast uuendamist külm ja vanad objektid eemaldatakse. Vana Tailwind vahemälu asukohas wp-content/uploads/blockstudio/tailwind/cache võib kustutada; koodijupp, mis kasutas selle leidmiseks glob-mustrit, peaks selle asemel kutsuma Blockstudio\Runtime_Cache::purge('tailwind').
Versioonile 7.6 eelnenud lame wp-content/blockstudio/cache/runtime kataloog nimetatakse automaatselt aktiivsest teest välja ning eemaldatakse piiratud WP-Cron läbimistega. Seega ei pea juurutuspäringu ajal suuri pärandlukufailide puid kustutama.
Genereeritud failidel on omanikud. assets/media.json kuulub versioonihaldusse või ehitusetappi. Marsruudikaart, advanced-cache.php lisamoodul ja WP_CACHE deklaratsioon eksisteerivad ainult siis, kui earlyServe on lubatud; sissekande-eelne konks ainult sünkroonimise ajal. Kõik muu genereeritud sisu asub kataloogis cache.path ja selle võib turvaliselt kustutada.
Midagi ei eemaldatud ega nimetatud ümber. bs_render_block(), bs_block(), Blockstudio\Pages ja Blockstudio\Patterns jäävad kanoonilisteks failipõhisteks sisupindadeks.
Tagasipööramine käib funktsioonide kaupa. performance.profile väärtuseks compat, staticPrerender.enabled väärtuseks false, githooks.commit väärtuseks false koos sync-ga ning cache.enabled väärtuseks false pööravad igaüks ühe kihi tagasi.
Mõistlik kasutuselevõtu järjekord:
- Määra
performance.profileväärtuseksspeed, seejärel kontrolli päise väljundit, vooge ja kõiki pluginaid, mis sõltuvad oEmbedist või XML-RPC-st. - Loo
assets/media.json, vii mallid asukohtabs_media_image()ja lülita seejärel sisseperformance.media.lazy. - Luba
performance.staticPrerendernii, etearlyServeon välja lülitatud, kontrolli päringuid tööriistagawp bs prerender statusja lülita seejärel sisseearlyServe. - Käivita
blockstudio-phpstan --preset theme, kuni tulemus on puhas, enne kui asetad mõne eelseadistuse valikugithooks.committaha.
Kust üksikasju leida
- Canvas ja selle inventar ning dokumendi API
- Renderdamine, UI komponendid ja UI kompositsioon
- Seaded ja jõudlus
- Jõudlus, vahemällu salvestamine ja staatiline eelpärendus
- Tailwind CSS
- PHPStan: eelseadistused, kanooniline käsk, hallatav sissekande-eelne konks ja projekti leping
- Tehisintellekti integratsioon: dokumentatsiooniindeks ja täistekst
- Migreerimine ja PHP konksud