Dennis · 21. kesäkuuta 2026
Blockstudio 7.4
Blockstudio 7.4:n tavoitteena on tehdä tiedostopohjaisista projekteista helpommin siirrettäviä. Versio 7.2 helpotti suurempien projektien tarkastelua ja jakelua, ja 7.3 lisäsi päälle UI-kerroksen. Versio 7.4 keskittyy siirtämään yhä suuremman osan projektista, sen sivuista ja kuratoidusta sisällöstä tietokannasta versionhallittuihin tiedostoihin.
Tärkein uusi ominaisuus on sivukokoelmat: niiden avulla voit osoittaa Blockstudio-sivulähteiden kansioon ja luoda siitä täydellisen sisäkkäisen WordPress-sivurakenteen. Lähde voi olla PHP, Twig, Blade, HTML, Markdown tai luotettu lataaja, joka palauttaa sivuja toisesta paikallisesta lähteestä.
Lyhyesti:
- Sivukokoelmat:
pages.jsonvoi määrittää täydellisen joukon sisäkkäisiä sivuja, oletusarvoja, sisältötyypin toimintaa, asetteluja, lataajia ja kokoelman metatietoja. - Markdown-sivut:
index.mdtoimii sivusisältönä joko yhdessäpage.json:n kanssa tai yksinään etumetadatan kanssa. - Käyttöliittymän sivuasettelut:
layout.phpvoi kääriä synkronoidun sivusisällön asetteluun ja käyttää apufunktioita, kutenblockstudio_page_tree()jablockstudio_page_content(). - Ulkoiset dokumentaatiolähteet: kokoelman lataajat voivat luoda sivuja paikallisista tiedostoista tai palautetuista Markdown/HTML-tiedoista.
- Raaka Markdown-tuloste: Markdown-sivulähteet voidaan tarjota muodossa
.mdtai kohteenAccept: text/markdownkautta. - Kokoelmien mukautetut sisältötyypit: kokoelmat voivat hallita selkeitä URL-osoitteita, automaattista uudelleenkirjoitussääntöjen päivitystä, raakoja Markdown-reittejä ja sivujen siirtoja sisältötyypeiksi ilman teeman puoleisia sovituksia.
- Content Sync:
wp bs content pull,wp bs content pushjawp bs content statusmahdollistavat sallittujen sisältöjen, termien, suhteiden ja ilmoitettujen metaviitteiden tallentamisen siirrettäviin tiedostoihin. - Lohkotunnisteiden etuliitteet: projektin etuliitteet, kuten
<theme-card>, voidaan ratkaista järjestettyjen nimiavaruuksien välillä ilman lohkokohtaisia aliaksia. - Luotettavampi synkronointi: sivumuutokset havaitaan manifestien, lataajien, asettelujen, metatietojen ja lähdetiedostojen kautta.
- Ajonaikaiset ja muokkaimen korjaukset: dynaamiset valinnat pysyvät ajan tasalla, kyselylohkojen luokat säilyvät ohjelmallisessa renderöinnissä,
bsui/selecttoimii paremmin tiiviissä lomakkeissa, RichText-propit välittyvät muokkaimelle ja toistimen rivin poisto RichTextin kanssa säilyy tallennuksen jälkeen.
Tiedostopohjaiset sivut
Suurin osa versiosta 7.4 rakentuu tiedostopohjaisten sivujen varaan.
Sivukokoelmat
Ennen versiota 7.4 tiedostopohjaiset sivut olivat enimmäkseen kansiotason ominaisuus: luo page.json, lisää index.php tai index.twig, ja Blockstudio synkronoi kyseisen sivun kohteeseen WordPress.
Tämä toimii edelleen. Versio 7.4 lisää toisen toimintatilan suuremmille rakenteille.
Lisää kansioon pages.json-manifesti, niin kansiosta tulee kokoelma:
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"
}
}
Kokoelman jokainen sivulähde löydetään, normalisoidaan, synkronoidaan ja linkitetään polun perusteella. Kohteessa guide/install oleva sivu muuttuu kohteen guide alasivuksi. Jos guide-sivu puuttuu, Blockstudio luo automaattisesti säilösivun, jotta WordPress-hierarkia vastaa edelleen tiedostojärjestelmän rakennetta.
Kokoelmat voivat käyttää natiivia page-sisältötyyppiä tai omaa sisältötyyppiään. Kun kokoelma määrittää sisältötyypin, jota ei vielä ole, Blockstudio rekisteröi sen kohteesta postTypeArgs. Manifestin postType toimii myös kokoelman jokaisen sivun oletusarvona, joten projekteissa sitä ei tarvitse toistaa kohteessa defaults.
Kokoelmien sisältötyypeissä käytetään kokoelman polkutunnusta julkisena URL-peruspolkuna. docs-kokoelman juurisivu avautuu kohteessa /docs/, kohteen path: "getting-started" sivu kohteessa /docs/getting-started/ ja sisäkkäiset polut saman peruspolun alla. Kaksinkertaiset URL-osoitteet, kuten /docs/docs/, ohjataan ensisijaiseen osoitteeseen. Uudelleenkirjoitussäännöt päivitetään automaattisesti kokoelman sisältötyypin reitityksen muuttuessa, joten uuden kokoelman lisääminen ei edellytä pysyvien linkkien manuaalista tallentamista.
Tämä tekee ulkoisesta dokumentaatiosta, tuoteoppaista, tietopankeista ja sivukirjastoista luontevia WordPress:ssä: lähde säilyy tiedostoissa, mutta tuloksena on silti aitoa muokattavaa WordPress-sisältöä.
Markdown sivusisältönä
Markdown on nyt ensiluokkainen sivulähde.
Erilliset Markdown-sivut käyttävät etumetadataa:
---
name: about
title: About
slug: about
postStatus: publish
---
# About
This Markdown content is synced as native WordPress blocks.
Voit myös yhdistää page.json:n ja index.md:n, kun haluat jakaa määrityksen ja sisällön eri tiedostoihin. Kohteen index.md etumetadata voi ohittaa vastaavat page.json-kentät, ja tuntemattomat etumetadatan avaimet säilyvät metatietoina.
Markdown muunnetaan muotoon HTML ja käsitellään sitten samalla sivujäsentimellä kuin PHP-, Twig- ja Blade-pohjat, joten lopullinen sisältö on natiivia lohkomerkintää.
Asettelut ja sivujen apufunktiot
Kokoelmat voivat sisältää layout.php-tiedoston. Käyttöliittymässä Blockstudio käärii synkronoidun sivusisällön kyseisellä asettelulla.
<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>
Uudet apufunktiot tuovat kokoelman saataville rakenteisena tietona:
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();
Näiden avulla voit rakentaa kattavan dokumentaatiorakenteen: sivupuusta muodostuvan navigoinnin, etumetadatasta saatavat sivun metatiedot sekä synkronoidun WordPress-lohkosisällön pääsisältönä.
Lataajat ja raaka Markdown
Kokoelmiin voi sisällyttää luotetun paikallisen loader.php-tiedoston. Se voi palauttaa sivuja suoraan tai osoittaa Blockstudio:lle löydettäviä paikallisia lisähakemistoja.
<?php
return [
'pages' => [
[
'name' => 'docs-api',
'title' => 'API',
'path' => 'api',
'content' => "# API\n\nGenerated markdown content.",
'contentType' => 'markdown',
],
],
];
Tästä on hyötyä, kun lähde on jo luotu muualla: esimerkiksi paketin dokumentaatiokansiossa, Markdown-viennissä tai koontivaiheessa, joka palauttaa sivuluettelon.
Markdown-sivulähteistä voi tarjota myös raakaa Markdown-lähdettä. Pyydä sivua .md-päätteellä tai lähetä Accept: text/markdown. Etumetadata poistetaan vastauksesta, jotta työkalut saavat luettavan dokumentin rungon. Tämä toimii myös kokoelmien sisältötyypeillä, esimerkiksi osoitteissa /docs.md ja /docs/getting-started.md.
Content Sync
Versiossa 7.4 esitellään myös Content Sync, WP-CLI-työnkulku tiimeille, jotka haluavat tallentaa suuremman osan WordPress-projektistaan tiedostoina.
wp bs content pull
wp bs content push --dry-run
wp bs content status
Blockstudio pitää lohkot, kentät, mallit, kuviot ja tiedostopohjaiset sivut jo valmiiksi projektissasi. Content Sync lisää tähän tiedostokeskeiseen työnkulkuun valikoitua tietokantasisältöä: sallitut artikkelit, termit, suhteet ja määritellyt metatiedot voidaan tuoda tiedostoihin, tarkistaa git-työkalulla ja viedä toiseen ympäristöön.
Toiminta on tarkoituksella tarkkarajaista. Ota se käyttöön kohteessa blockstudio.json, salli hallittavat sisältötyypit ja luokittelut sekä määritä metaviitteet, jotka tulee kirjoittaa uudelleen ympäristöjen välillä.
Vedon aikana Blockstudio kirjoittaa siirrettävät artikkelit, termit, suhteet ja sallitut metatiedot teeman tiedostoihin. Työntövaiheessa se validoi suunnitelman ennen kirjoittamista ja ratkaisee ilmoitetut post-, term– ja attachment-viitteet takaisin paikallisiksi tietokannan tunnisteiksi. Se ei oleta mielivaltaisia kokonaislukuja tunnisteiksi.
Version 7.4:n laajuus on tarkoituksella rajattu: artikkelit, termit, termien suhteet, sallitut metatiedot, siirrettävät UID-tunnisteet, liitteiden manifestit, kuiva-ajot, poistojen käsittely, lukitut entiteetit ja tilan raportointi. Luokittelujen määritelmien tallennus, mediatiedostojen kopiointi ja lohkomerkintöjen tunnisteiden uudelleenkirjoitus on jätetty tarkoituksella pois tästä ensimmäisestä versiosta.
Näin tiimit voivat versioida kuratoitua sisältöä, kuten tiimin jäseniä, asiakastapauksia, sijainteja, dokumentaatiomerkintöjä tai muita rakenteisia tietueita, muuttamatta koko tuotantotietokantaa siirroksi. Toiminto on tarkoitettu sisältöjoukoille, joita voi yhä tarkastella tiedostoina: kymmenille tai sadoille riveille ja joissakin projekteissa muutamalle tuhannelle, kun sisältö on rakenteista ja muuttuu harvoin. Se ei korvaa tietokannan varmuuskopioita, verkkokaupan tai tilausten synkronointia, analytiikkaa, lokeja, lomakelähetyksiä tai muuta suurivolyymista dataa.
Lue Content Syncin dokumentaatio
Luotettavampi synkronointi
Blockstudio havaitsee nyt muutokset sivulähteissä, kokoelmamanifesteissa, lataajatiedostoissa, asettelutiedostoissa, metatiedoissa ja niihin liittyvissä poluissa. Jos jokin näistä muuttuu, synkronoitu WordPress-sivu päivitetään.
Sivujen käsittelyputki kattaa myös yksityiskohdat, jotka tekevät tiedostopohjaisista dokumenteista käytännöllisiä oikeissa projekteissa:
- Markdown-sivulähteet synkronoidaan natiiviksi lohkosisällöksi lohkoattribuutit mukaan lukien
- Etumetadatan metatiedot ovat käyttöliittymän apufunktioiden ja asettelujen käytettävissä
- Kokoelman sivujen tunnisteet säilyvät vakaina synkronointien välillä
- Sisäkkäiset kokoelmiin kuulumattomat sivut linkitetään yläsivuunsa
- Sisäkkäiset kokoelmiin kuulumattomat sivut voivat periä lähimmän esi-isänsä
layout.php-arvon - Poistetut kokoelman lähteet poistavat luomansa WordPress-sivut
- Kokoelman vaihtaminen tilasta
pagemukautetuksi sisältötyypiksi siirtää nykyiset synkronoidut artikkelit uusina kaksoiskappaleiden luomisen sijaan - Sivujen järjestys tallennetaan kohteeseen
menu_order
Lohkotunnisteiden etuliitteet
Lohkotunnisteet tukevat nyt määritettäviä nimiavaruuksien etuliitteitä. Projektiin voi rekisteröidä yhden lyhyen etuliitteen, jolloin Blockstudio ratkaisee lohkon yhdessä tai useammassa nimiavaruudessa:
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
$prefixes['theme'] = ['theme-components', 'bsui'];
return $prefixes;
});
Kun tämä on määritetty, <theme-card> voidaan ratkaista muotoon theme-components/card, <theme-button> voi käyttää varalla arvoa bsui/button ja <theme-ui-feature-matrix> voidaan ratkaista muotoon theme-components/ui-feature-matrix.
Täsmälliset tag_aliases-määritykset ovat yhä etusijalla, kun projekti tarvitsee yksittäisen ohituksen. Tuntemattomat etuliitetunnisteet jätetään ennalleen, ja olemassa olevat lohkotunnisteiden sallimis- ja estosuodattimet koskevat edelleen etuliitteen perusteella ratkaistuja lohkoja.
Lue lohkotunnisteiden dokumentaatio
Ajonaikaiset ja muokkaimen korjaukset
Versio 7.4 sisältää myös joukon tosielämän projektikäytössä havaittuihin ongelmiin perustuvia korjauksia.
- Dynaamisesti kyselyllä täytettävät valinnat pysyvät ajan tasalla, kun artikkelit, termit, käyttäjät tai niihin liittyvät metatiedot muuttuvat, ja
populate.fetch: true-kyselyvalitsimet hakevat ajantasaiset valinnat, kun muokkaimen haku on tyhjä. - Ohjelmalliset
core/query– jacore/comments-lohkotunnisteet säilyttävätclassName-arvon luodussa kääremerkinnässä. - Pohjien pseudokomponentit säilyttävät camelCase-propit, joten propit kuten
allowedFormatsjawithoutInteractiveFormattingvälittyvät muokkaimen komponentille sen sijaan, että ne pudotettaisiin aiemmin. bsui/selectkäsittelee valintatietoja ja ylivuotavia valikoita luotettavammin, etenkin tiiviimmissä muokkaimen ohjaimissa.blockstudio/phpstantunnistaa kentät, jotka on määritetty kohteentabssäilöissä, joten pohjien, Twig/Blade-määritysten ja lohkotunnisteiden validointi tunnistaa saman kenttärakenteen, jota Blockstudio käyttää projekteissa.- Toistimen rivin poistaminen RichTextin kanssa säilyy tallennuksen jälkeen. Vanhentuneet RichText-arvot eivät enää voi palauttaa poistettua riviä.
Miksi tämä julkaisu on tärkeä
Version 7.4 pääteema on siirrettävyys.
Sivukokoelmat muuttavat kokonaiset dokumentaatiosivustot lähdetiedostokansioiksi. Markdown-sivujen ansiosta sisältöä on helppo kirjoittaa ja lukea tiedostoista. Content Sync laajentaa saman tiedostokeskeisen mallin valikoituun tietokantasisältöön, joten artikkelit, termit ja suhteet voivat sijaita paikassa git ja siirtyä ympäristöjen välillä. Lohkotunnisteiden etuliitteet pitävät suuret lohkokirjastot selkeinä malleissa.
Blockstudio perustuu yhä tiedostoihin. Lohkot ovat edelleen kansioita. Sivut ovat edelleen tiedostoja. Versio 7.4 tuo vain useamman osan projektista, kuten sivurakenteet ja kuratoidun sisällön, tiedostoihin ja mahdollistaa niiden siirrettävyyden.