Siirry sisältöön

Dennis · 14. lokakuuta 2026

Blockstudio 7.7

Blockstudio 7.7 lisää virtuaaliset reitit dokumenteille ilman WordPress-julkaisua, parantaa kohdennettuja esirenderöintikoosteita ja tekee olemassa olevien lohkojen muokkauksesta ja renderöinnistä luotettavampaa. Lisäksi se laajentaa kohteen PHPStan lohkotunnisteiden tarkistuksia ja parantaa saavutettavuutta mukana toimitetuissa UI-komponenteissa.

Tiedostolähtöinen työnkulku pysyy ennallaan. Lohkot renderöidään malleistaan, ja tiedostopohjaiset sivut muuttuvat vain nimenomaisen kohteen CLI tai API-synkronoinnin kautta. Tämä julkaisu ei lisää automaattista sivujen synkronointia kävijä- tai ylläpitopyyntöjen yhteydessä.

Lyhyesti:

  • Virtuaaliset reitit: tarjoa komponenttigalleria, luettelo tai muu kokonainen dokumentti luomatta julkaisua tai kirjoittamatta mukautettua uudelleenohjauksen käsittelijää.
  • Kohdennetut esirenderöintikoosteet: kohteella HTTP tehdyt koosteet tallentavat kunkin sivun käyttämät lähdetiedostot, jotta seuraavassa koostossa voidaan renderöidä vain muuttuneet reitit.
  • Välimuistin säilytys: pidä käytöstä poistuneet tyylitiedostot saatavilla välimuistissa oleville sivuille ja tarkastele tai siivoa käyttämättömiä varhaisen tarjoilun kartan tietueita.
  • Editorin luotettavuus: useita valittuja lohkoja voi muokata niiden omia arvoja; RichTextin ja sivupalkkikenttien kumoa- ja tee uudelleen -toiminnot toimivat, ja peritty konteksti pysyy oikealla lohkolla.
  • Tiedostosisällön tarkkuus: sisäkkäiset luettelot, osioelementit, upotettu HTML, lyhytkoodit ja escapetut attribuutit säilyvät jäsennyksessä ja renderöinnissä.
  • PHPStan-parannukset: etuliitetunnisteet, aliakset, kartoitetut sivuelementit ja mallimuuttujat tarkistetaan projektin omia määrityksiä vasten.
  • Saavutettavat UI-komponentit: ohjausobjektit ilmoittavat tilansa oikein, tunnisteet vaihtavat oikeaa syötekenttää, ja luettelo- ja taulukkoelementeissä on kelvollinen HTML-rakenne.
  • Käännökset: asennetut JavaScript-käännökset latautuvat editorissa ja ylläpidon yleisnäkymässä, myös aiemmin kääntämättömille kenttäohjaimille.

Virtuaaliset reitit

Jotkin sivut saadaan datasta editorin hallitseman julkaisun sijaan. Esimerkiksi komponenttiviite voi tarvita oman kohteensa URL ja dokumentin otsikon, mutta ei merkintää kohteessa wp_posts.

Rekisteröi dokumentti kohteella Blockstudio\Virtual_Routes:

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

Reitti tarjoaa kohteen /components/. Sen takaisinsoitto suoritetaan kohteen Blockstudio tulospuskurissa, joten renderöidyt lohkot saavat tyylinsä, skriptinsä, mukana toimitetut UI-resurssit ja Tailwind-tulosteen normaalin käsittelyketjun kautta. WordPress ei muuta osumaa saanutta reittiä kohteeksi 404 eikä uudelleenohjaa sitä julkaisuun.

URL-perhettä varten aseta prefix arvoon true ja anna match-takaisinsoitto. Takaisinsoitto saa reitin jälkeisen polun ja palauttaa arvon, jota renderöijäsi tarvitsee. Palauttamalla null tai false pyyntö jätetään kohteen WordPress käsiteltäväksi. Käytä kohdetta urls luetellaksesi polut, jotka staattisen esirenderöinnin koosteen tulee sisällyttää. Yksittäinen reitti, joka ei ole etuliitereitti, sisällyttää oletuksena oman polkunsa.

Virtual_Routes::urls() palauttaa absoluuttiset URL-osoitteet integraatioille, jotka kokoavat sivukarttaa. Se ei lisää virtuaalisia dokumentteja automaattisesti kohteen WordPress julkaisusivukarttaan.

Katso Virtuaaliset reitit saadaksesi täydelliset API ja valinnat.

Tarkemmat esirenderöintikoosteet

HTTP-kohteessa grafiikkatilassa tehdyt koosteet tallentavat nyt kunkin reitin käyttämät tiedostot: WordPress-mallin, renderöidyt lohkomallit ja resurssit, tiedostosivujen määritykset ja asettelut sekä kohteen blockstudio/render/dependencies kautta lisätyt riippuvuudet.

Seuraavassa koostossa build_plan() vertaa näitä riippuvuuksia. Lohkomallin muuttaminen merkitsee siitä riippuvat reitit renderöitäviksi ilman kaikkien muiden sivujen uudelleenkoostamista. Jaetun määrityksen muutokset vaikuttavat edelleen koko koosteen laajuudelta, ja uudet tai vanhentuneet reitit renderöidään kuten ennenkin.

Vain tietokannassa tehdyt muutokset eivät ole tiedostoriippuvuuksia. Käyttöönoton, jonka on saatava käyttöön asetus, julkaisu tai muu tietokanta-arvo, on pakotettava kooste tai renderöitävä kyseiset URL-osoitteet erikseen.

Julkaisu korjaa myös koosteen identiteetin muuttumisen ensimmäisen renderöinnin aikana, vanhentuneet opkoodivälimuistissa olevat varhaisen tarjoilun kartat sekä kelvollisten URL-osoitteiden poissulkemisen vain siksi, että niiden polussa on search tai preview. Kohteen Markdown pyynnöt, joissa käytetään kohdetta Accept: text/markdown, ohittavat välimuistissa olevan kohteen HTML, ja asiaankuuluvissa vastauksissa lähetetään Vary: Accept.

Staattinen esirenderöinti huomioi nyt aktiivisen teeman rekisteröimät suodattimet päättäessään, liittääkö se koukkunsa. Teema voi poistaa ominaisuuden käytöstä ilman, että aiempi asetushaku jättää sen aktiiviseksi.

Katso Staattinen esirenderöinti.

Välimuistin säilytys ja ylläpito

Välimuistissa oleva HTML-sivu voi säilyä pidempään kuin ajonaikainen identiteetti, jolla sen tyylitiedosto käännettiin. cache.namespaceGrace määrittää, kuinka kauan käytöstä poistetut nimiavaruudet pysyvät saatavilla sen jälkeen, kun siivous havaitsee niiden poistumisen:

JSON
{
  "cache": {
    "namespaceGrace": 777600
  }
}

Tämä esimerkki säilyttää käytöstä poistetut tiedostot yhdeksän päivän ajan. Oletus on yksi päivä. Aktiiviset nimiavaruudet ja käyttöönotettuja esirenderöintitiedostoja palvelevat nimiavaruudet suojataan siivoukselta.

Varhaisen tarjoilun kartalle on myös tarkistus- ja siivouskomennot:

Shell
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune

Komennot raportoivat ja poistavat poistettujen sivustojen tai puuttuvien hakemistojen tietueet. Monisivustoasennuksen sivuston poistaminen poistaa myös sen tietueet. Puuttuvat reittidokumentit raportoidaan erikseen, jotta koko kelvollista sivustotietuetta ei poisteta.

Katso Välimuisti säilytysohjeita varten ja kartan ylläpito saadaksesi komennot.

Luotettavampi editori

Useita valittuja lohkoja muokattaessa päivittyy nyt vain kyseinen lohko. Tallennus säilyttää kunkin lohkon oman sisällön, avaimet, metatiedot ja lukitukset sen sijaan, että attribuutteja kopioitaisiin valittujen lohkojen välillä.

RichText-arvot sijaitsevat suoraan lohkoattribuuteissa, joten kohde Gutenberg voi sisällyttää ne kumoamis- ja uudelleen tekemistoimintoihin. Sivupalkin kentät käyttävät samaa historiaa. InnerBlocks templateLock="false" välitetään todellisena totuusarvona, ja se avaa sisällön muokattavaksi, vaikka ulompi alue olisi lukittu.

Alkulatauksille annetaan muokattavan julkaisun tunnus ja tyyppi, jotta mallit voivat lukea oikeat metatiedot jo ensimmäisellä renderöinnillä. Eri ylälohkojen alla olevilla samanlaisilla alilohkoilla on erillinen peritty konteksti alkulatauksissa ja renderöintivälimuisteissa. Attribuutti- tai kontekstimuutokset alkupyynnön aikana eivät enää jätä esikatselua jälkeen.

Blockstudio estää myös piilotettujen renderöinnin merkkielementtien lisäämisen lohkojuurten väliin. Vierekkäisten sisarusten valitsimet, kuten .card + .card, näkevät nyt editorissa samat elementtisuhteet kuin käyttöliittymässä, ja editorin sekä lisäystyökalun esikatselurenderöinnit pysyvät erillisinä.

Turvallisempi sivustonlaajuisten asetusten tallennus

Asetuksiin perustuvat kentät tarjoavat edelleen sivustonlaajuisia arvoja, mutta julkaisun tallennus ei enää kirjoita sokeasti kaikkia tallennettuja kopioita näistä kentistä:

  • Luonnos-, odottava-, yksityinen- ja ajastettu tallennus eivät kirjoita sivuston aktiivisia asetuksia.
  • Julkaistut tallennukset kirjoittavat annetut kentät, joita kyseisessä muokkauksessa muutettiin.
  • Pelkkä otsikon tallennus vanhasta kopiosta ei palauta uudempaa sivustonlaajuista arvoa.
  • Puuttuvat kentät ja poistetut lohkot eivät poista olemassa olevia asetuksia.
  • Nimenomainen null poistaa asetuksen. Tyhjät merkkijonot, false, nolla ja tyhjät taulukot ovat kelvollisia arvoja.

Tämä on tärkein päivityksen yhteydessä tarkistettava toimintamuutos. Jos integraatio käytti yksityistä tai luonnosjulkaisua aktiivisen asetuksen päivittämiseen, kirjoita asetus nimenomaisesti tai käytä sen sijaan julkaistua määritysjulkaisua. Julkaisumetatietojen tallennukseen julkaisurajoitus ei vaikuta.

Katso Tallennus saadaksesi kaikki tallennussäännöt.

Tiedostosisältö säilyy ehjänä

HTML-lohkoputki säilyttää enemmän kirjoittamastasi rakenteesta:

  • Sisäkkäisistä luetteloista tulee yläkohtansa sisäisiä luettelolohkoja. Luettelon ja kohdan luokat säilyvät; tavalliset litteät luettelot tuottavat entisen tulosteensa.
  • Kohteista main, header, footer, article ja aside tulee ryhmälohkoja, jotka säilyttävät elementtinsä sen sijaan, että ne olisivat raakaa kohdetta HTML, joka ohittaa lohkorenderöinnin.
  • Kartoitetut richtext-kappaleet säilyttävät upotetun merkinnän, vain kuvan sisältävät kappaleet ratkeavat kartoitetuksi kuvalohkoksi ja lyhytkooditunnisteet säilyttävät sisältönsä.
  • Escapetut attribuutit puretaan ja escapetetaan kerran, myös kohteiden InnerBlocks, RichText ja elementin useBlockProps attribuutit.
  • Lainausmerkkien sisällä olevien itsestään sulkeutuvien tunnisteiden suurempi kuin -merkit hyväksytään.
  • Globaalit HTML-attribuutit päätyvät kohteen Blockstudio juureen, jos lohko ei määritä niitä kentiksi. wp bs pages sync raportoi tallennetut attribuutit, joita ei renderöidä.

Blade-pohjaiset sivut, kuviot ja Sivustoeditorin mallit renderöidään nyt kohteen Blockstudio\Blade_Renderer kautta, joka tukee versioita illuminate/view 8–12. Kaikki samaan lohkoon kohdistuvat laajennustiedostot rekisteröidään, ja niiden prioriteetti, ryhmäkentät ja kohdelistat noudattavat dokumentoitua skeemaa.

Sisäkkäisiä kohteen SCSS riippuvuuksia seurataan myös. Toisen osatiedoston tuoman osatiedoston muokkaaminen muuttaa riippuvan tyylitiedoston versiota ja käynnistää uudelleenkäännöksen.

Kohteen PHPStan parannukset

Erikseen asennettava paketti blockstudio/phpstan laajentaa lohkotunnisteiden validoinnin etuliite- ja aliastunnisteisiin, kartoitettuihin sivuelementteihin, asetteluihin, mukana toimitettuihin UI-lohkoihin ja valinnaisesti muihin projektin PHP-lähteisiin. Nimiavaruuksien selvitys vastaa ajonaikaista toimintaa, myös yhdysmerkkejä sisältävien nimiavaruuksien osalta, ja välitetyt globaalit HTML-attribuutit hyväksytään.

Lohkomallien muuttujien, kuten $a, $block ja $context, katsotaan olevan kohteen Blockstudio määrittelemiä. Kenttätyypit säilyvät null-yhdistämisen ja kohteen isset() yhteydessä, kun käytössä on PHPStan 2.3, mutta malli, joka määrittää oman kohteen $a, säilyttää itse asettamansa tyypin.

Nämä muutokset julkaistaan kohteessa blockstudio/phpstan 0.1.9. Päivitä paketti erikseen lisäosasta; se edellyttää versiota PHPStan 2.1.47 tai uudempaa:

Shell
composer require --dev blockstudio/phpstan:^0.1.9

Katso PHPStan saadaksesi määritykset ja analyysin esiasetukset.

Saavutettavuus ja käännökset

Mukana toimitettujen UI-kytkinten laajennustila ilmoitetaan varsinaisessa painikkeessa. Valintaruutujen, kytkinten ja radiopainikkeiden tunnisteet nimeävät ohjausobjektinsa ja vaihtavat niiden tilaa. Murupolut, sivutus, navigointivalikot ja taulukot eivät enää lisää kelpaamattomia ympäröiviä elementtejä listojen tai taulukoiden ja niiden lasten väliin.

Salasanan näyttökytkimet ilmoittavat painetun tilansa, ja niiden napsautusalue on suurempi. Syötteet hyväksyvät arvon autocomplete, ja salasanasyötteille voi antaa tunnuksen ja saavutettavan nimen. Karusellien näkymäalueet voi kohdistaa näppäimistöllä, ja latauskuvakkeiden sekä luurankojen animaatiot noudattavat vähennetyn liikkeen asetuksia.

Editorissa ja ylläpidon yleisnäkymässä ladataan asennetut JavaScript-käännökset kohteen blockstudio tekstialueelle. Attribuuttivalikot ja paikkamerkit, koodin ponnahdusikkunan toiminnot sekä kuva- ja tiedostomerkit voi nyt kääntää. Merkkijonot, joille ei ole käännöstä, näkyvät englanniksi.

Katso UI-kirjasto ja käännösten asetukset.

Dokumentaatio ja päivittäminen

Dokumentaatio sisältää nyt oppaita dokumentaatiosivustoista, Content Syncistä, Site Editor -malleista, lohkotunnisteista, saarista, mukautetuista kenttätyypeistä, käyttöönotosta, esirenderöinnistä, rekisterin määrityksestä, analyysityökaluista ja UI sovellusnäkymistä. ACF-siirto-opas vastaa nykyisiä ACF-rekisteröintiä ja Block Bindings -toimintoa.

Mukautetun täytön esimerkeissä käytetään nyt tuettua suodatinta, joka ottaa yhden nimetyn datasetin argumentiksi. Resurssidokumentaatiossa kerrotaan käyttöliittymän tyylitiedostojen järjestyksestä ja siitä, miten teeman ohitukset ladataan lohkon CSS jälkeen. Kehittäjien asennuksissa käytetään julkista Font Awesome -pakettia ilman rekisterin tunnuksia.

PHP 8.2 ja WordPress 6.7 ovat edelleen vähimmäisvaatimukset. Virtuaaliset reitit ja uudet ylläpitokomennot ovat käytettävissä muuttamatta nykyisiä sivukokoelmia. Tarkista yllä kuvatut asetusten tallennussäännöt, päivitä erillinen PHPStan-paketti, jos käytät sitä, ja jatka sivujen synkronoinnin käynnistämistä erikseen kuten ennenkin.

7.7.1 Seuranta

7.7.1-korjauspäivitys tekee synkronoinnin tuloksista selkeämpiä ja turvallisempia. Avaimilla tehtävä yhdistäminen, joka ei muuta artikkelia, ei enää luo revisiota eikä päivitä sen muokkausaikaleimaa. Nykyiset julkaisutilat säilytetään, tiedoston omistamien otsikko- ja polkutunnuskorvausten tiedot ilmoitetaan ja lukitut tai poistetut sivut mainitaan CLI-raportissa. Sisällön synkronointi merkitsee sivun synkronoinnin omistamat rungot ja säilyttää nykyiset tarkistuskopiot. Korjauspäivitys suojaa myös WordPress-omistamat attribuutit ristiriitaisilta kenttätunnuksilta ja säilyttää muiden suodattimien lisäämät editoriluokat.