Pāriet uz saturu

Dennis · 2026. gada 27. jūlijs

Blockstudio 7.6

Blockstudio 7.6 ļauj nolasīt un attēlot projektu no PHP un pārceļ produkcijas priekšgala noklusējuma iestatījumus uz blockstudio.json: inventāra API, patstāvīgu attēlošanu, veidņu palīgfunkcijas multividei un Tailwind, veiktspējas profilus, vienu kešatmiņas mapi, statisku iepriekšēju atveidošanu ar tūlītēju apkalpošanu, stingrākus analīzes iestatījumus un ģenerētus projektu rīkus programmēšanas aģentiem.

Lielāko daļu laidiena nodrošina divi izsaukumi. Canvas::inventory() atgriež visas lapas, blokus, rakstu paraugus, vietnes redaktora veidnes, veidņu daļas un komplektēto UI piemēru, ko projekts reģistrē. Render::document() atgriež gatavu HTML jebkuram no tiem, kā arī tieši tos resursus, kas izmantoti attēlošanā.

7.6.2 atjauninājums: failos glabātās lapas parastu WordPress pieprasījumu laikā vairs netiek saskaņotas. Avota izmaiņas piemērojiet, izpildot wp bs pages sync vai izsaucot Blockstudio\Pages::reconcile(). Kolekciju maršrutēšanai un templateFor noklusējuma iestatījumiem tiek izmantota saglabātā izpildvides konfigurācija, un skaidra saskaņošana ļauj izvairīties no iepriekš izmantotā apjomīgā daudzvalodu OR-meta vaicājuma. Īslaicīgā opcija themeDefaults.syncPagesInDevelopment ir noņemta, jo lapu sinhronizācija vairs nenotiek pieprasījumu āķos. Pages::init() tagad tiek izmantots tikai inicializēšanai; integrācijām, kas nodeva force, jāizmanto Pages::reconcile() vai CLI. Atverot Canvas, autorēšanas inventāram joprojām tiek veikta viena autentificēta, skaidri izsaukta saskaņošana.

7.6.12 atjauninājums: redaktora stilu lapām tagad tiek pievienots prefikss ar vienu pārrakstīšanas gājienu, nevis katram resursam atsevišķi kompilējot SASS, tāpēc redaktora aukstā būvēšana vietnē ar daudziem blokiem vairs nerada risku pārsniegt pieticīgu atmiņas ierobežojumu. Kešota iepriekš renderēta lapa, kuras satura jaucējvērtībā balstītā Tailwind stilu lapa ir izņemta no kešatmiņas, tiek renderēta no jauna, nevis rādīta bez stiliem — gan izmantojot PHP kešatmiņu, gan Early Serve papildmoduli. Augšējā līmenī ierakstītie bloka atribūti renderēšanas laikā tiek nolasīti, nevis atmesti, tāpēc shēmas Blockstudio reģistrācija vietnē WP_Block_Type tiek ievērota, ja datus raksta programmiski.

7.6.11 atjauninājums: Graph artefaktu instalēšana tagad atomiski aizstāj maršruta dokumentu, ja krātuves kopija ar to pašu atslēgu ir mainījusies, nemaina identiskus dokumentus un ar Static_Prerender_Early_Serve::last_promotion() starpniecību ziņo par paaugstinātajiem, aizstātajiem, izlaistajiem un saglabātajiem maršrutiem.

7.6.10 atjauninājums: izpildlaika kešatmiņas trāpījumi tagad konstatē izņemtus kompilētus resursus pat novērošanas aizkaves laikā, bet plakanās izpildlaika kešatmiņas pirms 7.6. versijas tiek atomiski ievietotas karantīnā un dzēstas ierobežota lieluma cron porcijās. Komplektētie UI globālie objekti tiek izvadīti vienreiz katrā lapā. Graph režīmā Early Serve var apkalpot tiešsaistē renderētus maršrutus ārpus izvietoto maršrutu kartes, izmantojot identitātes kešatmiņu. Tailwind pēc izvēles var izvadīt satura jaucējvērtībā balstīto kešatmiņas failu ar tailwind.output: "link"; pēc noklusējuma izvade ir iekļauta lapā.

Īsumā:

  • Projekta inventārs: Canvas::inventory() atgriež katru reģistrēto ierakstu kopā ar tā avotiem un stabilu attēlošanas secību.
  • Mērķēta atlase: norādot blokus un lapas, atklāšana, sinhronizēšana, renderēšana un kompilēšana tiek ierobežota līdz šiem ierakstiem.
  • Atsevišķa renderēšana: Blockstudio\Render atgriež gatavu HTML blokam, kompozīcijai vai pilnam dokumentam.
  • UI komponentu saimes: Blockstudio\Ui grupē komplektēto bibliotēku vienā publiskā saimē katram komponentam, pievienojot pa piemēram.
  • Stabili attēlu izmēri: bs_media_image() renderē tēmas resursus ar īstajiem izmēriem no ģenerēta assets/media.json.
  • Tailwind klašu palīgi: bs_tw_merge() un bs_tw_variants() apvieno klases PHP, ņemot vērā konfliktus.
  • Veiktspējas profili: performance.profile uzreiz ieslēdz ražošanas vides priekšgala noklusējuma iestatījumus; pakārtotās vērtības tos pārraksta.
  • Tipizēta iestatījumu piekļuve: Settings::get_bool() un līdzīgās funkcijas nolasa blockstudio.json, izmantojot īstos tipus, un parāda parsēšanas kļūdas.
  • Viena kešatmiņas mape: visi ģenerētie faili atrodas zem cache.path, un to nosaukumos izmantota izpildlaika identitāte.
  • Statiskā iepriekšējā renderēšana: anonīmus HTML var kešot, invalidēt, izmantojot atkarību grafu, un apkalpot, pirms tiek palaists WordPress.
  • Analīzes sākotnējie iestatījumi: theme, extreme-theme un wordpress-render paplašina blockstudio/phpstan iespējas ārpus bloku veidnēm.
  • Pārvaldīts apstiprināšanas āķis: blockstudio-githooks sync izveido un pārvalda pre-commit āķi, kas izpilda konfigurēto sākotnējo iestatījumu.
  • Projekta līgums: blockstudio-agents izveido AGENTS.md, kurā aprakstīts, ko projekts veido, kādas funkcijas tas iespējo un ko pārbauda tā sākotnējais iestatījums.
  • Dokumentācijas rādītājs: AI konteksta fails tagad ir visu dokumentu rādītājs, kurā norādīts katra dokumenta mērķis un tam piederošie identifikatori.
  • Kanoniskie bloku tagi: atsevišķa komanda pārraksta prefiksu un aizstājvārdu saīsinājumus par <bs:namespace-slug>, un to var palaist izmēģinājuma režīmā.
  • Saderība pēc noklusējuma: neviena no iepriekš minētajām izmaiņām neietekmē vietni, kamēr tā nav norādīta vietnē blockstudio.json.

Projekta nolasīšana un renderēšana

Projekta inventārs

Canvas::inventory() atgriež visu, ko projekts reģistrē, kā vienu vienkāršu masīvu, neko nerenderējot.

PHP
use Blockstudio\Canvas;

$result = Canvas::inventory();

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

Ieraksti ir grupēti pēc tipa: pages, blocks, patterns, templates, parts un ui. order nosaka stabilu attēlošanas secību visiem tipiem, sources katram ierakstam piesaista tā avota ceļus, bet warnings un errors apkopo problēmas strukturētos ierakstos.

Bloku ierakstos ir id, name, title, source, path, provenance un renderēšanai gatavs declaration. Lapu ierakstos source ir stabila identitāte, bet path — renderējamā veidne.

Mērķēta atlase

Norādot ierakstus, tiek sašaurināts veicamais darbs, nevis vēlāk filtrēti rezultāti.

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

Tas atgriež vienu bloku un vienu lapu. patterns, templates, parts un ui tiek atgriezti tukši, un to avoti netiek nolasīti, sinhronizēti, renderēti vai kompilēti.

Noteikumi ir precīzi:

  • Ja nav norādīta neviena tipa atslēga, tiek ielādēti visi tipi.
  • true, null vai "*" ielādē visus attiecīgā tipa ierakstus.
  • Virkne vai saraksts precīzi atbilst ID, nosaukumam, slug, ceļam vai avota ceļam.
  • Tukša virkne, tukšs saraksts vai false neielādē nevienu attiecīgā tipa ierakstu.
  • Ja ir norādīta kaut viena tipa atslēga, nenorādītie tipi paliek nemainīti.

Neesoši identifikatori tiek atgriezti sadaļā deleted, nevis izraisa kļūdu, un Canvas REST atsvaidzināšanas galapunkts to pašu noteikumu piemēro saviem blocks un pages parametriem.

Canvas::documents() izmanto to pašu atlasi un katram ierakstam pievieno vienu renderētu dokumentu. Atlasītās lapas tiek renderētas atjaunotā priekšgala kontekstā, tāpēc vaicājumu nosacījumi, body klases, īskodi, izkārtojumi, novirzīšana un resursu pievienošanas atgriezeniskie izsaukumi izmanto šo lapu, nevis pieprasījuma kontekstu.

Atsevišķa renderēšana

Blockstudio\Render atgriež renderētu HTML kā virkni, izmantojot to pašu konveijeru, ko izmanto priekšgals.

PHP
use Blockstudio\Render;

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

Pamatā ir viena deklarācijas forma ar četrām atslēgām: name, attributes, content un children. root, data, inner, innerBlocks, layers un example ir ievades saīsinājumi, ko Render::normalize() apvieno šajā formā. Bērni tiek renderēti rekursīvi, un nederīga ievade izraisa izņēmumu, kurā norādīts problemātiskais bloks.

Render::document() iekļauj izvadi pilnā atsevišķā HTML dokumentā.

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

echo $document['html'];

body ir tikai bloka izvade, html — saliktais dokuments, blocks — bloku nosaukumi, kas piedalījās, bet assets sadala marķējumu šādās daļās: head, footer, styles, scripts, modules, interactivity, ui un tailwind. Resursi tiek ierobežoti ar tiem, kas izmantoti renderēšanā, tāpēc redaktoram paredzētie resursi netiek iekļauti.

Render::document_from_html() iesaiņo citur renderētu HTML, bet Render::content() renderē serializētu bloka saturu bez dokumenta. Starp dokumentiem vienā PHP procesā izsauciet Blockstudio\Batch_Render::reset(); Canvas::documents() to jau dara.

UI komponentu saimes

Blockstudio\Ui piedāvā komplektēto UI bibliotēku kā vienu ierakstu katram publiskajam komponentam, nevis kā iekšējo daļu sarakstu.

Ui::inventory() atgriež vienu ierakstu katrai saimei, norādot tās saknes bloku, virsrakstu un nepieciešamos implementācijas blokus. Ui::examples() pievieno katrai saimei deterministisku deklarāciju: noklusējuma vērtības tiek saglabātas, obligātie bērnu slāņi ievietoti to vecākos, un pievienots stabils ilustratīvs teksts, ja lauks citādi būtu tukšs. Šī deklarācija ir kanoniska, tāpēc to var tieši ievietot vietnē Render::document().

Canvas grupē komponentus tāpat. Komplektētais UI tiek rādīts kā viens piemērs katrai saimei zem tipa ui, bet implementācijas reģistrācijas netiek iekļautas vietnē blocks.

Saimes ir veidotas tā, lai tās varētu kombinēt: atlase atveras dialogā, kura saraksta lodziņš pārklāj palaidēju; izvēlnes un kombinētie lodziņi tiek piesaistīti fiksētām skata loga koordinātām, kas saglabājas ritinot; modālie logi tiek kārtoti cits virs cita un aizvērti pa vienam ar Escape; katrā kājenē viena un tā pati aizvēršanas vadīkla tiek kombinēta ar variantu. Sadaļā kompozīciju nodaļa ir aprakstīts, kā darbojas šīs saskares vietas un invarianti, kas nodrošina to darbību; /ui/examples redzamas kompozīcijas darbībā.

Veidņu palīgi

Stabili attēlu izmēri

bs_media_image() renderē tēmas resursus ar īsto platumu, augstumu un rezervētu malu attiecību, tāpēc attēli ārpus multivides bibliotēkas vairs neizkustina izkārtojumu.

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

Izvade ir figure.blockstudio-media ar iekļautu aspect-ratio ap img, kuram ir īstās width, height, loading un decoding vērtības. Izmēri tiek nolasīti no ģenerēta assets/media.json, ko būvēšanas darbībā izveido Blockstudio\Media_Metadata_Builder vai ko var izveidot manuāli.

src pieņem tēmas relatīvo ceļu, absolūto ceļu vai pilnu URL, bet attachmentId apstrādā multivides bibliotēkas attēlus. eager atspējo attēlu slinko ielādi lapas augšdaļā, bet sources izvada <picture>.

Kad ir ieslēgts performance.media.lazy, īstais URL tiek pārvietots uz data-src aiz pareizā izmērā esoša viettura.

Tailwind klašu palīgi

bs_tw_merge() un bs_tw_variants() apvieno Tailwind klases PHP veidnēs, izmantojot dzinēju Blockstudio, kas jau ir iekļauts komplektācijā.

bs_tw_merge('px-2 text-sm', 'px-4') atgriež text-sm px-4: konfliktējošā px-2 klase tiek atmesta, un uzvar vēlākā vērtība. Tiek pieņemti arī ligzdoti klašu vērtību masīvi.

bs_tw_variants() atgriež nelielu izsaucamu funkciju komponentu variantiem:

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

Tiek izvadīts inline-flex items-center h-12 px-6 rounded. Tiek atbalstītas bāzes klases, varianti, noklusējuma varianti, saliktie varianti un katram izsaukumam paredzēts class vai className.

Ražošanas vides konfigurācija

Veiktspējas profili

performance.profile vienuviet ieslēdz priekšgala noklusējuma iestatījumus ražošanas videi.

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

compat ir noklusējuma iestatījums un neko nemaina. speed un strict iespējo vienu un to pašu kopu: no head tiek noņemta ģeneratora, emocijzīmju, plūsmas, atklāšanas un blakus ziņu izvade; tiek noņemta oEmbed atklāšana un resursdatora skripti; tiek atspējots XML-RPC, pingback un attālā redaktora atklāšana; tiek noņemti vispārīgie pamata priekšgala resursi; tiek piemēroti attēlu izvades noklusējuma iestatījumi; ārpus redaktoriem tiek ierobežota Heartbeat darbība; tāpat tiek iepriekš ielādēti tās pašas izcelsmes dokumenti, kad lietotājs norāda uz tiem vai fokusē tos; un tiek izmantots Blockstudio attēlu ielādētājs.

Katra pakārtotā vērtība pārraksta profilu, kā tas redzams iepriekš pie preload.links. Pirmā pārbaudāmā iespēja ir pamata priekšgala resursu noņemšana, jo lapa, kas ir atkarīga no tiem, redzami nedarbosies. Runtime_Settings::current() parāda atrisināto profilu.

themeDefaults nodrošina divas iespējas, ko tēmas citādi īstenotu pašas: titleTag un suppressDirectoryUpdates, lai paslēptu aktīvo bērntēmu un vecāktēmu no atjauninājumu rezultātiem.

Tipizēta iestatījumu piekļuve

Blockstudio\Settings nolasa konfigurāciju ar īstiem datu tipiem, nevis atgriež to, kas bija saglabāts JSON.

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

Par nederīgu JSON tiek ziņots, izmantojot Settings::errors(), nevis aizstājot to ar noklusējuma vērtībām. Settings::get_raw() atgriež tikai to, ko deklarējis aktīvais avots, tādējādi var atšķirt vērtību, kas iestatīta uz false, no vērtības, kas nekad nav iestatīta.

Settings::fingerprint() atgriež stabilu efektīvo iestatījumu identitāti, un piekļuve tiek pārlādēta, kad mainās blockstudio.json.

Viena kešatmiņas mape

Visi ģenerētie faili tagad atrodas zem cache.path, kura noklusējuma vērtība ir wp-content/blockstudio/cache.

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

Būvēšanas dati, bloku reģistrācijas dati, redaktora resursi, kompilētais Tailwind CSS, renderēšanas dokumenti, salu fragmenti, statiskais HTML, Graph indeksi, iesildīšanas rindas un diagnostika atrodas šajā saknes mapē. Relatīvais ceļš tiek atrisināts no WP_CONTENT_DIR, bet absolūtais ceļš norāda uz atsevišķu sējumu.

Objekti tiek glabāti zem pašreizējā tīkla un vietnes, pēc tam — zem izpildlaika identitātes: pirkstu nospieduma, ko veido Blockstudio, WordPress un PHP versijas, efektīvie iestatījumi, aktīvā tēma un spraudņi, atklāšanas avoti un izmantotie avota faili. Mainot kādu ievadi, attiecīgie objekti tiek aizstāti ar jauniem; vecie objekti tiek iztīrīti.

Aukstā būvēšana tiek veikta tikai vienreiz: viens pieprasījums izveido un atomiski publicē rezultātu, bet pārējie gaida. Ja atjaunināšana neizdodas, pēdējais sekmīgais objekts joprojām tiek apkalpots, kļūdu vienlaikus saglabājot redzamu, un Blockstudio\Runtime_Cache::purge('tailwind') notīra vienu tvērumu.

Statiskā iepriekšējā renderēšana

Statiskā iepriekšējā renderēšana saglabā kešatmiņā pilnīgus anonīmus HTML dokumentus un var tos apkalpot, pirms tiek palaists WordPress. Pēc noklusējuma tā ir izslēgta.

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

Atbilstības nosacījumi

Atbilst tikai pilnīgi anonīmi HTML dokumenti. Netiek apkalpoti pieprasījumi, kas nav GET pieprasījumi, pieprasījumi ar vaicājuma virknēm, administrēšanas, REST, Ajax, cron, plūsmu, meklēšanas, priekšskatījuma vai nonce saturoši pieprasījumi, kā arī pieprasījumi ar personalizācijas sīkdatnēm vai ceļu zem dynamicPaths. Atbilde var pilnībā atteikties no šīs iespējas, pievienojot marķieri <!-- blockstudio:no-cache -->.

Ceļu salīdzināšanā tiek ievērotas robežas, tāpēc /account aptver /account/orders, bet ne /accounting.

Paraksta un Graph režīmi

invalidate nosaka, kā beidzas ierakstu derīguma termiņš. Noklusējuma režīmā signature anonīms pieprasījums aizpilda pēc identitātes atslēgotu atbildes kešatmiņu, kas tiek pagriezta pēc izmaiņām vietnes līmenī; šis režīms ir piemērots parastai vietnei.

graph režīms paredzēts skaidri norādītiem būvēšanas un izvietošanas rīkiem. Tajā tiek reģistrētas katras lapas atkarības no avotiem, tāpēc plāns atjauno tikai ietekmētos URL.

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

Agrīna apkalpošana

Kad ir ieslēgts earlyServe, Blockstudio pārvalda nelielu katras vietnes maršrutu karti un advanced-cache.php papildmoduli, kas straumē atbilstošu kešatmiņas trāpījumu, pirms tiek palaists WordPress, spraudņi vai tēma.

Tas nekad nepārraksta citu maršrutu karti, papildmoduli vai WP_CACHE deklarāciju. Pirms kartes nomaiņas Graph artefaktā tiek pārbaudīts katrs atsauces HTML fails, tāpēc nepilnīga izvietošana atstāj aktīvu iepriekšējo grafu. Multivietņu ieraksti tiek izolēti pēc resursdatora, sākumlapas ceļa un vietnes ID.

Iesildīšana un statuss

Ikdienas lietošanai paredzētas trīs WP-CLI komandas:

Apvalks
wp bs prerender warm
wp bs prerender status
wp bs prerender purge

status parāda aktīvo identitāti, failu un baitu skaitu, grafa ierakstus, rindas stāvokli un tvērumu skaitītājus: trāpījumus, netrāpījumus, būvēšanas un kļūmes.

Analīze un aģentu rīki

Analīzes sākotnējie iestatījumi

blockstudio/phpstan papildina bloku analīzi ar trim slāņiem un vienu komandu, kas palaiž projekta atlasīto slāni.

Sākotnējais iestatījums Ko tas pievieno
base Esošo shēmu, veidņu, āķu, iestatījumu un API analīzi.
theme Tēmu saknes, stilu galvenes, resursus, selektoru tvērumu, lauku noklusējuma vērtības, atkārtotāju robežas.
extreme-theme PHPStan max, nedrošu PHP, izvairīšanos, Tailwind, JavaScript un Interactivity pārbaudes.
wordpress-render Zvanītāja nodrošinātu aktīvās renderēšanas zondi papildus extreme-theme.

Noklusējuma vērtības tiek ņemtas no blockstudio.json, lai interaktīvās palaišanas, CI un apstiprināšanas āķi izmantotu vienu konfigurāciju:

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

Atgriešanas kodi ir 0, ja pārbaude ir sekmīga, 1, ja konstatēta diagnostikas informācija, un 2, ja lietojums nav derīgs. Aptverošā programma izveido konfigurāciju sistēmas pagaidu mapē, tāpēc projektā netiek saglabāta ģenerēta konfigurācija, bāzlīnija vai kešatmiņa, kā arī tā palielina PHPStan atmiņas ierobežojumu līdz 1G.

Tajā ir iekļauts arī BC Math nodrošinātājs, tāpēc JavaScript pārbaudēm vairs nav nepieciešams ext-bcmath.

Pārvaldīts apstiprināšanas āķis

Ar vienu iestatījumu un vienu komandu konfigurēto sākotnējo iestatījumu var izmantot kā apstiprināšanas vārtus.

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

Sinhronizēšana ieraksta āķi un īpašumtiesību ierakstu kopējā mapē Git, norāda core.hooksPath uz pārvaldīto mapi un piesaista iepriekš konfigurēto pre-commit āķi. Apstiprināšanas brīdī āķis atrod repozitoriju un projekta saknes mapi, tāpēc darbojas gan saistītās darba kopijas, gan ceļi ar atstarpēm.

Āķis palaiž tikai vendor/bin/blockstudio-phpstan; tas nekad neformatē vai nepārraksta failus. Iestatot commit uz false un vēlreiz sinhronizējot, vai palaižot blockstudio-githooks remove, tiek atjaunots ierakstītais āķa ceļš un dzēsti tikai Blockstudio piederošie faili.

Projekta līgums

blockstudio-agents izveido AGENTS.md, kurā norādīts, kur atrodas bloki, kā šajā projektā definēta lapa, kuras funkcijas ir iespējotas un ko analizators noraidīs.

Apvalks
vendor/bin/blockstudio-agents

Dokuments tiek iegūts no projekta, nevis veidots no veidnes. Tēmai ar style.css galveni, blokiem un failos glabātām lapām būs cits līgums nekā spraudnim, kurā reģistrēti tikai bloki; tajā būs norādīti skenētāja atrastie skaiti, mapes, nosaukumvietas un veidņu valodas. blockstudio.json nosaka, kuras funkcijas tiek iekļautas, tāpēc projektā bez statiskās iepriekšējās renderēšanas tā netiek pieminēta.

Pareizības sadaļa tiek nolasīta no atlasītā sākotnējā iestatījuma noteikumu failiem pa slāņiem, tāpēc, ja sākotnējam iestatījumam tiek pievienots noteikums, tas maina katru ģenerēto līgumu.

Īpašumtiesības darbojas tāpat kā apstiprināšanas āķim. Ja failā nav ģenerētā marķiera, to atsaka aizstāt, ja vien --force nenosaka citādi; piezīmju sadaļa beigās tiek saglabāta arī pēc atkārtotas ģenerēšanas; ja līgums ir novecojis, --check izvada 1; bet --stdout to izvada, nemainot failu sistēmu.

Dokumentācijas rādītājs

blockstudio-llm.txt tagad ir rādītājs, nevis dokumentu apvienojums. Katrs publicētais dokuments tajā parādās vienreiz, norādot sadaļu un apakšsadaļu, maršrutu, avota failu, vienas rindas aprakstu un tam piederošos identifikatorus: iestatījumu ceļus, āķu nosaukumus, PHP funkcijas un klases, kā arī komandas.

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

Aģents nolasa indeksu, atrod vienu dokumentu, kurā atrodas tam vajadzīgais identifikators, un atver šo dokumentu. Iepriekšējo pusmegabaita apvienoto failu joprojām ģenerē un publicē vietnē /blockstudio-llm-full.txt; tas vairs nav pirmais, kas tiek pasniegts ikvienam.

Kanoniskie bloku tagi

Atsevišķa komanda pārraksta prefiksu un aizstājvārdu saīsinājumus kanoniskajā <bs:namespace-slug> pierakstā, kas norāda īsto bloka nosaukumu un tiek atrisināts arī tad, ja nav ielādēts projekta filtrs.

Ar prefiksu brand virs theme-components un prefiksu ui virs bsui šis saīsinājums:

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

nozīmē to pašu, ko:

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

Prefiksi un precīzi aizstājvārdi joprojām darbojas un nav novecojuši. Komanda neielādē WordPress un neko nepieraksta bez --apply:

Apvalks
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 katru prefiksu piesaista tā nosaukumvietām, bet --known-blocks uzskaita reģistrētos bloku nosaukumus. Pārskatā norādītas mantotā un kanoniskā pieraksta atbilstības un to gadījumu skaits, katra faila jaucējkods un atsevišķi saraksti ar nezināmiem tagiem, neskaidriem aizstājvārdiem un dinamiskiem tagiem. --apply atsakās rakstīt, kamēr kāds no tiem saglabājas, ja vien nav norādīts --allow-unresolved.

Tiek apstrādāts pārots, ligzdots un pašnoslēdzošs marķējums, tostarp burtiski tagi PHP virknēs. Mainās tikai tagu nosaukumi; otrā palaišanas reizē izmaiņu nav, un piemēri komentāros, koda blokos, <pre> vai <code> tiek tikai iekļauti pārskatā.

Noklusējuma darbība

7.6 instalēšana pati par sevi neko nemaina.

Veiktspējas profils pēc noklusējuma ir compat. Galvenes izvade, oEmbed, XML-RPC, Heartbeat, attēlu noklusējuma iestatījumi, saišu priekšielāde, slinkā ielāde un priekšgala <title> paliek tādi, kādus tos atstāja WordPress un tēma.

Tie paliek izslēgti, kamēr nav iespējoti: katra performance.staticPrerender, performance.measurement, performance.media un themeDefaults atslēga, kā arī githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled un blockTags.enabled. Kamēr statiskā iepriekšējā renderēšana ir izslēgta, tā neraksta failus un neinstalē papildu komponentu.

Canvas un Render darbojas pasīvi. Tie nolasa esošos reģistrus un renderē tikai to, ko pieprasa izsaucējs; neviens no tiem nepievieno savas funkcijas priekšgala izvadei un nereģistrē maršrutus. Canvas administrēšanas ekrānam joprojām nepieciešami dev.canvas.enabled un edit_posts.

Stingrākai analīzei tā ir skaidri jānorāda. Instalējot blockstudio/phpstan, tiek iespējots tikai pamata paplašinājums, un kanoniskā komanda palaiž base, ja vien projektā nav norādīts iepriekšiestatījums.

Ģenerētie faili ir jāizveido, palaižot tiem paredzēto komandu. githooks.commit neko nedara, līdz tiek palaists blockstudio-githooks sync, un AGENTS.md — līdz tiek palaists blockstudio-agents.

Jaunināšana no 7.5

Prasības nav mainījušās: PHP 8.2 vai jaunāka versija, WordPress 6.7 vai jaunāka versija.

Apvalks
composer require blockstudio/blockstudio

Kešatmiņas tiek atjaunotas vienu reizi. Izpildlaika identitātē ir iekļauta Blockstudio versija, tāpēc pirmais pieprasījums pēc jaunināšanas ir auksts, un vecie objekti tiek iztīrīti. Veco Tailwind kešatmiņu mapē wp-content/uploads/blockstudio/tailwind/cache var izdzēst; koda fragmentam, kas izmantoja globēšanu, tās vietā jāizsauc Blockstudio\Runtime_Cache::purge('tailwind').

Pirms 7.6 izmantotā plakanā wp-content/blockstudio/cache/runtime mape tiek automātiski pārdēvēta, lai tā vairs neatrastos aktīvajā ceļā, un noņemta ierobežotās WP-Cron izpildēs. Tāpēc izvietošanas pieprasījuma laikā nav jādzēš lieli mantoto bloķēšanas failu koki.

Ģenerētajiem failiem ir īpašnieki. assets/media.json jāiekļauj versiju kontrolē vai veidošanas darbībā. Maršrutu karte, advanced-cache.php papildu komponents un WP_CACHE deklarācija pastāv tikai tad, ja ir iespējots earlyServe, bet pirmsiesniegšanas āķis — tikai sinhronizēšanas laikā. Viss pārējais ģenerētais saturs atrodas zem cache.path, un to var droši dzēst.

Nekas nav noņemts vai pārdēvēts. bs_render_block(), bs_block(), Blockstudio\Pages un Blockstudio\Patterns joprojām ir kanoniskās failos glabātā satura virsmas.

Katru funkciju var atgriezt iepriekšējā stāvoklī atsevišķi. performance.profile uz compat, staticPrerender.enabled uz false, githooks.commit uz false kopā ar sync un cache.enabled uz false — katra no šīm darbībām atceļ vienu slāni.

Ieteicamā ieviešanas secība:

  1. Iestatiet performance.profile uz speed, pēc tam pārbaudiet galvenes izvadi, plūsmas un visus spraudņus, kas izmanto oEmbed vai XML-RPC.
  2. Ģenerējiet assets/media.json, pārvietojiet veidnes uz bs_media_image() un pēc tam ieslēdziet performance.media.lazy.
  3. Iespējojiet performance.staticPrerender, atstājot earlyServe izslēgtu; pārbaudiet trāpījumus, izmantojot wp bs prerender status, un pēc tam ieslēdziet earlyServe.
  4. Palaidiet blockstudio-phpstan --preset theme, līdz pārbaudē vairs nav atradumu, un tikai tad pievienojiet jebkuru iepriekšiestatījumu pie githooks.commit.

Kur atrast detalizētu informāciju