Dennis · 21. junij 2026
Blockstudio 7.4
Blockstudio Različica 7.4 je namenjena večji prenosljivosti projektov, ki temeljijo na datotekah. Različica 7.2 je olajšala pregledovanje in distribucijo večjih projektov, 7.3 pa je dodala plast UI. Različica 7.4 se osredotoča na prenos večjega dela projekta, njegovih strani in izbrane vsebine iz podatkovne zbirke v datoteke pod nadzorom različic.
Glavna novost so zbirke strani: način, da Blockstudio določite mapo z viri strani in iz nje ustvarite celotno ugnezdeno strukturo strani WordPress. Vir je lahko PHP, Twig, Blade, HTML, Markdown ali zaupanja vreden nalagalnik, ki vrne strani iz drugega lokalnega vira.
Na kratko:
- Zbirke strani:
pages.jsonlahko določijo celoten nabor ugnezdenih strani, privzete vrednosti, vedenje vrst objav, postavitve, nalagalnike in metapodatke zbirke. - Strani Markdown:
index.mddeluje kot vsebina strani, bodisi zpage.jsonbodisi samostojno z metapodatki v glavi. - Postavitve strani za sprednji del:
layout.phplahko ovijejo sinhronizirano vsebino strani in uporabljajo pomočnike, kot stablockstudio_page_tree()inblockstudio_page_content(). - Zunanji viri dokumentacije: nalagalniki zbirk lahko ustvarijo strani iz lokalnih datotek ali vrnjenih Markdown/HTML.
- Neobdelani izhod Markdown: viri strani Markdown so lahko na voljo kot
.mdali prekAccept: text/markdown. - Vrste objav po meri za zbirke: zbirke lahko upravljajo čiste URL-je, samodejno osveževanje pravil za prepisovanje, neobdelane poti Markdown in selitve strani v vrste objav po meri brez prilagoditev v temi.
- Content Sync:
wp bs content pull,wp bs content pushinwp bs content statusomogočajo prenos objav, izrazov, odnosov in deklariranih referenc meta s seznama dovoljenih v prenosljive datoteke projekta. - Predpone oznak blokov: predpone projekta, kot je
<theme-card>, se lahko razrešijo v urejenih imenskih prostorih brez vzdevkov za vsak blok. - Zanesljivejša sinhronizacija: spremembe strani se zaznajo v manifestih, nalagalnikih, postavitvah, metapodatkih in izvornih datotekah.
- Popravki med izvajanjem in v urejevalniku: dinamične možnosti ostanejo posodobljene, razredi blokov poizvedb se ohranijo pri programskem izrisu,
bsui/selectbolje deluje v gostih obrazcih, lastnosti RichText dosežejo urejevalnik, brisanje vrst v ponavljalniku z RichText pa se po shranjevanju ohrani.
Strani na podlagi datotek
Večina novosti v različici 7.4 temelji na straneh iz datotek.
Zbirke strani
Pred različico 7.4 so bile strani na podlagi datotek večinoma funkcija na ravni mape: ustvarite page.json, dodajte index.php ali index.twig, nato pa Blockstudio sinhronizira to posamezno stran v WordPress.
To še vedno deluje. Različica 7.4 dodaja drugi način za večje strukture.
V mapo dodajte manifest pages.json in ta mapa postane zbirka:
pages/
docs/
pages.json
layout.php
index.md
guide/
install/
index.md
reference/
page.json
index.md
{
"collection": "docs",
"title": "Documentation",
"postType": "bs_docs",
"postTypeArgs": {
"label": "Docs",
"rewrite": {
"slug": "docs"
},
"supports": ["title", "editor", "page-attributes"]
},
"defaults": {
"postStatus": "publish",
"templateLock": "contentOnly"
}
}
Odkrijejo, normalizirajo in sinhronizirajo se vsi viri strani v zbirki ter povežejo po poti. Stran na mestu guide/install postane podrejena stran strani guide; če manjka stran guide, Blockstudio ustvari ustvarjeno vsebniško stran, tako da se hierarhija WordPress še vedno ujema s strukturo datotečnega sistema.
Zbirke lahko uporabljajo izvorno vrsto objav page ali svojo vrsto objav. Ko zbirka določi vrsto objav, ki še ne obstaja, jo Blockstudio registrira iz postTypeArgs. Manifest postType postane tudi privzeta vrednost za vsako stran v zbirki, zato projektom tega ni treba ponavljati v defaults.
Vrste objav zbirk kot javno osnovo URL uporabljajo slug zbirke. Zbirka docs razreši svojo korensko stran na /docs/, stran z path: "getting-started" na /docs/getting-started/ in ugnezdene poti pod isto osnovo. Podvojeni URL-ji, kot je /docs/docs/, preusmerijo na kanonično lokacijo. Pravila prepisovanja se samodejno osvežijo, ko se spremeni usmerjanje vrste objav zbirke, zato za novo zbirko ni treba ročno shraniti trajnih povezav.
To je del, zaradi katerega so zunanja dokumentacija, priročniki za izdelke, baze znanja in knjižnice strani v WordPress videti naravno: vir ostane v datotekah, rezultat pa je še vedno prava, urejevalna vsebina WordPress.
Markdown kot vsebina strani
Markdown je zdaj polnovreden vir strani.
Samostojne strani Markdown uporabljajo metapodatke v glavi:
---
name: about
title: About
slug: about
postStatus: publish
---
# About
This Markdown content is synced as native WordPress blocks.
page.json lahko združite tudi z index.md, če želite konfiguracijo in vsebino ločiti v datoteki. Metapodatki v glavi index.md lahko preglasijo ujemajoča se polja page.json, neznani ključi v glavi pa se ohranijo kot metapodatki.
Markdown se pretvori v HTML in nato obdela z istim razčlenjevalnikom strani kot predloge PHP, Twig in Blade, zato je končna vsebina izvorna označevalna koda blokov.
Postavitve in pomočniki za strani
Zbirke lahko vključujejo datoteko layout.php. Na sprednjem delu Blockstudio ovije sinhronizirano vsebino strani s to postavitvijo.
<main class="docs-layout">
<aside>
<?php foreach (blockstudio_page_tree('docs') as $item) : ?>
<a href="<?php echo esc_url($item['permalink'] ?? '#'); ?>">
<?php echo esc_html($item['title']); ?>
</a>
<?php endforeach; ?>
</aside>
<article>
<?php echo blockstudio_page_content(); ?>
</article>
</main>
Novi pomočniki zbirko razkrijejo kot strukturirane podatke:
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();
Tako dobite vse, kar potrebujete za izdelavo celovitega ogrodja dokumentacije: navigacijo iz drevesa strani, metapodatke strani iz glave in sinhronizirano vsebino bloka WordPress kot glavni prostor za vsebino.
Nalagalniki in neobdelani Markdown
Zbirke lahko vključujejo zaupanja vredno lokalno datoteko loader.php. Ta lahko neposredno vrne strani ali pa določi dodatne lokalne mape, v katerih naj jih Blockstudio poišče.
<?php
return [
'pages' => [
[
'name' => 'docs-api',
'title' => 'API',
'path' => 'api',
'content' => "# API\n\nGenerated markdown content.",
'contentType' => 'markdown',
],
],
];
To je uporabno, kadar je vir že ustvarjen drugje: v mapi dokumentacije paketa, izvozu Markdown ali koraku gradnje, ki vrne seznam strani.
Viri strani Markdown lahko ponudijo tudi svojo neobdelano izvorno kodo Markdown. Zahtevajte stran s pripono .md ali pošljite Accept: text/markdown. Metapodatki v glavi se odstranijo iz odgovora, zato orodja prejmejo berljivo telo dokumenta. To deluje tudi za vrste objav zbirk, vključno z URL-ji, kot sta /docs.md in /docs/getting-started.md.
Preberite dokumentacijo za strani
Content Sync
Različica 7.4 uvaja tudi Content Sync, potek dela WP-CLI za ekipe, ki želijo večji del svojega projekta WordPress predstaviti kot datoteke.
wp bs content pull
wp bs content push --dry-run
wp bs content status
Blockstudio že hrani bloke, polja, predloge, vzorce in strani na podlagi datotek v vašem projektu. Content Sync temu poteku dela, ki daje prednost datotekam, doda izbrano vsebino podatkovne zbirke: objave, izraze, odnose in deklarirane metapodatke s seznama dovoljenih lahko prenesete v datoteke, jih pregledate v git in pošljete v drugo okolje.
Zasnovan je tako, da je vse izrecno določeno. Omogočite ga v blockstudio.json, dodate vrste objav in taksonomije, ki jih želite upravljati, na seznam dovoljenih ter navedete reference metapodatkov, ki jih je treba prepisati med okolji.
Pri prenosu Blockstudio zapiše prenosljive objave, izraze, odnose in metapodatke s seznama dovoljenih v datoteke v vaši temi. Pred pošiljanjem preveri načrt, nato pa deklarirane reference post, term in attachment razreši v lokalne ID-je podatkovne zbirke. Ne predvideva, da so poljubna cela števila ID-ji.
Obseg različice 7.4 je namenoma konservativen: objave, izrazi, odnosi med izrazi, metapodatki s seznama dovoljenih, prenosljivi UID-ji, manifesti prilog, poskusni zagoni, obravnava odstranjevanja, zaklenjene entitete in poročanje o stanju. Zajem definicij taksonomij, kopiranje binarnih predstavnostnih datotek in prepisovanje ID-jev v označevalni kodi blokov so namenoma izpuščeni iz te prve različice.
Tako lahko ekipe na pregleden način upravljajo različice izbrane vsebine, kot so člani ekipe, študije primerov, lokacije, vnosi dokumentacije ali drugi strukturirani zapisi, ne da bi celotno produkcijsko podatkovno zbirko spreminjale v selitev. Namenjena je naborom vsebine, ki jih je še mogoče pregledovati kot datoteke: desetinami ali stotinami vrstic, v nekaterih projektih pa tudi nekaj tisoč, če je vsebina strukturirana in se redko spreminja. Ni nadomestilo za varnostne kopije podatkovne zbirke, sinhronizacijo e-trgovine/naročil, analitiko, dnevnike, oddaje obrazcev ali druge obsežne podatke.
Preberite dokumentacijo za Content Sync
Zanesljivejša sinhronizacija
Blockstudio zdaj zazna spremembe v virih strani, manifestih zbirk, datotekah nalagalnikov in postavitev, metapodatkih ter povezanih poteh. Če se spremeni kar koli od tega, se sinhronizirana stran WordPress posodobi.
Cevovod strani obravnava tudi podrobnosti, zaradi katerih so dokumenti na podlagi datotek uporabni v resničnih projektih:
- Viri strani Markdown se sinhronizirajo kot izvorna vsebina blokov, vključno z atributi blokov
- metapodatki v glavi so na voljo pomočnikom in postavitvam sprednjega dela
- strani zbirk ohranijo stabilno identiteto med sinhronizacijami
- ugnezdene strani, ki niso del zbirke, se povežejo z nadrejeno stranjo
- ugnezdene strani zunaj zbirk lahko podedujejo najbližji nadrejeni
layout.php - odstranjeni viri zbirk počistijo ustvarjene strani WordPress
- ko zbirka spremeni vrsto objav iz
pagev vrsto po meri, se obstoječe sinhronizirane objave preselijo, namesto da bi nastali dvojniki - vrstni red strani se ohrani prek
menu_order
Predpone oznak blokov
Oznake blokov zdaj podpirajo nastavljive predpone imenskih prostorov. Projekt lahko registrira eno kratko predpono in omogoči, da Blockstudio razreši blok v enem ali več imenskih prostorih:
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
$prefixes['theme'] = ['theme-components', 'bsui'];
return $prefixes;
});
Ko je to nastavljeno, se lahko <theme-card> razreši v theme-components/card, <theme-button> lahko uporabi bsui/button kot nadomestno možnost, <theme-ui-feature-matrix> pa se lahko razreši v theme-components/ui-feature-matrix.
Izrecne tag_aliases imajo še vedno prednost, kadar projekt potrebuje enkratno preglasitev. Oznake z neznano predpono ostanejo nespremenjene, obstoječi filtri za dovoljevanje/prepovedovanje oznak blokov pa še naprej veljajo tudi za bloke, razrešene prek predpon.
Preberite dokumentacijo za oznake blokov
Popravki med izvajanjem in v urejevalniku
Različica 7.4 vključuje tudi vrsto popravkov, ki so nastali na podlagi uporabe v resničnih projektih.
- Možnosti, napolnjene z dinamično poizvedbo, ostanejo posodobljene, ko se spremenijo objave, izrazi, uporabniki ali povezani metapodatki, izbirniki poizvedb
populate.fetch: truepa pri praznih iskanjih v urejevalniku pridobijo sprotne možnosti. - Oznake blokov
core/queryincore/comments, ustvarjene programsko, ohranijoclassNamev ustvarjeni označevalni kodi ovoja. - Psevdokomponente predlog ohranijo lastnosti camelCase, zato lastnosti, kot sta
allowedFormatsinwithoutInteractiveFormatting, dosežejo komponento urejevalnika, namesto da bi bile prej zavržene. bsui/selectzanesljiveje obravnava podatke možnosti in prelivajoče se menije, zlasti znotraj gostejših kontrol urejevalnika.blockstudio/phpstanprepozna polja, deklarirana znotraj vsebnikovtabs, zato preverjanje predlog, Twig/Blade in oznak blokov razume enako obliko polj, kot jo uporabljajo projekti Blockstudio.- Brisanje vrstice ponavljalnika z RichText se po shranjevanju ohrani. Zastarele vrednosti RichText izbrisane vrstice ne morejo več priklicati nazaj.
Zakaj je ta izdaja pomembna
Tema različice 7.4 je prenosljivost.
Zbirke strani spremenijo celotna spletna mesta z dokumentacijo v mape z izvornimi datotekami. Strani Markdown omogočajo preprosto pisanje in branje te vsebine. Content Sync razširi isti model, ki daje prednost datotekam, na izbrano vsebino podatkovne zbirke, tako da lahko objave, izrazi in odnosi živijo v git ter se prenašajo med okolji. Predpone oznak blokov poskrbijo za preglednejše predloge v velikih knjižnicah blokov.
Blockstudio še vedno temelji na datotekah. Bloki so še vedno mape. Strani so še vedno datoteke. Različica 7.4 omogoča, da je večji del projekta, njegove strukture strani in izbrana vsebina v teh datotekah ter se prenaša skupaj z njimi.