Preskoči na vsebino

Dennis · 27. julij 2026

Blockstudio 7.6

Blockstudio 7.6 omogoča pregledovanje projekta in izrisovanje iz PHP ter prenaša privzete nastavitve produkcijskega sprednjega dela v blockstudio.json: inventar API, samostojno izrisovanje, pomočnike predlog za medije in Tailwind, profile zmogljivosti, en imenik predpomnilnika, statično predizrisovanje z zgodnjim streženjem, strožje prednastavitve analize ter ustvarjena projektna orodja za kodirne agente.

Večino izdaje omogočata dva klica. Canvas::inventory() vrne vse strani, bloke, vzorce, predloge urejevalnika spletnega mesta, dele predlog in primere pakiranega UI, ki jih registrira projekt. Render::document() za katerikoli od njih vrne končni HTML in natančno tista sredstva, ki so bila uporabljena pri izrisovanju.

Posodobitev 7.6.2: strani iz datotek se med običajnimi zahtevami WordPress ne usklajujejo več. Pri uveljavljanju sprememb virov zaženite wp bs pages sync ali pokličite Blockstudio\Pages::reconcile(). Usmerjanje zbirk in privzete nastavitve templateFor uporabljajo shranjeno konfiguracijo izvajalnega okolja, izrecno usklajevanje pa se izogne prejšnji obsežni večjezični poizvedbi OR-meta. Kratkotrajna možnost themeDefaults.syncPagesInDevelopment je odstranjena, ker se sinhronizacija strani ne izvaja več iz kavljev zahtev. Pages::init() je zdaj namenjen samo inicializaciji; integracije, ki so posredovale force, morajo uporabiti Pages::reconcile() ali CLI. Ob odprtju Canvas se še vedno izvede eno overjeno, izrecno usklajevanje inventarja za avtorje.

7.6.12 posodobitev: Slogovne datoteke urejevalnika se zdaj opremijo s predponami v enem samem prehodu prepisovanja namesto s prevajanjem SASS za vsako sredstvo posebej, zato pri hladni gradnji urejevalnika na spletnem mestu z veliko bloki ni več nevarnosti, da bi zmanjkalo skromnega pomnilniškega limita. Predpomnjena vnaprej izrisana stran, katere vsebinsko zgoščena slogovna datoteka Tailwind je bila odstranjena iz predpomnilnika, se znova izriše namesto, da bi bila prikazana brez slogov, tako prek predpomnilnika PHP kot prek dodatka Early Serve. Atributi blokov, zapisani na najvišji ravni, se pri izrisu preberejo namesto zavržejo, zato je shema Blockstudio, registrirana v WP_Block_Type, upoštevana tudi pri programskih zapisovalnikih.

7.6.11 posodobitev: Namestitev artefaktov grafa zdaj atomsko zamenja dokument poti, če se je kopija v shrambi spremenila pod istim ključem, nespremenjene dokumente pa pusti pri miru; promovirane, zamenjane, preskočene in ohranjene poti poroča prek Static_Prerender_Early_Serve::last_promotion().

7.6.10 posodobitev: Zadetki v izvajalnem predpomnilniku zdaj zaznajo odstranjena prevedena sredstva tudi med zakasnitvijo opazovanja sprememb, ploščati izvajalni predpomnilniki pred različico 7.6 pa so atomsko premaknjeni v karanteno in izbrisani v omejenih paketih cron. Vdelane globalne spremenljivke UI se izpišejo enkrat na stran. Early Serve v načinu grafa lahko iz predpomnilnika identitet streže poti, izrisane v živo, ki niso v zemljevidu uvedenih poti. Tailwind lahko po želji izpiše datoteko predpomnilnika z zgoščeno vsebino pod tailwind.output: "link"; privzeto se izpisuje neposredno.

Na kratko:

  • Pregled projekta: Canvas::inventory() vrne vse registrirane zapise z njihovimi viri in stabilnim vrstnim redom prikaza.
  • Ciljni izbor: z navedbo blokov in strani se odkrivanje, sinhronizacija, izris in prevajanje omejijo na te zapise.
  • Samostojni izris: Blockstudio\Render vrne dokončan HTML za blok, kompozicijo ali celoten dokument.
  • Družine komponent UI: Blockstudio\Ui združi priloženo knjižnico v eno javno družino na komponento, za vsako s primerom.
  • Nespremenljive dimenzije slik: bs_media_image() izriše sredstva teme z dejanskimi dimenzijami iz ustvarjenega assets/media.json.
  • Pomožne funkcije za razrede Tailwind: bs_tw_merge() in bs_tw_variants() sestavljata razrede v PHP ter združujeta ob upoštevanju sporov.
  • Profili zmogljivosti: performance.profile naenkrat vklopi privzete nastavitve produkcijskega sprednjega dela; podrejene vrednosti jih preglasijo.
  • Dostop do tipiziranih nastavitev: Settings::get_bool() in sorodne funkcije berejo blockstudio.json z dejanskimi tipi ter prikažejo napake pri razčlenjevanju.
  • En imenik predpomnilnika: vsaka ustvarjena datoteka je pod cache.path in je določena z identiteto izvajalnega okolja.
  • Statični vnaprejšnji izris: anonimne dokumente HTML je mogoče predpomniti, razveljaviti prek grafa odvisnosti in streči, še preden se zažene WordPress.
  • Prednastavitve analize: theme, extreme-theme in wordpress-render razširijo blockstudio/phpstan onkraj predlog blokov.
  • Upravljan potrditveni kavelj: blockstudio-githooks sync zapiše in upravlja kavelj pred potrditvijo, ki zažene nastavljeno prednastavitev.
  • Pogodba projekta: blockstudio-agents zapiše AGENTS.md z opisom, kaj ustvarjalci projekta pripravljajo, katere funkcije omogočajo in kaj prednastavitev uveljavlja.
  • Kazalo dokumentacije: datoteka konteksta za UI je zdaj kazalo vseh dokumentov, njihovega namena in identifikatorjev, ki jih upravljajo.
  • Kanonične oznake blokov: samostojni ukaz prepiše okrajšave predpon in vzdevkov v <bs:namespace-slug>; na voljo je tudi suhi zagon.
  • Privzeto združljivo: nič od naštetega ne spremeni spletnega mesta, dokler ni navedeno v blockstudio.json.

Branje in izris projekta

Pregled projekta

Canvas::inventory() vrne vse, kar projekt registrira, kot eno navadno polje, ne da bi karkoli izrisal.

PHP
use Blockstudio\Canvas;

$result = Canvas::inventory();

foreach ($result['inventory']['blocks'] as $block) {
    echo $block['name'] . "\n";
}

Zapisi so združeni po tipu: pages, blocks, patterns, templates, parts in ui. order določa stabilni vrstni red prikaza za vse tipe, sources vsak zapis poveže z njegovimi izvornimi potmi, warnings in errors pa zbirata težave kot strukturirane vnose.

Zapisi blokov vsebujejo id, name, title, source, path, provenance in declaration, pripravljen za izris. Zapisi strani ohranijo source kot stabilno identiteto in path kot predlogo za izris.

Ciljni izbor

Z navedbo zapisov se delo omeji že vnaprej, namesto da bi ga filtrirali naknadno.

PHP
$changed = Canvas::inventory([
    'blocks' => ['mytheme/hero'],
    'pages' => ['about'],
]);

To vrne en blok in eno stran. patterns, templates, parts in ui so prazni, njihovi viri pa se nikoli ne preberejo, sinhronizirajo, izrišejo ali prevedejo.

Pravila so natančna:

  • Če ni nobenega ključa tipa, se naložijo vsi tipi.
  • true, null ali "*" naloži vse zapise tega tipa.
  • Niz ali seznam se natančno ujema po ID-ju, imenu, polžu, poti ali izvorni poti.
  • Prazen niz, prazen seznam ali false ne naloži nobenega zapisa tega tipa.
  • Ko je prisoten kateri koli ključ tipa, izpuščeni tipi ostanejo nedotaknjeni.

Identifikatorji, ki ne obstajajo več, so vrnjeni pod deleted, namesto da bi prišlo do napake, in končna točka za osvežitev Canvas REST enako pravilo uporabi za parametra blocks in pages.

Canvas::documents() sprejme enak izbor in doda po en izrisan dokument za vsak zapis. Izbrane strani se izrišejo v obnovljenem kontekstu sprednjega dela, zato pogojni izrazi poizvedb, razredi telesa, kratke kode, postavitve, preusmeritve in povratni klici za vključitev sredstev vidijo to stran, ne zahteve, ki je zanjo zaprosila.

Samostojni izris

Blockstudio\Render vrne izrisani HTML kot niz po istem cevovodu, kot ga uporablja sprednji del.

PHP
use Blockstudio\Render;

$html = Render::composition([
    'root' => 'mytheme/card',
    'data' => ['heading' => 'Example card'],
    'layers' => [
        ['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
    ],
]);

V ozadju je ena oblika deklaracije s štirimi ključi: name, attributes, content in children. root, data, inner, innerBlocks, layers in example so priročnejši načini vnosa, ki jih Render::normalize() združi v to obliko. Podrejeni elementi se izrišejo rekurzivno, napačen vnos pa sproži izjemo, ki navede sporni blok.

Render::document() ovije izhod v celoten samostojni dokument HTML.

PHP
$document = Render::document('mytheme/hero', [
    'title' => 'Hero preview',
]);

echo $document['html'];

body je samo izhod bloka, html sestavljeni dokument, blocks imena blokov, ki so prispevali k njemu, assets pa razdeli označevalno kodo na head, footer, styles, scripts, modules, interactivity, ui in tailwind. Sredstva so omejena na tisto, kar je bilo izrisano, zato se sredstva, namenjena samo urejevalniku, nikoli ne pojavijo.

Render::document_from_html() ovije HTML, ki je izrisan drugje, in Render::content() izriše serializirano vsebino bloka brez dokumenta. Pokličite Blockstudio\Batch_Render::reset() med dokumenti v enem procesu PHP; Canvas::documents() to že naredi.

Družine komponent UI

Blockstudio\Ui razkrije priloženo knjižnico UI kot en vnos na javno komponento, namesto kot seznam notranjih delov.

Ui::inventory() vrne en vnos na družino z njenim korenskim blokom, naslovom in potrebnimi bloki izvedbe. Ui::examples() doda določljivo deklaracijo za vsako družino: privzete vrednosti so ohranjene, zahtevane podrejene plasti so ugnezdene pod nadrejene, prazna polja pa dobijo stabilno ponazoritveno besedilo. Ta deklaracija je kanonična, zato gre neposredno v Render::document().

Canvas združuje na enak način. Priloženi UI je prikazan pod tipom ui, po en primer za vsako družino, registracije izvedbenih blokov pa niso vključene v blocks.

Družine so zasnovane za sestavljanje: izbirnik se odpre v pogovornem oknu, seznam pa prekriva sprožilec; meniji in kombinirana polja se sidrajo s fiksnimi koordinatami pogleda, ki ostanejo nespremenjene med pomikanjem; modalna okna se zlagajo in zapirajo po eno s tipko Escape; vsaka noga pa združuje isti kontrolnik za zapiranje z različico. Kako ti stiki delujejo in katere nespremenljivosti jih ohranjajo, pojasnjuje poglavje o sestavljanju; /ui/examples prikazuje sestave v živo.

Pomožne predloge

Nespremenljive dimenzije slik

bs_media_image() izriše sredstva teme z dejansko širino, višino in rezerviranim razmerjem stranic, zato slike zunaj medijske knjižnice ne premikajo več postavitve.

PHP
<?php
echo bs_media_image([
    'src' => 'assets/images/hero.webp',
    'alt' => 'Hero',
]);

Izhod je figure.blockstudio-media z vdelanim aspect-ratio okoli img z dejanskimi vrednostmi width, height, loading in decoding. Dimenzije izhajajo iz ustvarjenega assets/media.json, ki ga v koraku gradnje zapiše Blockstudio\Media_Metadata_Builder ali se ga pripravi ročno.

src sprejme relativno pot znotraj teme, absolutno pot ali celoten URL, slike iz medijske knjižnice pa pokriva attachmentId. Z eager onemogočite leno nalaganje nad pregibom, sources pa izpiše <picture>.

Ko je omogočen performance.media.lazy, se dejanski URL premakne v data-src za pravilno veliko označbo mesta.

Pomožne funkcije za razrede Tailwind

bs_tw_merge() in bs_tw_variants() sestavljata razrede Tailwind v predlogah PHP z uporabo pogona, ki ga Blockstudio že vključuje.

bs_tw_merge('px-2 text-sm', 'px-4') vrne text-sm px-4: sporni px-2 se odstrani, uveljavi pa se poznejša vrednost. Sprejema ugnezdene polja vrednosti razredov.

bs_tw_variants() vrne majhno funkcijo za različice komponent:

PHP
$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']);

To izpiše inline-flex items-center h-12 px-6 rounded. Podprti so osnovni razredi, različice, privzete različice, sestavljene različice ter class ali className, podana ob posameznem klicu.

Produkcijska konfiguracija

Profili zmogljivosti

performance.profile na enem mestu vklopi privzete nastavitve produkcijskega sprednjega dela.

JSON
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}

compat je privzet in ničesar ne spreminja. speed in strict omogočita isti nabor: iz glave odstranita izpis ustvarjalca, emodžijev, virov, odkrivanja in sosednjih objav; odstranita odkrivanje oEmbed in skripte gostitelja; onemogočita XML–RPC, povratne pinge in oddaljeno odkrivanje urejevalnika; odstranita splošna jedrna sredstva sprednjega dela; uporabita privzete nastavitve za izpis slik; omejita pogostost Heartbeata zunaj urejevalnikov; vnaprej naložita dokumente z istega izvora ob nameri pomika ali fokusa; ter uporabita nalagalnik slik iz Blockstudio.

Vsaka podrejena vrednost preglasi profil, kot to velja zgoraj za preload.links. Najprej preverite odstranitev jedrnih sredstev sprednjega dela, saj se stran, ki je od njih odvisna, vidno pokvari. Runtime_Settings::current() razkrije razrešeni profil.

themeDefaults pokriva dve stvari, ki bi ju sicer morale teme pripraviti ročno: titleTag in suppressDirectoryUpdates za skrivanje aktivne podrejene in nadrejene teme med rezultati posodobitev.

Dostop do tipiziranih nastavitev

Blockstudio\Settings bere konfiguracijo z dejanskimi tipi, namesto da bi vrnil karkoli je vseboval JSON.

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

O napačnem JSON se poroča prek Settings::errors(), namesto da bi se razrešilo na privzete vrednosti. Settings::get_raw() vrne samo to, kar je določil aktivni vir, zato je mogoče ločiti vrednost, nastavljeno na false, od vrednosti, ki ni bila nikoli nastavljena.

Settings::fingerprint() vrne stabilno identiteto učinkovitih nastavitev, dostop do njih pa jih znova naloži, ko se spremeni blockstudio.json.

En imenik predpomnilnika

Vsaka ustvarjena datoteka je zdaj shranjena pod cache.path, ki je privzeto wp-content/blockstudio/cache.

JSON
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}

Tovori gradnje, podatki registracije blokov, sredstva urejevalnika, prevedeni Tailwind CSS, dokumenti izrisa, fragmenti otokov, statični HTML, indeksi grafov, čakalne vrste za ogrevanje in diagnostika so vsi pod tem korenom. Relativna pot se razreši glede na WP_CONTENT_DIR, absolutna pot pa ga usmeri na namenski nosilec.

Objekti so razvrščeni glede na trenutno omrežje in spletno mesto, nato pa glede na identiteto izvajalnega okolja: prstni odtis različic Blockstudio, WordPress in PHP, učinkovitih nastavitev, aktivne teme in vtičnikov, virov za odkrivanje ter vključenih izvornih datotek. Ko se vhod spremeni, nastanejo novi zadevni objekti, stari pa se odstranijo.

Hladne gradnje se izvajajo enkrat: ena zahteva zgradi in atomsko objavi rezultat, druge pa počakajo. Če osvežitev spodleti, se še naprej streže zadnji dober objekt, napaka pa ostane vidna; Blockstudio\Runtime_Cache::purge('tailwind') počisti en obseg.

Statični vnaprejšnji izris

Statični vnaprejšnji izris predpomni celotne anonimne dokumente HTML in jih lahko streže, še preden se zažene WordPress. Privzeto je izklopljen.

JSON
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}

Pogoji za vključitev

Vključiti je mogoče samo celotne anonimne dokumente HTML. Zahteve, ki niso GET, poizvedbeni nizi, skrbniški del, REST, Ajax, cron, viri, iskanje, predogledi, zahteve z nonce, personalizirani piškotki in vse poti pod dynamicPaths se preskočijo. Odgovor se lahko v celoti izvzame z označevalnikom <!-- blockstudio:no-cache -->.

Ujemanje poti upošteva meje, zato /account zajema /account/orders, ne pa /accounting.

Načina podpisa in grafa

invalidate določa, kako vnosi potečejo. Privzeti način signature ob anonimni zahtevi brez zadetka napolni odziv, določen z identiteto, po spremembah na ravni spletnega mesta pa zamenja identiteto; primeren je za običajno spletno mesto.

Način graph je namenjen izrecnim orodjem za gradnjo in uvedbo. Beleži izvorne odvisnosti vsake strani, zato načrt znova zgradi le prizadete URL-je.

PHP
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']));

Zgodnje streženje

Ko je omogočen earlyServe, Blockstudio upravlja majhen zemljevid poti za vsako spletno mesto in dodatek advanced-cache.php, ki primerni zadetek pretaka še pred zagonom WordPress, vtičnikov ali teme.

Nikoli ne prepiše tujega zemljevida, dodatka ali deklaracije WP_CACHE. Pred zamenjavo zemljevida artefakt grafa preveri vsako navedeno datoteko HTML, zato ob delni uvedbi prejšnji graf ostane aktiven. Vnosi za večmestno namestitev so ločeni glede na gostitelja, domačo pot in ID spletnega mesta.

Ogrevanje in stanje

Tri ukazi WP-CLI pokrivajo vsakodnevno uporabo:

Lupina
wp bs prerender warm
wp bs prerender status
wp bs prerender purge

status poroča o aktivni identiteti, številu datotek in bajtov, zapisih grafa, stanju čakalne vrste ter števcih zadetkov, zgrešenih poizvedb, gradenj in napak za vsak obseg.

Analiza in orodja za agente

Prednastavitve analize

blockstudio/phpstan pridobi tri plasti nad svojo analizo blokov in en ukaz, ki zažene plast, ki jo je izbral projekt.

Prednastavitev Kaj vključuje
base Obstoječo analizo shem, predlog, kavljev, nastavitev in API.
theme Korenike tem, glave slogov, sredstva, omejevanje obsega izbirnikov, privzete vrednosti polj, omejitve ponavljalnikov.
extreme-theme Preverjanja PHPStan max, nevarnih PHP, ubežnih znakov, Tailwind, JavaScript in interaktivnosti.
wordpress-render Preizkus izrisa v živo, ki ga poda klicatelj, poleg extreme-theme.

Privzete vrednosti izvirajo iz blockstudio.json, zato interaktivni zagoni, CI in potrditveni kavlji uporabljajo isto konfiguracijo:

JSON
{
  "phpstan": {
    "preset": "theme",
    "roots": ["."],
    "excludePaths": ["fixtures/**"],
    "maxFiles": 10000
  }
}
Lupina
vendor/bin/blockstudio-phpstan --root . -- --no-progress

Kode izhoda so 0 ob uspehu, 1 ob diagnostiki in 2 pri neveljavni uporabi. Ovojnica sestavi konfiguracijo v sistemskem začasnem imeniku, zato se ustvarjena konfiguracija, osnovno stanje ali predpomnilnik ne shranijo v projekt; omejitev pomnilnika za PHPStan pa poveča na 1G.

Ponuja tudi ponudnika BC Math, zato preverjanja JavaScript ne potrebujejo več ext-bcmath.

Upravljan potrditveni kavelj

Ena nastavitev in en ukaz spremenita izbrano prednastavitev v pogoj za potrditev.

JSON
{
  "githooks": {
    "commit": true
  }
}
Lupina
vendor/bin/blockstudio-githooks sync

Sinhronizacija zapiše kavelj in zapis o lastništvu v skupni imenik Git, usmeri core.hooksPath v upravljani imenik ter poveže predhodno nastavljen kavelj pred potrditvijo. Kavelj ob potrditvi razreši koren skladišča in projekta, zato delujejo povezane delovne kopije in poti s presledki.

Kavelj zažene vendor/bin/blockstudio-phpstan in ničesar drugega; datotek nikoli ne oblikuje ali prepisuje. Če nastavitev commit spremenite v false in znova sinhronizirate ali zaženete blockstudio-githooks remove, se obnovi zabeležena pot kavlja in izbrišejo samo datoteke v lasti Blockstudio.

Pogodba projekta

blockstudio-agents zapiše AGENTS.md, ki določa, kje so bloki, kaj v tem projektu pomeni stran, katere funkcije so omogočene in kaj bo analizator zavrnil.

Lupina
vendor/bin/blockstudio-agents

Dokument je izpeljan, ne temelji na predlogi. Pogodba teme z glavo style.css, bloki in stranmi, ki temeljijo na datotekah, se razlikuje od pogodbe vtičnika, ki registrira le bloke; vsebuje števila, imenike, imenske prostore in jezike predlog, ki jih je našel pregledovalnik. blockstudio.json določa, katere funkcije so prikazane, zato projekt brez statičnega vnaprejšnjega izrisa o njem ne omenja.

Razdelek o pravilnosti se bere iz datotek pravil izbrane prednastavitve, plast za plastjo, zato se vsaka ustvarjena pogodba spremeni, ko prednastavitev pridobi novo pravilo.

Lastništvo deluje podobno kot pri potrditvenem kavlju. Če datoteka nima označevalnika ustvarjene vsebine, je ni mogoče prepisati, razen če --force določa drugače; območje z opombami na koncu se ohrani pri ponovnem ustvarjanju; --check se konča z izhodno kodo 1, če je pogodba zastarela; --stdout pa jo izpiše, ne da bi posegel v datotečni sistem.

Kazalo dokumentacije

blockstudio-llm.txt je zdaj kazalo namesto združene vsebine. Vsak objavljeni dokument je naveden enkrat, v svojem razdelku in podrazdelku, skupaj s svojo potjo, izvorno datoteko, enovrstičnim opisom namena in identifikatorji, ki jih upravlja: potmi nastavitev, imeni kavljev, funkcijami in razredi PHP ter ukazi.

Text
## 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 prebere kazalo, poišče dokument, ki vsebuje iskani identifikator, in ga odpre. Prejšnja združena datoteka velikosti pol megabajta se še vedno ustvari in objavi na /blockstudio-llm-full.txt; ni pa več prva stvar, ki jo kdo dobi.

Kanonične oznake blokov

Samostojen ukaz prepiše okrajšave predpon in vzdevkov v kanonično obliko <bs:namespace-slug>, ki zabeleži pravo ime bloka in se razreši brez naloženega projektnega filtra.

S predpono brand za theme-components in predpono ui za bsui ta okrajšava:

HTML
<brand-card>
  <ui-input />
</brand-card>

pomeni enako kot:

HTML
<bs:theme-components-card>
  <bs:bsui-input />
</bs:theme-components-card>

Predpone in natančni vzdevki še vedno delujejo in niso opuščeni. Ukaz ne naloži WordPress in ne zapiše ničesar brez --apply:

Lupina
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 preslika vsako predpono v njene imenske prostore, --known-blocks pa navede registrirana imena blokov. Poročilo zabeleži preslikave iz zastarelih v kanonične oznake s številom pojavitev, zgoščenimi vrednostmi posameznih datotek ter ločenimi seznami neznanih oznak, dvoumnih vzdevkov in dinamičnih oznak. --apply zavrne zapis, dokler katera od teh postavk še obstaja, razen če je podan --allow-unresolved.

Obravnavani so seznanjeni, ugnezdeni in samozapiralni označevalni elementi, vključno z dobesednimi oznakami v nizih PHP. Spremenijo se samo imena oznak, drugi zagon ne povzroči sprememb, primeri v komentarjih, blokih kode, <pre> ali <code> pa so prikazani samo v poročilu.

Privzeto delovanje

Namestitev različice 7.6 sama po sebi ničesar ne spremeni.

Profil zmogljivosti je privzeto nastavljen na compat. Izhod v glavi, oEmbed, XML-RPC, Heartbeat, privzete nastavitve slik, vnaprejšnje nalaganje povezav, leno nalaganje in frontend <title> ostanejo takšni, kot so jih nastavili WordPress in tema.

Te možnosti ostanejo izklopljene, dokler jih ne omogočite: vsak ključ performance.staticPrerender, performance.measurement, performance.media in themeDefaults ter githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled in blockTags.enabled. Statično vnaprejšnje upodabljanje med izklopom ne ustvari datotek in ne namesti dodatka.

Canvas in Render sta pasivna. Prebereta obstoječe registre in upodobita samo tisto, kar zahteva klicatelj; ne posegata v izhod frontenda in ne registrirata poti. Za skrbniški zaslon Canvas sta še vedno potrebna dev.canvas.enabled in edit_posts.

Strožjo analizo morate izrecno določiti. Namestitev blockstudio/phpstan omogoči samo osnovno razširitev, kanonični ukaz pa zažene base, razen če projekt določi prednastavitev.

Ustvarjene datoteke zahtevajo zagon ustreznega ukaza. githooks.commit ne naredi ničesar, dokler se ne zažene blockstudio-githooks sync, prav tako AGENTS.md ne naredi ničesar, dokler se ne zažene blockstudio-agents.

Nadgradnja z različice 7.5

Zahteve ostajajo nespremenjene: PHP 8.2 ali novejši, WordPress 6.7 ali novejši.

Lupina
composer require blockstudio/blockstudio

Predpomnilniki se enkrat znova zgradijo. Identiteta izvajalnega okolja vključuje različico Blockstudio, zato je prva zahteva po nadgradnji neogreta, stari objekti pa se odstranijo. Stari predpomnilnik Tailwind v wp-content/uploads/blockstudio/tailwind/cache lahko izbrišete; delček kode, ki je uporabljal vzorec glob zanj, naj namesto tega pokliče Blockstudio\Runtime_Cache::purge('tailwind').

Imenik wp-content/blockstudio/cache/runtime v stari ploščati strukturi pred različico 7.6 se samodejno preimenuje in odstrani iz aktivne poti, nato pa se izbriše v omejenih prehodih WP-Cron. Zato velikih dreves starih zaklepnih datotek med zahtevo za uvedbo ni treba brisati.

Ustvarjene datoteke imajo določene lastnike. assets/media.json sodi v nadzor različic ali v gradbeni korak. Zemljevid poti, dodatna datoteka advanced-cache.php in deklaracija WP_CACHE obstajajo samo, dokler je omogočen earlyServe, kavelj pred potrditvijo pa samo, dokler je sinhroniziran. Vse drugo ustvarjeno je shranjeno pod cache.path in ga lahko varno izbrišete.

Nič ni bilo odstranjeno ali preimenovano. bs_render_block(), bs_block(), Blockstudio\Pages in Blockstudio\Patterns ostajajo kanonična vsebinska območja, ki temeljijo na datotekah.

Vrnitev na prejšnje stanje poteka za vsako funkcijo posebej. Vrnitev performance.profile na compat, staticPrerender.enabled na false, githooks.commit na false skupaj z sync ter cache.enabled na false vsakič razveljavi eno plast.

Smiseln vrstni red uvedbe:

  1. Nastavite performance.profile na speed, nato preverite izhod v glavi, vire in vse vtičnike, ki se zanašajo na oEmbed ali XML-RPC.
  2. Ustvarite assets/media.json, premaknite predloge v bs_media_image(), nato omogočite performance.media.lazy.
  3. Omogočite performance.staticPrerender z izklopljenim earlyServe, preverite zadetke z wp bs prerender status, nato vklopite earlyServe.
  4. Zaženite blockstudio-phpstan --preset theme in ga očistite, preden katero koli prednastavitev določite v githooks.commit.

Kje so podrobnosti