Liigu sisu juurde

Dennis · 27. juuli 2026

Blockstudio 7.6

Blockstudio 7.6 võimaldab projekti lugeda ja renderdada PHP abil ning viib kasutajaliidese tootmiskeskkonna vaikeväärtused üle blockstudio.json-i: inventar API, eraldiseisev renderdamine, meedia ja Tailwind malliabid, jõudlusprofiilid, üks vahemälukaust, staatiline eeljrenderdus varajase teenindamisega, rangemad analüüsieelistused ja loodud projektitööriistad koodiagentidele.

Suurema osa väljalaskest kannavad kaks kutset. Canvas::inventory() tagastab kõik registreeritud lehed, plokid, mustrid, Site Editori mallid, malliosad ja komplekteeritud UI näited. Render::document() tagastab neist igaühe jaoks valmis HTML koos täpselt nende varadega, mida renderdus kasutas.

7.6.2 uuendus: failipõhiseid lehti ei kooskõlastata enam tavaliste WordPress päringute käigus. Allikamuudatuste rakendamiseks käivitage wp bs pages sync või kutsuge Blockstudio\Pages::reconcile(). Kogumite marsruutimine ja templateFor vaikeväärtused kasutavad salvestatud käitusaja konfiguratsiooni ning selgesõnaline kooskõlastamine väldib varasemat suurt mitmekeelset OR-meta päringut. Lühiajaline suvand themeDefaults.syncPagesInDevelopment on eemaldatud, sest lehti ei sünkroonita enam päringukonksudest. Pages::init() toimib nüüd ainult alglaadimisel; integratsioonid, mis edastasid väärtuse force, peavad kasutama väärtust Pages::reconcile() või CLI. Canvase avamine käivitab endiselt autori inventari jaoks ühe autentitud ja selgesõnalise kooskõlastamise.

7.6.12 uuendus: Redaktori stiilitabelid lisatakse nüüd prefiksiga ühe ümberkirjutamise läbimisega, mitte iga vara eraldi SASS-i kompileerimisega, nii et paljude plokkidega saidi redaktori külmkäivitus ei ohusta enam mõõduka mälupiiri ületamist. Vahemällu salvestatud eeltöödeldud leht, mille sisu räsi sisaldava Tailwind stiilitabel on eemaldatud, renderdatakse uuesti, mitte ei väljastata stiilideta; see toimib nii PHP vahemälu kui ka Early Serve’i drop-in’i kaudu. Tipptasemele kirjutatud plokiatribuute loetakse renderdamisel, mitte ei jäeta kõrvale, seega skeemi Blockstudio registreeringut WP_Block_Type-is arvestatakse programmipõhiste kirjutajate puhul.

7.6.11 uuendus: Graafi artefaktide paigaldamisel asendatakse marsruudi dokument aatomiliselt, kui poe koopia sama võtme all muutus; identsed dokumendid jäetakse puutumata ning edendatud, asendatud, vahele jäetud ja alles hoitud marsruutidest antakse teada Static_Prerender_Early_Serve::last_promotion() kaudu.

7.6.10 uuendus: Käitusaja vahemälupäringud tuvastavad nüüd eemaldatud kompileeritud varad ka jälgimise viiteaja jooksul ning varasemad kui 7.6 lamedad käitusaja vahemälud paigutatakse aatomiliselt karantiini ja kustutatakse piiratud cron partiidena. Komplekteeritud UI globaalsed muutujad väljastatakse lehe kohta üks kord. Graafirežiimi Early Serve saab identiteedivahemälust edastada reaalajas renderdatud marsruute, mis pole juurutatud marsruudikaardil. Tailwind saab soovi korral väljastada sisuräsi sisaldava vahemälufaili koos tailwind.output: "link"-ga; vaikimisi väljastatakse sisu reas.

Lühidalt:

  • Projekti loend: Canvas::inventory() tagastab kõik registreeritud kirjed koos nende allikate ja püsiva kuvamisjärjestusega.
  • Sihitud valik: plokkide ja lehtede nimetamine piirab avastamise, sünkroonimise, renderdamise ja kompileerimise nende kirjetega.
  • Eraldiseisev renderdamine: Blockstudio\Render tagastab valmis HTML-e ploki, kompositsiooni või tervikliku dokumendi jaoks.
  • UI komponendipered: Blockstudio\Ui rühmitab komplekteeritud teegi üheks avalikuks pereks komponendi kohta ja lisab igaühe juurde näite.
  • Püsivad pildimõõtmed: bs_media_image() renderdab teema varad tegelike mõõtmetega, mis pärinevad loodud failist assets/media.json.
  • Tailwind klassiabitööriistad: bs_tw_merge() ja bs_tw_variants() koostavad klassid keeles PHP, liites need konfliktiteadlikult.
  • Jõudlusprofiilid: performance.profile lülitab tootmise kasutajaliidese vaikeväärtused korraga sisse; alamelemendi väärtused kirjutavad profiili omad üle.
  • Tüübistatud seadete juurdepääs: Settings::get_bool() ja selle kaasfunktsioonid loevad blockstudio.json tegelike tüüpidega ning toovad esile parsimisvead.
  • Üks vahemälukataloog: kõik loodud failid asuvad cache.path all ja on seotud käitusaja identiteediga.
  • Staatiline eeltöötlus: anonüümseid HTML saab vahemällu salvestada, sõltuvusgraafi kaudu kehtetuks muuta ning edastada enne WordPress käivitumist.
  • Analüüsi eelseadistused: theme, extreme-theme ja wordpress-render laiendavad blockstudio/phpstan võimalusi plokimallidest kaugemale.
  • Hallatud sissekandekonks: blockstudio-githooks sync loob sissekandmiseelse konksu ja haldab seda; konks käivitab seadistatud eelseadistuse.
  • Projekti leping: blockstudio-agents loob faili AGENTS.md, mis kirjeldab, mida projekti autorid loovad, millised funktsioonid on lubatud ja mida eelseadistus nõuab.
  • Dokumentatsiooni register: tehisintellekti kontekstifail sisaldab nüüd kõigi dokumentide registrit, nende eesmärke ja neile kuuluvaid tunnuseid.
  • Kanoonilised plokisildid: eraldiseisev käsk asendab prefiksi- ja aliasekujud nimega <bs:namespace-slug>; saadaval on ka kuivkäivitus.
  • Ühilduvus vaikimisi: ükski ülaltoodust ei muuda saiti enne, kui see on nimetatud failis blockstudio.json.

Projekti lugemine ja renderdamine

Projekti loend

Canvas::inventory() tagastab lihtsa massiivina kõik, mida projekt registreerib, ilma midagi renderdamata.

PHP
use Blockstudio\Canvas;

$result = Canvas::inventory();

foreach ($result['inventory']['blocks'] as $block) {
    echo $block['name'] . "\n";
}

Kirjed on rühmitatud tüübi järgi: pages, blocks, patterns, templates, parts ja ui. order määrab kõigi tüüpide püsiva kuvamisjärjestuse, sources seostab iga kirje lähtefailide radadega ning warnings ja errors koondavad probleemid struktureeritud kirjeteks.

Plokikirjed sisaldavad id, name, title, source, path, provenance ja valmis renderdamiseks mõeldud declaration-e. Lehekirjete püsivaks tunnuseks jääb source ning renderdavaks malliks path.

Sihitud valik

Kirjete nimetamine piirab tööd, selle asemel et tulemusi hiljem filtreerida.

PHP
$changed = Canvas::inventory([
    'blocks' => ['mytheme/hero'],
    'pages' => ['about'],
]);

See tagastab ühe ploki ja ühe lehe. patterns, templates, parts ja ui tagastatakse tühjana ning nende allikaid ei loeta, sünkroonita, renderdata ega kompileerita.

Reeglid on täpsed:

  • Kui ühtegi tüübi võtit pole, laaditakse kõik tüübid.
  • true, null või "*" laadib kõik seda tüüpi kirjed.
  • String või loend leiab täpse vaste ID, nime, slugi, raja või lähteraja järgi.
  • Tühi string, tühi loend või false ei laadi seda tüüpi kirjeid.
  • Kui olemas on vähemalt üks tüübi võti, jäävad väljajäetud tüübid puutumata.

Tunnused, mida enam ei eksisteeri, tagastatakse vea asemel jaotises deleted, ning Canvas REST värskendusotspunkt rakendab sama reeglit oma parameetritele blocks ja pages.

Canvas::documents() kasutab sama valikut ja lisab iga kirje juurde ühe renderdatud dokumendi. Valitud lehed renderdatakse taastatud kasutajaliidese kontekstis, nii et päringu tingimused, body-klassid, lühikoodid, paigutused, ümbersuunamised ja laadimise tagasikutsed käsitlevad seda lehte, mitte päringut, millega seda küsiti.

Eraldiseisev renderdamine

Blockstudio\Render tagastab renderdatud HTML-e stringina, kasutades sama konveierit nagu kasutajaliides.

PHP
use Blockstudio\Render;

$html = Render::composition([
    'root' => 'mytheme/card',
    'data' => ['heading' => 'Example card'],
    'layers' => [
        ['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
    ],
]);

Aluseks on üks deklaratsiooni kuju nelja võtmega: name, attributes, content ja children. root, data, inner, innerBlocks, layers ja example on mugavad sisendkujud, mille Render::normalize() sellesse koondab. Alamelemendid renderdatakse rekursiivselt ning vigase sisendi korral visatakse viga, milles nimetatakse probleemset plokki.

Render::document() ümbritseb väljundi tervikliku eraldiseisva HTML dokumendiga.

PHP
$document = Render::document('mytheme/hero', [
    'title' => 'Hero preview',
]);

echo $document['html'];

body on ainult ploki väljund, html koostatud dokument, blocks sisendi andnud plokkide nimed ning assets jagab märgenduse osadeks: head, footer, styles, scripts, modules, interactivity, ui ja tailwind. Varad piirduvad renderdatud sisuga, nii et redaktori varasid ei lisata.

Render::document_from_html() ümbritseb mujal renderdatud HTML-e ja Render::content() renderdab serialiseeritud plokisisu ilma dokumendita. Kutsu Blockstudio\Batch_Render::reset() välja ühe PHP protsessi dokumentide vahel; Canvas::documents() teeb seda juba.

UI komponendipered

Blockstudio\Ui esitab komplekteeritud teegi UI ühe kirjena avaliku komponendi kohta, mitte sisemiste osade loendina.

Ui::inventory() tagastab iga pere kohta ühe kirje koos juurploki, pealkirja ja vajalike teostusplokkidega. Ui::examples() lisab iga pere kohta deterministliku deklaratsiooni: vaikeväärtused säilivad, nõutavad alamkihid pesastatakse vanemelemendi alla ning tühjade väljade asemel kasutatakse püsivat näiteteksti. See deklaratsioon on kanooniline ja sobib otse Render::document()-i.

Canvas rühmitab samamoodi. Komplekti UI kuvatakse tüübi ui all ühe näitena pere kohta ning teostuse registreeringuid blocks-is ei kuvata.

Pered on loodud kokkupanekuks: valik avaneb dialoogis ja selle loendikast katab päästiku; menüüd ja liitkastid kinnituvad fikseeritud vaateava koordinaatidele, mis säilivad kerimisel; modaalaknad kuhjuvad ja sulguvad ükshaaval Escape-klahviga; iga jalus ühendab sama sulgemisnupu variandiga. Nende ühenduskohtade toimimist ja seda tagavaid muutumatuid tingimusi käsitleb kompositsiooni peatükk; /ui/examples näitab kompositsioone töötavana.

Malli abitööriistad

Püsivad pildimõõtmed

bs_media_image() renderdab teema varad tegeliku laiuse ja kõrgusega ning reserveeritud kuvasuhtega, nii et väljaspool meediateeki olevad pildid ei nihuta enam paigutust.

PHP
<?php
echo bs_media_image([
    'src' => 'assets/images/hero.webp',
    'alt' => 'Hero',
]);

Väljund on figure.blockstudio-media, mille ümber on reas aspect-ratio ning mille img sisaldab tegelikke väärtusi width, height, loading ja decoding. Mõõtmed pärinevad loodud failist assets/media.json, mille kirjutab ehitussammus Blockstudio\Media_Metadata_Builder või mis luuakse käsitsi.

src võtab teema suhtelise raja, absoluutse raja või täieliku URL-i; meediateegi pilte käsitleb attachmentId. eager lülitab laiska laadimise välja lehe ülaosas ning sources väljastab <picture>.

Kui performance.media.lazy on sisse lülitatud, liigub tegelik URL taustal asukohta data-src ning selle ees on õigete mõõtmetega kohatäide.

Tailwind klassiabitööriistad

bs_tw_merge() ja bs_tw_variants() koostavad klasse mallides Tailwind keeles PHP, kasutades mootorit, mille Blockstudio juba komplekti lisab.

bs_tw_merge('px-2 text-sm', 'px-4') tagastab text-sm px-4: konfliktne px-2 jäetakse välja ja hilisem väärtus jääb kehtima. Toetatud on ka pesastatud klassiväärtuste massiivid.

bs_tw_variants() tagastab komponendivariantide jaoks väikese väljakutsutava funktsiooni:

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

See väljastab inline-flex items-center h-12 px-6 rounded. Toetatud on baasklassid, variandid, vaikevariandid, liitvariandid ning päringupõhine class või className.

Tootmise konfiguratsioon

Jõudlusprofiilid

performance.profile lülitab tootmise kasutajaliidese vaikeväärtused ühest kohast sisse.

JSON
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}

compat on vaikevalik ega muuda midagi. speed ja strict lubavad sisse sama komplekti: generaator, emotikonid, voog, avastamine ja seotud postitused eemaldatakse päisest; oEmbedi avastamine ja hosti skriptid jäetakse välja; XML–RPC, pingbackid ja redaktori kaugavastamine lülitatakse välja; üldised tuuma kasutajaliidese varad eemaldatakse; rakendatakse pildi väljundi vaikeväärtusi; Heartbeat’i piiratakse väljaspool redaktoreid; sama päritoluga dokumendid eellaaditakse hõljutamisel või fookuse kavatsuse korral; ning kasutatakse Blockstudio pildilaadijat.

Iga alamväärtus kirjutab profiili üle, nagu ülal teeb preload.links. Tuuma kasutajaliidese varade eemaldamist tasub esimesena katsetada, sest neist sõltuv leht läheb nähtavalt katki. Runtime_Settings::current() näitab lahendatud profiili.

themeDefaults katab kaks ülesannet, mida teemad muidu käsitsi lahendavad: titleTag ning suppressDirectoryUpdates, et aktiivne alam- ja emateema värskendustulemustest peita.

Tüübistatud seadete juurdepääs

Blockstudio\Settings loeb konfiguratsiooni tegelike tüüpidega, selle asemel et tagastada JSON-is leiduvat suvalist väärtust.

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

Vigast JSON-i kohta antakse teada Settings::errors() kaudu, selle asemel et kasutada vaikeväärtusi. Settings::get_raw() tagastab ainult aktiivse allika deklareeritud väärtused, mis võimaldab eristada väärtuseks määratud false-i väärtusest, mida pole kunagi määratud.

Settings::fingerprint() tagastab tõhusa seadistuse püsiva identiteedi, ja juurdepääs laetakse uuesti, kui blockstudio.json muutub.

Üks vahemälukataloog

Kõik loodud failid asuvad nüüd cache.path all, mille vaikeväärtus on wp-content/blockstudio/cache.

JSON
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}

Ehituse kasulikud andmed, plokkide registreerimisandmed, redaktori varad, kompileeritud Tailwind CSS, renderdamisdokumendid, saarekesefragmendid, staatilised HTML-id, graafide indeksid, soojendamisjärjekorrad ja diagnostika asuvad kõik selle juure all. Suhteline rada lahendatakse alates asukohast WP_CONTENT_DIR; absoluutse rajaga saab määrata eraldi köite.

Objektid talletatakse praeguse võrgu ja saidi alla ning seejärel käitusaja identiteedi järgi: see on sõrmejälg versioonidest Blockstudio, WordPress ja PHP, tõhusatest seadetest, aktiivsest teemast ja pluginatest, avastusallikatest ning kaasatud lähtefailidest. Sisendi muutmisel luuakse mõjutatud objektidest uued versioonid ja vanad kärbitakse.

Külmkäivituse ehitused toimuvad ühe päringu kaupa: üks päring ehitab ja avaldab tulemuse aatomiliselt, teised ootavad. Ebaõnnestunud värskenduse korral edastatakse edasi viimane hea objekt, samal ajal kui tõrge jääb nähtavaks, ning Blockstudio\Runtime_Cache::purge('tailwind') tühjendab ühe ulatuse.

Staatiline eeltöötlus

Staatiline eeltöötlus salvestab vahemällu terviklikud anonüümsed HTML dokumendid ja saab neid edastada enne WordPress käivitumist. Vaikimisi on see välja lülitatud.

JSON
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}

Sobivus

Sobivad ainult terviklikud anonüümsed HTML dokumendid. Vahele jäetakse GET-ist erinevad päringud, päringustringid, halduslehed, REST, Ajax, cron, vood, otsing, eelvaated, nonce’i sisaldavad päringud, isikupärastatud küpsised ja kõik rajad dynamicPaths all. Vastus saab sellest täielikult loobuda markeriga <!-- blockstudio:no-cache -->.

Rajavaste järgib piire, nii et /account hõlmab rada /account/orders, kuid mitte rada /accounting.

Allkirja- ja graafirežiimid

invalidate määrab kirjete aegumise. Vaikimisi kasutatav režiim signature täidab anonüümse vahemälupäringu korral identiteedipõhise vastuse ning vahetab selle saidi tasemel muudatuste järel välja; see sobib tavalisele saidile.

Režiim graph on mõeldud selgesõnaliste ehitus- ja juurutustööriistade jaoks. See salvestab iga lehe enda lähtefailide sõltuvused, nii et plaan koostab uuesti ainult mõjutatud URL-id.

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

Varajane edastamine

Kui earlyServe on sisse lülitatud, haldab Blockstudio väikest saidipõhist marsruudikaarti ja advanced-cache.php drop-in’i, mis edastab sobiva vahemälutulemuse enne kui WordPress, pluginad või teema käivituvad.

See ei kirjuta kunagi üle võõrast kaarti, drop-in’i ega WP_CACHE deklaratsiooni. Graafi artefakt kontrollib kõiki viidatud HTML faile enne kaardi vahetamist, nii et pooleliolev juurutus jätab eelmise graafi aktiivseks. Mitme saidiga keskkonnas eraldatakse kirjed hosti, kodutee ja saidi ID järgi.

Soojendamine ja olek

Igapäevaseks kasutuseks on kolm WP-CLI käsku:

Shell
wp bs prerender warm
wp bs prerender status
wp bs prerender purge

status esitab aktiivse identiteedi, failide ja baitide arvu, graafikirjed, järjekorra oleku ning iga ulatuse tabamuste, möödalaskmiste, ehituste ja tõrgete loendurid.

Analüüs ja agenditööriistad

Analüüsi eelseadistused

blockstudio/phpstan lisab plokianalüüsile kolm tasandit ning ühe käsu, mis käivitab projektis valitud tasandi.

Eelseadistus Lisatav
base Olemasoleva skeemi, mallide, konksude, seadete ja API analüüs.
theme Teema juurkataloogid, stiilipäised, varad, valijate ulatus, välja vaikeväärtused, kordaja piirid.
extreme-theme PHPStan max, ohtlik PHP, paomärgid, Tailwind, JavaScript ja interaktiivsuse kontrollid.
wordpress-render Kutsuja antud reaalajas renderdamise kontroll lisaks tasandile extreme-theme.

Vaikeväärtused pärinevad asukohast blockstudio.json, nii et interaktiivsed käitused, CI ja sissekandekonksud kasutavad sama seadistust:

JSON
{
  "phpstan": {
    "preset": "theme",
    "roots": ["."],
    "excludePaths": ["fixtures/**"],
    "maxFiles": 10000
  }
}
Shell
vendor/bin/blockstudio-phpstan --root . -- --no-progress

Väljumiskoodid on 0 edukal läbimisel, 1 diagnostika korral ja 2 vigase kasutuse puhul. Ümbris koostab konfiguratsiooni süsteemi ajutises kataloogis, nii et projekti ei teki loodud konfiguratsiooni, lähtealust ega vahemälu, ning tõstab PHPStan mälupiiri väärtuseni 1G.

Komplektis on ka BC Mathi pakkuja, nii et JavaScript kontrollid ei vaja enam ext-bcmath-i.

Hallatud sissekandekonks

Üks seade ja üks käsk muudavad seadistatud eelseadistuse sissekande eeltingimuseks.

JSON
{
  "githooks": {
    "commit": true
  }
}
Shell
vendor/bin/blockstudio-githooks sync

Sünkroonimine kirjutab konksu ja omandikirje asukohta Git-i ühiskasutatavasse kataloogi, suunab core.hooksPath hallatud kataloogi ning seob sellega varem seadistatud sissekandmiseelse konksu. Konks tuvastab sissekandmise ajal hoidla ja projekti juurkataloogi, nii et seotud väljavõtted ja tühikuid sisaldavad rajad toimivad.

Konks käivitab ainult vendor/bin/blockstudio-phpstan ega tee midagi muud; see ei vorminda ega kirjuta faile ümber. Kui määrate commit väärtuseks false ja sünkroonite uuesti või käivitate blockstudio-githooks remove, taastatakse salvestatud konksu rada ning kustutatakse ainult Blockstudio omandis olevad failid.

Projekti leping

blockstudio-agents loob faili AGENTS.md, mis kirjeldab, kus plokid asuvad, mida leht selles projektis tähendab, millised funktsioonid on lubatud ja mida analüsaator tagasi lükkab.

Shell
vendor/bin/blockstudio-agents

Dokument koostatakse projekti põhjal, seda ei täideta mallist. Päisega style.css teema, plokkide ja failipõhiste lehtede leping erineb ainult plokke registreeriva plugina omast ning sisaldab skanneri leitud arve, katalooge, nimeruume ja mallikeeli. blockstudio.json määrab, millised funktsioonid lepingusse lisatakse, nii et staatilise eeltöötluseta projektis ei mainita seda üldse.

Korrektsuse jaotis loetakse valitud eelseadistuse enda reeglifailidest tasandite kaupa, nii et uue reegli lisamine eelseadistusse muudab kõiki selle põhjal loodavaid lepinguid.

Omandihaldus toimib nagu sissekandekonks. Loodud markerita faili ei asendata, välja arvatud juhul, kui --force määrab teisiti; lõpus olev märkmete jaotis säilib regenereerimisel; --check väljub koodiga 1, kui leping on aegunud; ning --stdout kuvab selle failisüsteemi muutmata.

Dokumentatsiooni register

blockstudio-llm.txt on nüüd register, mitte dokumentide kokkuliitmine. Iga avaldatud dokument esineb oma jaotises ja alajaotises ühe korra ning sisaldab marsruuti, lähtefaili, üherealist eesmärki ja talle kuuluvaid tunnuseid: seadete radu, konksude nimesid, PHP funktsioone ja klasse ning käske.

Text
## 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()

Agent loeb indeksit, leiab dokumendi, millele kuulub teda huvitav tunnus, ja avab selle dokumendi. Varasemat poole megabaidi suurust ühendatud faili luuakse ja avaldatakse endiselt aadressil /blockstudio-llm-full.txt; see ei ole enam esimene asi, mida kellelegi kätte antakse.

Kanoonilised plokisildid

Eraldiseisev käsk asendab eesliite- ja aliase-lühivormid kanoonilise <bs:namespace-slug> kirjapildiga, mis salvestab tegeliku ploki nime ja lahendatakse ka ilma projekti filtrit laadimata.

Kui eesliide brand käib üle theme-components ja eesliide ui üle bsui, tähendab see lühivorm järgmist:

HTML
<brand-card>
  <ui-input />
</brand-card>

tähendab sama mis:

HTML
<bs:theme-components-card>
  <bs:bsui-input />
</bs:theme-components-card>

Eesliited ja täpsed aliased töötavad endiselt ning neid ei ole aegunud kasutusest eemaldatud. Käsk ei laadi WordPress ega kirjuta midagi ilma valikuta --apply:

Shell
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 seostab iga eesliite selle nimeruumidega ja --known-blocks loetleb registreeritud plokinimed. Aruanne sisaldab vastendusi pärandkujult kanoonilisele kujule koos esinemiskordade arvu ja failipõhiste räsidega ning eraldi loendeid tundmatute siltide, mitmetähenduslike aliaste ja dünaamiliste siltide kohta. --apply keeldub kirjutamast, kui mõni neist alles on, välja arvatud juhul, kui antakse --allow-unresolved.

Töödeldakse paaris-, pesastatud ja isesulguvat märgendust, sealhulgas sõnasõnalisi silte stringides PHP. Muutuvad ainult siltide nimed, teine käivituskord ei tee muudatusi ning kommentaarides, koodiplokkides, <pre> või <code> sisalduvaid näiteid kajastatakse ainult aruandes.

Vaikekäitumine

Versiooni 7.6 paigaldamine ei muuda iseenesest midagi.

Jõudlusprofiili vaikeväärtus on compat. Päise väljund, oEmbed, XML-RPC, Heartbeat, piltide vaikeväärtused, linkide eellaadimine, laisk laadimine ja esiosa <title> jäävad selliseks, nagu WordPress ja teema need jätsid.

Need on välja lülitatud, kuni need lubatakse: iga performance.staticPrerender, performance.measurement, performance.media ja themeDefaults võti ning githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled ja blockTags.enabled. Kui staatiline eelpärendus on välja lülitatud, ei kirjuta see faile ega paigalda lisamoodulit.

Canvas ja Render töötavad passiivselt. Need loevad olemasolevaid registreid ja renderdavad ainult seda, mida helistaja küsib; kumbki ei haaku esiosa väljundiga ega registreeri marsruute. Canvas-e halduskuva nõuab endiselt dev.canvas.enabled ja edit_posts.

Rangema analüüsi jaoks tuleb see nimetada. blockstudio/phpstan paigaldamine lubab ainult põhilaienduse ning kanooniline käsk käivitab base, kui projekt pole eelseadistust nimetanud.

Genereeritud failid nõuavad käsu käivitamist. githooks.commit ei tee midagi enne, kui käivitatakse blockstudio-githooks sync, ja AGENTS.md enne, kui seda teeb blockstudio-agents.

Uuendamine versioonilt 7.5

Nõuded ei ole muutunud: PHP 8.2 või uuem, WordPress 6.7 või uuem.

Shell
composer require blockstudio/blockstudio

Vahemälud luuakse üks kord uuesti. Käitusaja identiteet sisaldab Blockstudio versiooni, seega on esimene päring pärast uuendamist külm ja vanad objektid eemaldatakse. Vana Tailwind vahemälu asukohas wp-content/uploads/blockstudio/tailwind/cache võib kustutada; koodijupp, mis kasutas selle leidmiseks glob-mustrit, peaks selle asemel kutsuma Blockstudio\Runtime_Cache::purge('tailwind').

Versioonile 7.6 eelnenud lame wp-content/blockstudio/cache/runtime kataloog nimetatakse automaatselt aktiivsest teest välja ning eemaldatakse piiratud WP-Cron läbimistega. Seega ei pea juurutuspäringu ajal suuri pärandlukufailide puid kustutama.

Genereeritud failidel on omanikud. assets/media.json kuulub versioonihaldusse või ehitusetappi. Marsruudikaart, advanced-cache.php lisamoodul ja WP_CACHE deklaratsioon eksisteerivad ainult siis, kui earlyServe on lubatud; sissekande-eelne konks ainult sünkroonimise ajal. Kõik muu genereeritud sisu asub kataloogis cache.path ja selle võib turvaliselt kustutada.

Midagi ei eemaldatud ega nimetatud ümber. bs_render_block(), bs_block(), Blockstudio\Pages ja Blockstudio\Patterns jäävad kanoonilisteks failipõhisteks sisupindadeks.

Tagasipööramine käib funktsioonide kaupa. performance.profile väärtuseks compat, staticPrerender.enabled väärtuseks false, githooks.commit väärtuseks false koos sync-ga ning cache.enabled väärtuseks false pööravad igaüks ühe kihi tagasi.

Mõistlik kasutuselevõtu järjekord:

  1. Määra performance.profile väärtuseks speed, seejärel kontrolli päise väljundit, vooge ja kõiki pluginaid, mis sõltuvad oEmbedist või XML-RPC-st.
  2. Loo assets/media.json, vii mallid asukohta bs_media_image() ja lülita seejärel sisse performance.media.lazy.
  3. Luba performance.staticPrerender nii, et earlyServe on välja lülitatud, kontrolli päringuid tööriistaga wp bs prerender status ja lülita seejärel sisse earlyServe.
  4. Käivita blockstudio-phpstan --preset theme, kuni tulemus on puhas, enne kui asetad mõne eelseadistuse valiku githooks.commit taha.

Kust üksikasju leida