Dennis · 14. októbra 2026
Blockstudio 7.7
Blockstudio 7.7 prináša virtuálne trasy pre dokumenty bez príspevku WordPress, zlepšuje cielené zostavenia na predgenerovanie a zvyšuje spoľahlivosť úprav a vykresľovania existujúcich blokov. Rozširuje tiež kontroly značiek blokov v PHPStan a zlepšuje prístupnosť dodávaných komponentov UI.
Pracovný postup založený na súboroch zostáva rovnaký. Bloky sa vykresľujú zo svojich šablón a stránky založené na súboroch sa menia prostredníctvom výslovnej synchronizácie CLI alebo API. Toto vydanie nezavádza automatickú synchronizáciu stránok pri požiadavkách návštevníkov ani správcov.
Stručne:
- Virtuálne trasy: poskytujú galériu komponentov, katalóg alebo iný úplný dokument bez vytvorenia príspevku či vlastného obslužného programu na presmerovanie.
- Cielené zostavenia na predgenerovanie: zostavenia HTTP zaznamenávajú zdrojové súbory používané každou stránkou, takže ďalšie zostavenie môže vykresliť iba dotknuté trasy.
- Uchovávanie vyrovnávacej pamäte: ponecháva zastarané štýly dostupné pre stránky vo vyrovnávacej pamäti a umožňuje kontrolovať alebo čistiť nepoužívané záznamy včasného poskytovania.
- Spoľahlivejší editor: viacnásobne vybraté bloky si zachovávajú vlastné hodnoty, funkcie vrátenia a opakovania zmien fungujú pre RichText a polia bočného panela a zdedený kontext zostáva priradený k správnemu bloku.
- Vernosť obsahu súborov: vnorené zoznamy, prvky členenia dokumentu, vložené HTML, skrátené kódy, ako aj escapované atribúty sa zachovajú pri parsovaní a vykresľovaní.
- Vylepšenia PHPStan: značky prefixov, aliasy, mapované prvky stránok a premenné šablón sa kontrolujú podľa vlastných definícií projektu.
- Prístupné UI: ovládacie prvky správne sprístupňujú svoj stav, menovky prepínajú príslušné vstupy a komponenty zoznamov a tabuliek používajú platnú štruktúru HTML.
- Preklady: nainštalované preklady JavaScript sa načítavajú v editore a prehľade správy vrátane ovládacích prvkov polí, ktoré predtým neboli preložené.
Virtuálne trasy
Niektoré stránky vychádzajú z údajov, nie z príspevku spravovaného editorom. Napríklad referencia komponentu môže potrebovať vlastné URL a názov dokumentu, no nie záznam v wp_posts.
Zaregistrujte tento dokument pomocou Blockstudio\Virtual_Routes:
add_action('init', function () {
Blockstudio\Virtual_Routes::register(
'components',
function () {
get_header();
echo bs_block([
'name' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
]);
get_footer();
},
['title' => 'Component gallery']
);
});
Trasa poskytuje /components/. Jej spätná funkcia sa vykonáva vo výstupnom buffri Blockstudio, takže vykreslené bloky dostávajú štýly, skripty, pribalené prostriedky UI a výstup Tailwind prostredníctvom bežného procesu. Funkcia WordPress nemení zodpovedajúcu trasu na 404 ani ju nepresmeruje na príspevok.
Pre skupinu adries URL nastavte prefix na true a zadajte spätnú funkciu match. Spätná funkcia dostane cestu za trasou a vráti hodnotu, ktorú potrebuje vykresľovač. Ak vráti null alebo false, požiadavka sa prenechá systému WordPress. Pomocou urls uveďte cesty, ktoré má statické predgenerovanie zahrnúť. Jedna trasa bez prefixu štandardne zahŕňa vlastnú cestu.
Virtual_Routes::urls() vracia absolútne adresy URL pre integrácie, ktoré zostavujú mapu stránok. Virtuálne dokumenty automaticky nepridáva do mapy stránok príspevkov WordPress.
Pozrite si Virtuálne trasy, kde nájdete úplné API a možnosti.
Presnejšie zostavenia na predgenerovanie
Zostavenia v režime grafu vykreslené cez HTTP teraz zaznamenávajú súbory použité jednotlivými trasami: šablónu WordPress, šablóny a prostriedky vykreslených blokov, definície a rozloženia stránok zo súborov a závislosti pridané prostredníctvom blockstudio/render/dependencies.
Pri ďalšom zostavení build_plan() porovná tieto závislosti. Zmena šablóny bloku označí súvisiace trasy na vykreslenie bez toho, aby bolo potrebné znova zostaviť všetky nesúvisiace stránky. Zmeny spoločnej konfigurácie naďalej ovplyvňujú celé zostavenie a nové alebo expirované trasy sa vykreslia ako doteraz.
Zmeny iba v databáze nie sú závislosťami súborov. Nasadenie, ktoré potrebuje načítať nastavenie, príspevok alebo inú hodnotu z databázy, musí vynútiť zostavenie alebo výslovne vykresliť dotknuté adresy URL.
Vydanie tiež opravuje zmeny identity zostavenia počas prvého vykreslenia, zastarané mapy včasného poskytovania vo vyrovnávacej pamäti opkódov a vylučovanie platných adries URL len preto, že ich cesta obsahuje search alebo preview. Požiadavky Markdown používajúce Accept: text/markdown obchádzajú vyrovnávaciu pamäť HTML a príslušné odpovede odosielajú Vary: Accept.
Statické predgenerovanie teraz pri rozhodovaní, či pripojiť svoje háky, rešpektuje filtre zaregistrované aktívnou témou. Téma tak môže túto funkciu vypnúť bez toho, aby ju predchádzajúce vyhľadanie nastavení ponechalo aktívnu.
Pozrite si Statické predgenerovanie.
Uchovávanie a údržba vyrovnávacej pamäte
Stránka HTML vo vyrovnávacej pamäti môže zostať dostupná aj po skončení platnosti identity runtime, ktorá skompilovala jej štýly. cache.namespaceGrace určuje, ako dlho zostanú zastarané menné priestory dostupné po tom, čo ich čistenie prvýkrát označí za zastarané:
{
"cache": {
"namespaceGrace": 777600
}
}
Tento príklad uchováva zastarané súbory deväť dní. Predvolené nastavenie je jeden deň. Aktívne menné priestory a priestory poskytujúce nasadené artefakty predgenerovania sú chránené pred čistením zastaraných súborov.
Mapa včasného poskytovania má tiež príkazy na kontrolu a čistenie:
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
Tieto príkazy zobrazia a odstránia záznamy odstránených webov alebo chýbajúcich adresárov. Odstránením webu z viacerých webov sa odstránia aj jeho záznamy. Chýbajúce dokumenty trás sa vykazujú samostatne a nespôsobia odstránenie záznamu celého platného webu.
Pokyny k uchovávaniu nájdete v Ukladaní do vyrovnávacej pamäte a príkazy v údržbe mapy.
Spoľahlivejší editor
Úprava viacnásobne vybratého bloku teraz mení iba tento blok. Pri ukladaní sa zachová vlastný obsah, kľúče, metadáta a zámky každého bloku namiesto kopírovania atribútov medzi vybratými blokmi.
Hodnoty RichText sa nachádzajú priamo v atribútoch bloku, takže Gutenberg ich môže zahrnúť do vrátenia a opakovania zmien. Polia bočného panela sú súčasťou tej istej histórie. InnerBlocks templateLock="false" sa odovzdáva ako skutočná logická hodnota a odomkne obsah, aj keď je uzamknutá nadradená oblasť.
Počiatočné prednačítania dostávajú ID a typ upravovaného príspevku, takže šablóny môžu pri prvom vykreslení načítať správne metadáta. Rovnaké podradené bloky pod rôznymi nadradenými blokmi si pri prednačítaní a vo vyrovnávacích pamätiach vykresľovania zachovávajú oddelený zdedený kontext. Zmeny atribútov alebo kontextu počas počiatočnej požiadavky už nezanechajú neaktuálny náhľad.
Blockstudio tiež prestáva vkladať skryté prvky značiek vykresľovania medzi korene blokov. Selektory susedných súrodencov, napríklad .card + .card, teraz v editore vidia rovnaké vzťahy medzi prvkami ako vo frontende, pričom náhľady vykreslenia v editore a vkladacom nástroji zostávajú oddelené.
Bezpečnejšie ukladanie nastavení pre celý web
Polia založené na nastaveniach naďalej poskytujú hodnoty pre celý web, no uloženie príspevku už naslepo nezapisuje všetky uložené kópie týchto polí:
- Uloženia konceptov, čakajúcich, súkromných a naplánovaných príspevkov nezapisujú aktívne nastavenia webu.
- Uloženia publikovaných príspevkov zapisujú dodané polia, ktoré sa v danej úprave zmenili.
- Uloženie, pri ktorom sa mení iba názov, nevráti novšiu hodnotu pre celý web na staršiu.
- Chýbajúce polia a odstránené bloky neodstránia existujúce nastavenia.
- Výslovný pokyn
nullodstráni nastavenie. Platnými hodnotami zostávajú prázdne reťazce,false, nula a prázdne polia.
Toto je hlavná zmena správania, ktorú treba skontrolovať pri aktualizácii. Ak integrácia používala súkromný príspevok alebo koncept na aktualizáciu aktívneho nastavenia, zapíšte toto nastavenie výslovne alebo použite publikovaný konfiguračný príspevok. Obmedzenie iba na publikované príspevky nemá vplyv na ukladanie metadát príspevkov.
Úplné pravidlá ukladania nájdete v Úložisku.
Obsah súborov zostáva neporušený
Proces prevodu z HTML na bloky zachováva viac štruktúry, ktorú ste vytvorili:
- Vnorené zoznamy sa menia na vnútorné bloky zoznamu podradenej položky. Zachovajú sa triedy zoznamu a položiek; bežné ploché zoznamy si ponechávajú predchádzajúci výstup.
- Značky
main,header,footer,articleaasidesa menia na skupinové bloky, ktoré zachovávajú daný prvok namiesto surového HTML, ktoré obchádza vykresľovanie blokov. - Mapované odseky s formátovaným textom zachovávajú vložené značky, odseky obsahujúce iba obrázok sa mapujú na príslušný blok obrázka a značky skrátených kódov si zachovávajú obsah.
- Escapované atribúty sa dekódujú a escapujú iba raz vrátane atribútov prvkov
InnerBlocks,RichTextauseBlockProps. - Znamienka väčší ako vo vnútri atribútov značky so samostatným uzatváraním v úvodzovkách sa akceptujú.
- Globálne atribúty HTML sa prenesú ku koreňu bloku Blockstudio, ak ich blok nedefinuje ako polia.
wp bs pages synchlási uložené atribúty, ktoré sa nevykresľujú.
Stránky, vzory a šablóny Editora webu založené na Blade sa teraz vykresľujú prostredníctvom Blockstudio\Blade_Renderer a podporujú verzie illuminate/view od 8 do 12. Zaregistrujú sa všetky rozširujúce súbory zacielené na rovnaký blok a ich priority, skupinové polia a zoznamy cieľov sa riadia dokumentovanou schémou.
Sledujú sa aj vnorené závislosti SCSS. Úprava čiastočnej šablóny importovanej inou čiastočnou šablónou zmení verziu závislého súboru štýlov a spustí opätovnú kompiláciu.
Vylepšenia PHPStan
Samostatne inštalovaný balík blockstudio/phpstan rozširuje overovanie značiek blokov o značky s prefixmi a aliasmi, mapované prvky stránok, rozloženia, pribalené bloky UI a voliteľne ďalšie zdroje PHP projektu. Rozlíšenie menných priestorov zodpovedá runtime vrátane menných priestorov s pomlčkami a akceptujú sa globálne atribúty HTML odovzdané ďalej.
Premenné šablón blokov, napríklad $a, $block a $context, sa v Blockstudio považujú za definované. Typy polí sa zachovajú pri operátore zlúčenia s hodnotou null a pri isset() v rámci PHPStan 2.3; šablóna, ktorá priradí vlastné $a, si zachová priradený typ.
Tieto zmeny sú súčasťou blockstudio/phpstan 0.1.9. Aktualizujte balík samostatne od doplnku; vyžaduje PHPStan 2.1.47 alebo novší:
composer require --dev blockstudio/phpstan:^0.1.9
Konfiguráciu a predvoľby analýzy nájdete v PHPStan.
Prístupnosť a preklady
Tlačidlá dodávaných komponentov UI sprístupňujú svoj rozbalený stav na samotnom tlačidle. Menovky zaškrtávacích políčok, prepínačov a výberových tlačidiel pomenúvajú a ovládajú príslušné prvky. Navigačné omrvinky, stránkovanie, navigačné ponuky a tabuľky už nevkladajú neplatné obalové prvky medzi zoznamy či tabuľky a ich potomkov.
Prepínače zobrazenia hesla sprístupňujú svoj stlačený stav a majú väčšiu klikateľnú plochu. Vstupy akceptujú autocomplete a vstupy hesla akceptujú výslovné ID a prístupnú menovku. Zobrazovacie oblasti karuselov možno zamerať klávesnicou a animácie indikátorov načítania a náhradných blokov rešpektujú nastavenie obmedzeného pohybu.
Editor a prehľad správy načítavajú nainštalované preklady JavaScript pre textovú doménu blockstudio. Ponuky atribútov a zástupné texty, akcie kontextových okien s kódom a označenia obrázkov a súborov sa teraz dajú prekladať. Reťazce bez prekladu zostávajú v angličtine.
Pozrite si UI knižnicu a nastavenie prekladov.
Dokumentácia a aktualizácia
Dokumentácia prináša príručky pre dokumentačné weby, synchronizáciu obsahu, šablóny editora webu, značky blokov, ostrovy, vlastné typy polí, nasadzovanie, predvykresľovanie, nastavenie registra, analytické nástroje a obrazovky aplikácie UI. Sprievodca migráciou ACF zohľadňuje aktuálnu registráciu ACF a väzby blokov.
Príklady vlastného napĺňania teraz používajú podporovaný filter s pomenovanou množinou údajov a jedným argumentom. Dokumentácia k prostriedkom vysvetľuje poradie štýlových súborov na frontende a spôsob načítania úprav témy po CSS bloku. Inštalácie pre prispievateľov používajú verejný balík Font Awesome bez prihlasovacích údajov do registra.
PHP 8.2 a WordPress 6.7 zostávajú minimálnymi požiadavkami. Virtuálne trasy a nové príkazy údržby sú dostupné bez zmeny existujúcich kolekcií stránok. Skontrolujte vyššie uvedené pravidlá ukladania možností, ak ho používate, aktualizujte samostatný balík PHPStan a synchronizáciu stránok naďalej spúšťajte výslovne ako doteraz.
7.7.1 Následné kroky
Záplata 7.7.1 sprehľadňuje a zvyšuje bezpečnosť výsledkov synchronizácie. Zlúčenie podľa kľúča, ktoré nezmení príspevok, už nevytvorí revíziu ani neaktualizuje časovú pečiatku úpravy. Existujúce stavy publikovania sa zachovajú, nahradenie názvu a slugu údajmi zo súboru sa zaznamená a zamknuté alebo odstránené stránky sa uvedú v správe CLI. Content Sync označí telá priradené k Page Sync a zachová existujúce kontrolné kópie. Záplata tiež chráni atribúty priradené k WordPress pred konfliktnými ID polí a zachováva triedy editora pridané inými filtrami.