Dennis · 27. heinäkuuta 2026
Blockstudio 7.6
Blockstudio 7.6 tekee projektista luettavan ja renderöitävän kohteesta PHP sekä siirtää tuotannon käyttöliittymän oletukset kohteeseen blockstudio.json: resurssiluettelo API, itsenäinen renderöinti, median ja Tailwind malliapurit, suorituskykyprofiilit, yksi välimuistihakemisto, staattinen esirenderöinti varhaisella tarjoilulla, tiukemmat analyysimääritykset ja koodausagenttien projektityökalujen luonti.
Kaksi kutsua kattaa suurimman osan julkaisusta. Canvas::inventory() palauttaa jokaisen projektin rekisteröimän sivun, lohkon, kuvion, Site Editor -mallin, malliosan ja paketoidun UI-esimerkin. Render::document() palauttaa niistä minkä tahansa valmiina HTML-sisältönä sekä täsmälleen renderöinnissä käytetyt resurssit.
7.6.2-päivitys: Tiedostopohjaisia sivuja ei enää täsmäytetä tavallisten WordPress-pyyntöjen aikana. Suorita
wp bs pages synctai kutsu funktiotaBlockstudio\Pages::reconcile()lähdemuutoksia käyttöön otettaessa. Kokoelmien reititys jatemplateFor-oletukset käyttävät tallennettua ajonaikaisen ympäristön määritystä, ja nimenomainen täsmäytys välttää aiemman suuren monikielisen OR-meta-kyselyn. LyhytikäinenthemeDefaults.syncPagesInDevelopment-asetus on poistettu, koska sivujen synkronointia ei enää tehdä pyyntökoukkujen kautta.Pages::init()toimii nyt vain käynnistyksessä; integraatioiden, jotka välittivätforce-arvon, on käytettävä toimintoaPages::reconcile()tai CLI-arvoa. Canvasin avaaminen suorittaa yhä yhden todennetun, nimenomaisen täsmäytyksen sisällönmuokkauksen luetteloa varten.
7.6.12-päivitys: Editorin tyylitiedostot saavat nyt etuliitteet yhdellä uudelleenkirjoituskierroksella sen sijaan, että jokainen resurssi käännettäisiin erikseen SASSilla. Näin editorin kylmä koonti sivustolla, jolla on paljon lohkoja, ei enää vaaranna vaatimattoman muistirajan ylittymistä. Välimuistissa oleva esirenderöity sivu, jonka sisältötiivisteellä nimetty Tailwind tyylitiedosto on poistettu välimuistista, renderöidään uudelleen tyylittömänä tarjoamisen sijaan sekä PHP-välimuistin että Early Serve -lisäosan kautta. Ylätasolle kirjoitetut lohkoattribuutit luetaan renderöinnin yhteydessä sen sijaan, että ne hylättäisiin, joten skeeman Blockstudio rekisteröinti kohteessa
WP_Block_Typehuomioidaan ohjelmallisissa kirjoittajissa.
7.6.11-päivitys: Kaaviomallin artefaktien asennus korvaa nyt reitin dokumentin atomisesti, kun tallennuskopion sisältö on muuttunut saman avaimen alla. Identtiset dokumentit jätetään ennalleen, ja ylennetyt, korvatut, ohitetut sekä säilytetyt reitit ilmoitetaan
Static_Prerender_Early_Serve::last_promotion()-kohteen kautta.
7.6.10-päivitys: Ajonaikaisen välimuistin osumat tunnistavat nyt poistetut käännetyt resurssit myös tarkkailun viiveen aikana, ja versiota 7.6 vanhemmat litteät ajonaikaiset välimuistit siirretään atomisesti karanteeniin ja poistetaan rajatuissa cron-erissä. Mukana toimitetut UI-yleismuuttujat tulostetaan kerran sivua kohden. Kaaviomallin Early Serve voi tarjota käytössä renderöityjä reittejä, jotka eivät ole käyttöönotettujen reittien kartassa, identiteettivälimuistista. Tailwind voi halutessaan tulostaa sisältötiivisteellä nimetyn välimuistitiedostonsa käyttäen
tailwind.output: "link"; oletuksena tuloste lisätään sivun sisään.
Lyhyesti:
- Projektin luettelo:
Canvas::inventory()palauttaa kaikki rekisteröidyt tietueet lähteineen ja vakaassa näyttöjärjestyksessä. - Kohdennettu valinta: Lohkojen ja sivujen nimeäminen rajaa etsinnän, synkronoinnin, renderöinnin ja kääntämisen kyseisiin tietueisiin.
- Itsenäinen renderöinti:
Blockstudio\Renderpalauttaa valmiin HTML-sisällön lohkolle, koostumukselle tai kokonaiselle dokumentille. - UI-komponenttiperheet:
Blockstudio\Uiryhmittelee mukana toimitetun kirjaston niin, että kustakin komponentista on yksi julkinen perhe ja esimerkki. - Vakaat kuvamitat:
bs_media_image()renderöi teeman resurssit todellisine mittoineen, jotka saadaan luodustaassets/media.json-tiedostosta. - Tailwind-luokka-apurit:
bs_tw_merge()jabs_tw_variants()koostavat luokkia kohteessa PHP ristiriidat huomioiden. - Suorituskykyprofiilit:
performance.profileottaa tuotantokäyttöön tarkoitetut käyttöliittymän oletukset käyttöön kerralla; aliavainten arvot ohittavat ne. - Tyypitettyjen asetusten käyttö:
Settings::get_bool()ja sen sisarukset lukevatblockstudio.json-sisällön oikeilla tyypeillä ja tuovat jäsennysvirheet esiin. - Yksi välimuistihakemisto: Kaikki luodut tiedostot tallennetaan kohteeseen
cache.pathajonaikaisen identiteetin mukaan. - Staattinen esirenderöinti: Anonyymi HTML voidaan tallentaa välimuistiin, mitätöidä riippuvuuskaavion kautta ja tarjota ennen kuin WordPress käynnistyy.
- Analyysin esiasetukset:
theme,extreme-themejawordpress-renderlaajentavat kohteenblockstudio/phpstanlohkomallien ulkopuolelle. - Hallittu commit-koukku:
blockstudio-githooks synckirjoittaa ja hallinnoi pre-commit-koukkua, joka suorittaa määritetyn esiasetuksen. - Projektisopimus:
blockstudio-agentskirjoittaaAGENTS.md-tiedoston, joka kuvaa projektin tekijöille, mitä projektissa luodaan, mitkä ominaisuudet ovat käytössä ja mitä esiasetus valvoo. - Dokumentaation hakemisto: Tekoälyn kontekstitiedosto on nyt hakemisto kaikista dokumenteista, niiden tarkoituksista ja niiden omistamista tunnisteista.
- Lohkojen kanoniset tunnisteet: Itsenäinen komento muuntaa etuliite- ja aliastunnukset muotoon
<bs:namespace-slug>, ja käytettävissä on myös kuiva ajo. - Yhteensopiva oletuksena: Mikään yllä mainituista ei muuta sivustoa, ennen kuin se nimetään kohteessa
blockstudio.json.
Projektin lukeminen ja renderöinti
Projektin luettelo
Canvas::inventory() palauttaa kaiken, mitä projekti rekisteröi, yhtenä tavallisena taulukkona ilman renderöintiä.
use Blockstudio\Canvas;
$result = Canvas::inventory();
foreach ($result['inventory']['blocks'] as $block) {
echo $block['name'] . "\n";
}
Tietueet ryhmitellään tyypin mukaan: pages, blocks, patterns, templates,
parts ja ui. order määrittää vakaan näyttöjärjestyksen kaikille tyypeille,
sources yhdistää kunkin tietueen sen lähdepolkuihin, ja warnings sekä errors
keräävät ongelmat rakenteisiksi merkinnöiksi.
Lohkotietueet sisältävät id, name, title, source, path, provenance ja valmiin renderöitävän kohteen declaration. Sivutietueissa source säilyy vakaana tunnisteena ja path renderöivänä mallina.
Kohdennettu valinta
Tietueiden nimeäminen rajaa käsiteltävät kohteet sen sijaan, että tuloksia suodatettaisiin jälkikäteen.
$changed = Canvas::inventory([
'blocks' => ['mytheme/hero'],
'pages' => ['about'],
]);
Tämä palauttaa yhden lohkon ja yhden sivun. patterns, templates, parts ja ui
palautuvat tyhjinä, eikä niiden lähteitä lueta, synkronoida, renderöidä tai
käännetä.
Säännöt ovat täsmälliset:
- Jos tyyppiavaimia ei ole lainkaan, ladataan kaikki tyypit.
true,nulltai"*"lataa kaikki kyseisen tyypin tietueet.- Merkkijono tai luettelo vastaa täsmälleen tunnistetta, nimeä, polkutunnusta, polkua tai lähdepolkua.
- Tyhjä merkkijono, tyhjä luettelo tai
falselataa kyseisestä tyypistä ei mitään. - Kun jokin tyyppiavain on annettu, pois jätetyt tyypit jäävät koskemattomiksi.
Tunnisteet, joita ei enää ole, palautetaan kohteessa deleted virheen sijaan,
ja Canvasin REST-päivityspäätepiste noudattaa samaa sääntöä parametreilleen
blocks ja pages.
Canvas::documents() ottaa vastaan saman valinnan ja lisää kullekin tietueelle yhden renderöidyn dokumentin. Valitut sivut renderöidään palautetussa käyttöliittymäkontekstissa, joten kyselyehdot, body-luokat, lyhytkoodit, asettelut, uudelleenohjaukset ja resurssien latauskutsut käsittelevät kyseistä sivua sen pyynnön sijaan, joka sitä pyysi.
Itsenäinen renderöinti
Blockstudio\Render palauttaa renderöidyn HTML-sisällön merkkijonona samaa putkea käyttäen kuin käyttöliittymä.
use Blockstudio\Render;
$html = Render::composition([
'root' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
'layers' => [
['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
],
]);
Taustalla on yksi määritysmuoto, jossa on neljä avainta: name, attributes,
content ja children. root, data, inner, innerBlocks, layers ja
example ovat syötteen käyttöä helpottavia oikoteitä, jotka Render::normalize() yhdistää siihen.
Alielementit renderöidään rekursiivisesti, ja virheellinen syöte aiheuttaa poikkeuksen, jossa mainitaan ongelmallinen lohko.
Render::document() käärii tulosteen täydelliseen itsenäiseen HTML-dokumenttiin.
$document = Render::document('mytheme/hero', [
'title' => 'Hero preview',
]);
echo $document['html'];
body on pelkkä lohkon tuloste, html koottu dokumentti, blocks
lohkojen nimet, jotka vaikuttivat tulokseen, ja assets jakaa merkinnät osiin:
head, footer, styles, scripts, modules, interactivity, ui ja tailwind.
Resurssit rajataan renderöityyn sisältöön, joten pelkän editorin resurssit eivät näy.
Render::document_from_html() käärii muualla renderöidyn kohteen HTML, ja
Render::content() renderöi sarjoitetun lohkosisällön ilman dokumenttia. Kutsu
Blockstudio\Batch_Render::reset() dokumenttien välillä saman PHP-prosessin aikana;
Canvas::documents() tekee sen jo.
UI-komponenttiperheet
Blockstudio\Ui tarjoaa mukana toimitetun UI-kirjaston siten, että kustakin julkisesta komponentista on yksi merkintä sisäisten osien luettelon sijaan.
Ui::inventory() palauttaa kustakin perheestä yhden merkinnän, jossa on sen juurilohko, otsikko ja tarvittavat toteutuslohkot. Ui::examples() lisää kuhunkin perheeseen deterministisen määrityksen: oletusarvot säilytetään, pakolliset alitasot sisällytetään vanhempiinsa ja tyhjille kentille lisätään vakaat esimerkkitekstit. Määritys on kanoninen, joten sen voi siirtää suoraan kohteeseen Render::document().
Canvas ryhmittelee samalla tavalla. Mukana toimitettu UI näkyy tyypissä ui yhtenä esimerkkinä perhettä kohti, eikä toteutuksen rekisteröintejä näytetä kohteessa blocks.
Perheet on suunniteltu koottaviksi: valitsin avautuu valintaikkunan sisällä ja sen luetteloruutu asettuu käynnistimen päälle, valikot ja yhdistelmäruudut ankkuroidaan kiinteillä näkymäalueen koordinaateilla, jotka säilyvät vieritettäessä, valintaikkunat pinoutuvat ja sulkeutuvat yksi kerrallaan Escape-näppäimellä, ja jokaisessa alatunnisteessa käytetään samaa sulkemispainiketta eri muunnelmilla. Näiden liitoskohtien toimintaa ja niiden toimintaa ylläpitäviä ehtoja käsitellään koostamista käsittelevässä luvussa; /ui/examples näyttää koostetut käyttöliittymät toiminnassa.
Mallien apurit
Vakaat kuvamitat
bs_media_image() renderöi teeman resurssit todellisella leveydellä ja korkeudella sekä varatulla kuvasuhteella, joten mediakirjaston ulkopuoliset kuvat eivät enää siirrä asettelua.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
]);
Tuloste on figure.blockstudio-media, jossa on sisäinen aspect-ratio img-elementin ympärillä; elementissä on todelliset arvot width, height, loading ja decoding. Mitat saadaan luodusta assets/media.json-tiedostosta, jonka Blockstudio\Media_Metadata_Builder kirjoittaa koontivaiheessa tai jonka voi kirjoittaa käsin.
src hyväksyy teemaan suhteutetun polun, absoluuttisen polun tai täydellisen URL-osoitteen, ja attachmentId kattaa mediakirjaston kuvat. eager poistaa laiskan latauksen käytöstä näkyvän alueen yläpuolella, ja sources tuottaa kohteen <picture>.
Kun performance.media.lazy on käytössä, varsinainen URL siirtyy kohteeseen data-src oikein mitoitetun paikkamerkin taakse.
Tailwind-luokka-apurit
bs_tw_merge() ja bs_tw_variants() kokoavat Tailwind-luokkia kohteen PHP-malleissa käyttäen moottoria Blockstudio, joka toimitetaan jo mukana.
bs_tw_merge('px-2 text-sm', 'px-4') palauttaa arvon text-sm px-4: ristiriitainen
px-2 poistetaan ja myöhemmin annettu arvo voittaa. Sisäkkäiset luokka-arvoja sisältävät taulukot hyväksytään.
bs_tw_variants() palauttaa pienen kutsuttavan funktion komponenttimuunnelmille:
$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']);
Tämä tulostaa inline-flex items-center h-12 px-6 rounded. Perusluokkia,
muunnelmia, oletusmuunnelmia, yhdistelmämuunnelmia ja kutsukohtaista arvoa class tai
className tuetaan.
Tuotantoasetukset
Suorituskykyprofiilit
performance.profile ottaa tuotantokäyttöön tarkoitetut käyttöliittymän oletukset käyttöön yhdessä paikassa.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}
compat on oletusarvo eikä muuta mitään. speed ja strict ottavat käyttöön saman kokonaisuuden: ylätunnisteesta poistetaan generaattori-, emoji-, syöte-, etsintä- ja viereisen artikkelin tiedot; oEmbed-etsintä ja palvelimen komentosarjat poistetaan käytöstä; XML–RPC, pingbackit ja etäeditorin etsintä poistetaan käytöstä; yleiset ydinjärjestelmän käyttöliittymäresurssit poistetaan; kuvien tulosteen oletukset otetaan käyttöön; Heartbeatia rajoitetaan editorien ulkopuolella; saman alkuperän dokumentit esiladataan osoittimen tai kohdistuksen perusteella; ja käytössä on kohteen Blockstudio kuvien lataaja.
Jokainen lapsiarvo ohittaa profiilin, kuten yllä oleva preload.links tekee. Ydinjärjestelmän käyttöliittymäresurssien poistaminen käytöstä kannattaa testata ensin, sillä niistä riippuvainen sivu rikkoutuu näkyvästi. Runtime_Settings::current() näyttää ratkaistun profiilin.
themeDefaults kattaa kaksi asiaa, jotka teemat muuten toteuttaisivat itse: titleTag ja
suppressDirectoryUpdates, joilla aktiivinen alatason teema ja pääteema piilotetaan päivitystuloksista.
Tyypitettyjen asetusten käyttö
Blockstudio\Settings lukee asetukset oikeilla tietotyypeillä sen sijaan, että palauttaisi mitä tahansa, mitä JSON sisälsi.
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);
}
Virheellisestä kohteesta JSON ilmoitetaan kohteen Settings::errors() kautta oletusarvoihin siirtymisen sijaan. Settings::get_raw() palauttaa vain aktiivisen lähteen määrittämät arvot, jolloin arvon asettaminen arvoon false erottuu siitä, ettei arvoa ole koskaan asetettu.
Settings::fingerprint() palauttaa tehokkaiden asetusten vakaan identiteetin, ja käyttö lataa asetukset uudelleen, kun blockstudio.json muuttuu.
Yksi välimuistihakemisto
Kaikki luodut tiedostot tallennetaan nyt kohteen cache.path alle, jonka oletusarvo on wp-content/blockstudio/cache.
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Koontikuormat, lohkojen rekisteröintitiedot, editorin resurssit, käännetyt Tailwind CSS-tiedostot, renderöidyt dokumentit, saarekeosiot, staattiset HTML-tiedostot, kaavioindeksit, lämmitysjono ja diagnostiikkatiedot sijaitsevat kaikki kyseisen juurihakemiston alla. Suhteellinen polku ratkaistaan kohteesta WP_CONTENT_DIR, ja absoluuttinen polku ohjaa sen omaan levyyn.
Objektit tallennetaan ensin nykyisen verkon ja sivuston alle ja sitten ajonaikaisen identiteetin mukaan. Identiteetti on sormenjälki, joka muodostuu versioista Blockstudio, WordPress ja PHP, tehokkaista asetuksista, aktiivisesta teemasta ja lisäosista, etsinnän lähteistä sekä mukana olevista lähdetiedostoista. Kun syöte muuttuu, siihen liittyvistä objekteista luodaan uudet versiot ja vanhat siivotaan pois.
Kylmät koonnit suoritetaan yksi kerrallaan: yksi pyyntö luo ja julkaisee tuloksen atomisesti muiden odottaessa. Epäonnistuneen päivityksen jälkeen viimeisin onnistunut objekti pysyy käytössä virheen ollessa edelleen havaittavissa, ja Blockstudio\Runtime_Cache::purge('tailwind') tyhjentää yhden rajauksen.
Staattinen esirenderöinti
Staattinen esirenderöinti tallentaa täydelliset anonyymit HTML-dokumentit välimuistiin ja voi tarjota ne ennen kuin WordPress käynnistyy. Ominaisuus ei ole oletuksena käytössä.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}
Kelpoisuus
Vain täydelliset anonyymit HTML-dokumentit kelpaavat. Muut kuin GET-pyynnöt, kyselymerkkijonot, ylläpito, REST, Ajax, cron, syötteet, haut, esikatselut, nonce-arvoja sisältävät pyynnöt, yksilöllistävät evästeet ja kaikki kohteen dynamicPaths alla olevat polut ohitetaan.
Vastauksen voi jättää kokonaan pois välimuistista <!-- blockstudio:no-cache -->-merkillä.
Polkujen vertailussa huomioidaan rajat, joten /account kattaa kohteen /account/orders mutta ei kohdetta /accounting.
Allekirjoitus- ja kaaviomallitilat
invalidate määrittää, miten merkinnät vanhenevat. Oletusarvoinen signature-tila tallentaa identiteettiavaimella varustetun vastauksen välimuistiin anonyymin pyynnön osuessa välimuistin ohi ja kierrättää vastauksia sivustotason muutosten jälkeen. Se sopii tavalliselle sivustolle.
graph-tila on tarkoitettu erikseen määritetyille koonti- ja käyttöönottotyökaluille. Se tallentaa kunkin sivun omat lähderiippuvuudet, joten suunnitelmassa rakennetaan uudelleen vain muuttuneiden sivujen URL-osoitteet.
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']));
Varhainen tarjoilu
Kun earlyServe on käytössä, Blockstudio hallinnoi pientä sivustokohtaista reittikarttaa ja advanced-cache.php-lisäosaa, joka lähettää kelvollisen osuman ennen kuin WordPress, lisäosat tai teema käynnistyvät.
Se ei koskaan korvaa muiden omistamaa karttaa, lisäosaa tai WP_CACHE-määrittelyä. Kaavioartefakti vahvistaa jokaisen siihen viitatun HTML-tiedoston ennen kartan vaihtamista, joten keskeneräinen käyttöönotto jättää edellisen kaavion aktiiviseksi. Multisite-merkinnät pysyvät erillään isäntänimen, kotipolun ja sivustotunnuksen perusteella.
Lämmitys ja tila
Kolme WP-CLI-komentoa kattavat päivittäisen käytön:
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
status ilmoittaa aktiivisen identiteetin, tiedosto- ja tavumäärät, kaaviotietueet, jonon tilan sekä osumien, ohitusten, koontien ja virheiden määrät kussakin rajauksessa.
Analyysi- ja agenttityökalut
Analyysin esiasetukset
blockstudio/phpstan saa lohkoanalyysinsä lisäksi kolme tasoa ja yhden komennon, joka suorittaa projektin valitseman tason.
| Esiasetus | Lisäykset |
|---|---|
base |
Aiempi skeema-, malli-, koukku-, asetus- ja API-analyysi. |
theme |
Teemojen juurihakemistot, tyylien otsakkeet, resurssit, valitsinten rajaus, kenttien oletusarvot ja toistimien rajat. |
extreme-theme |
PHPStan max, vaarallinen PHP, escapetus, Tailwind, JavaScript ja Interactivity-tarkistukset. |
wordpress-render |
Kutsujan toimittama reaaliaikainen renderöintitarkistus kohteen extreme-theme lisäksi. |
Oletusarvot tulevat kohteesta blockstudio.json, joten vuorovaikutteiset ajot, CI ja commit-koukut käyttävät samaa määritystä:
{
"phpstan": {
"preset": "theme",
"roots": ["."],
"excludePaths": ["fixtures/**"],
"maxFiles": 10000
}
}
vendor/bin/blockstudio-phpstan --root . -- --no-progress
Paluukoodit ovat 0 onnistumiselle, 1 diagnostiikalle ja 2 virheelliselle käytölle. Kääre kokoaa määrityksensä järjestelmän väliaikaishakemistossa, joten projektiin ei synny määritystiedostoja, lähtötasoja tai välimuisteja, ja se nostaa kohteen PHPStan muistirajan arvoon 1G.
Se sisältää myös BC Math -tarjoajan, joten JavaScript-tarkistukset eivät enää tarvitse kohdetta ext-bcmath.
Hallittu commit-koukku
Yksi asetus ja yksi komento muuttavat määritetyn esiasetuksen commit-portinvartijaksi.
{
"githooks": {
"commit": true
}
}
vendor/bin/blockstudio-githooks sync
Synkronointi kirjoittaa koukun ja omistajuustietueen kohteen Git yhteiseen hakemistoon, ohjaa kohteen core.hooksPath hallittuun hakemistoon ja ketjuttaa aiemmin määritetyn pre-commit-koukun. Koukku ratkaisee repositorion ja projektin juurihakemiston commitin yhteydessä, joten linkitetyt työkopiot ja välilyöntejä sisältävät polut toimivat.
Koukku suorittaa vendor/bin/blockstudio-phpstan eikä mitään muuta; se ei koskaan muotoile tai kirjoita tiedostoja uudelleen. Kun commit asetetaan arvoon false ja synkronoidaan uudelleen tai suoritetaan blockstudio-githooks remove, tallennettu koukkupolku palautetaan ja poistetaan vain tiedostot, jotka ovat kohteen Blockstudio omistuksessa.
Projektisopimus
blockstudio-agents kirjoittaa tiedoston AGENTS.md, jossa määritetään, missä lohkot sijaitsevat, mitä sivu tarkoittaa tässä projektissa, mitkä ominaisuudet ovat käytössä ja mitä analysoija hylkää.
vendor/bin/blockstudio-agents
Dokumentti luodaan projektin perusteella, eikä se ole mallipohja. Teema, jossa on style.css-otsake, lohkoja ja tiedostopohjaisia sivuja, saa erilaisen sopimuksen kuin lisäosa, joka rekisteröi vain lohkoja. Sopimukseen kirjataan etsinnässä löytyneet määrät, hakemistot, nimiavaruudet ja mallikielet. blockstudio.json määrittää, mitkä ominaisuudet otetaan mukaan, joten ilman staattista esirenderöintiä toimivassa projektissa sitä ei mainita.
Oikeellisuutta käsittelevä osio luetaan valitun esiasetuksen omista sääntötiedostoista taso kerrallaan. Kun esiasetukseen lisätään sääntö, se muuttaa kaikkia luotuja sopimuksia.
Omistajuus toimii samalla tavalla kuin commit-koukussa. Tiedostoa, jossa ei ole luontimerkkiä, ei korvata, ellei --force muuta määrää. Lopussa oleva muistiinpanoalue säilyy uudelleenluonnissa, --check palauttaa arvon 1, jos sopimus on vanhentunut, ja --stdout tulostaa sen koskematta tiedostojärjestelmään.
Dokumentaation hakemisto
blockstudio-llm.txt on nyt hakemisto koonnin sijaan. Jokainen julkaistu dokumentti esiintyy kerran omassa osiossaan ja alaosiossaan. Siinä ilmoitetaan dokumentin reitti, lähdetiedosto, tarkoitus yhdellä rivillä ja sen omistamat tunnisteet: asetuspolut, koukkujen nimet, kohteen PHP funktiot ja luokat sekä komennot.
## 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()
Agentti lukee indeksin, löytää sen dokumentin, joka omistaa tarvitsemansa tunnisteen, ja avaa sen. Aiempi puolen megatavun yhdistelmä luodaan ja julkaistaan edelleen kohdassa /blockstudio-llm-full.txt; se ei enää ole ensimmäinen asia, joka kenellekään annetaan.
Kanoniset lohkotunnisteet
Erillinen komento kirjoittaa etuliite- ja aliasshokkeamat kanoniseen <bs:namespace-slug>-muotoon, joka tallentaa todellisen lohkonimen ja toimii ilman ladattua projektisuodatinta.
Kun etuliite brand kuuluu joukkoon theme-components ja etuliite ui joukkoon bsui, tämä lyhennys:
<brand-card>
<ui-input />
</brand-card>
tarkoittaa samaa kuin:
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Etuliitteet ja täsmälliset aliakset toimivat edelleen, eikä niitä ole vanhennettu. Komento ei lataa kohdetta WordPress eikä kirjoita mitään ilman kohdetta --apply:
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 yhdistää kunkin etuliitteen nimiavaruuksiinsa, ja --known-blocks listaa rekisteröidyt lohkonimet. Raportissa ovat vanhojen ja kanonisten muotojen väliset vastaavuudet esiintymismäärineen, tiedostokohtaiset tiivisteet sekä erilliset listat tuntemattomista tunnisteista, monitulkintaisista aliaksista ja dynaamisista tunnisteista. --apply kieltäytyy kirjoittamasta, jos niitä on vielä, ellei anneta valitsinta --allow-unresolved.
Paritetut, sisäkkäiset ja itsestään sulkeutuvat merkinnät käsitellään, myös kirjaimelliset tunnisteet merkkijonoissa PHP. Vain tunnisteiden nimet muuttuvat, toinen suoritus ei tee muutoksia, ja kommenteissa, koodiaidoissa, kohteessa <pre> tai kohteessa <code> olevat esimerkit näkyvät vain raportissa.
Oletustoiminta
Version 7.6 asentaminen ei itsessään muuta mitään.
Suorituskykyprofiilin oletusarvo on compat. Head-tuloste, oEmbed, XML–RPC, Heartbeat, kuvien oletukset, linkkien esilataus, laiska lataus ja käyttöliittymän <title> säilyvät sellaisina kuin WordPress ja teema ne jättivät.
Nämä pysyvät poissa käytöstä, ellei niitä oteta käyttöön: jokainen avain performance.staticPrerender, performance.measurement, performance.media ja themeDefaults sekä githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled ja blockTags.enabled. Staattinen esirenderöinti ei kirjoita tiedostoja eikä asenna lisäosaa, kun se ei ole käytössä.
Canvas ja Render ovat passiivisia. Ne lukevat olemassa olevia rekistereitä ja renderöivät vain sen, mitä kutsuja pyytää; kumpikaan ei kytkeydy käyttöliittymän tulosteeseen eikä rekisteröi reittejä. Canvasin ylläpitonäkymä edellyttää edelleen kohteita dev.canvas.enabled ja edit_posts.
Tiukempi analyysi edellyttää sen nimeämistä. Kohteen blockstudio/phpstan asentaminen ottaa käyttöön vain peruslaajennuksen, ja kanoninen komento suorittaa kohteen base, ellei projektissa nimetä esiasetusta.
Luodut tiedostot edellyttävät vastaavan komennon suorittamista. githooks.commit ei tee mitään ennen kuin blockstudio-githooks sync suoritetaan, eikä AGENTS.md ennen kuin blockstudio-agents suoritetaan.
Päivittäminen versiosta 7.5
Vaatimukset ovat ennallaan: PHP 8.2 tai uudempi, WordPress 6.7 tai uudempi.
composer require blockstudio/blockstudio
Välimuistit rakennetaan uudelleen kerran. Ajon aikainen identiteetti sisältää version Blockstudio, joten ensimmäinen pyyntö päivityksen jälkeen on kylmä ja vanhat objektit siivotaan. Vanhan Tailwind-välimuistin kohteessa wp-content/uploads/blockstudio/tailwind/cache voi poistaa; sen tiedostoja hakevan koodinpätkän pitäisi kutsua sen sijaan kohdetta Blockstudio\Runtime_Cache::purge('tailwind').
Ennen versiota 7.6 käytössä ollut litteä wp-content/blockstudio/cache/runtime-hakemisto nimetään automaattisesti pois aktiivisesta polusta ja poistetaan rajatuissa WP-Cron-ajoissa. Suuria vanhoja lukitustiedostopuita ei siksi tarvitse poistaa käyttöönottopyynnön aikana.
Luoduilla tiedostoilla on omistajansa. assets/media.json kuuluu versionhallintaan tai koontivaiheeseen. Reittikartta, advanced-cache.php-lisäosa ja WP_CACHE-määritys ovat olemassa vain, kun earlyServe on käytössä, ja esikäsittelykoukku vain synkronoinnin aikana. Kaikki muu luotu sisältö sijaitsee kohteen cache.path alla, ja sen voi poistaa turvallisesti.
Mitään ei poistettu eikä nimetty uudelleen. bs_render_block(), bs_block(), Blockstudio\Pages ja Blockstudio\Patterns ovat edelleen kanoniset tiedostopohjaiset sisältöpinnat.
Palautus tehdään ominaisuuskohtaisesti. performance.profile takaisin kohteeseen compat, staticPrerender.enabled kohteeseen false, githooks.commit kohteeseen false ja lisäksi sync sekä cache.enabled kohteeseen false palauttavat kukin yhden kerroksen.
Järkevä käyttöönottojärjestys:
- Aseta
performance.profilearvoksispeedja tarkista sitten head-tuloste, syötteet ja kaikki lisäosat, jotka käyttävät oEmbediä tai kohdetta XML–RPC. - Luo kohde
assets/media.json, siirrä mallit kohteeseenbs_media_image()ja ota sitten käyttöönperformance.media.lazy. - Ota käyttöön
performance.staticPrerenderniin, ettäearlyServeei ole käytössä, tarkista osumat kohteellawp bs prerender statusja ota sittenearlyServekäyttöön. - Suorita kohdetta
blockstudio-phpstan --preset theme, kunnes tulos on puhdas, ennen kuin asetat esiasetuksen kohteengithooks.committaakse.
Mistä lisätiedot löytyvät
- Canvas ja sen luettelo sekä dokumentin API
- Renderöinti, UI-komponentit ja UI-koostaminen
- Asetukset ja suorituskyky
- Suorituskyky, välimuisti ja staattinen esirenderöinti
- Tailwind CSS
- PHPStan: esiasetukset, kanoninen komento, hallittu commit-koukku ja projektisopimus
- AI-integraatio: dokumentaatiohakemisto ja koko teksti
- Migraatio ja PHP-koukut