
Blockstudio 7.7 dodaja navidezne poti za dokumente brez objave WordPress, izboljšuje ciljane gradnje za vnaprejšnje upodabljanje ter zagotavlja zanesljivejše urejanje in upodabljanje obstoječih blokov. Razširja tudi preverjanje oznak blokov v PHPStan in izboljšuje dostopnost priloženih komponent UI.

Potek dela, ki daje prednost datotekam, ostaja enak. Bloki se upodabljajo iz svojih predlog, strani, ki temeljijo na datotekah, pa se spreminjajo z izrecno sinhronizacijo CLI ali API. Ta izdaja ne uvaja samodejne sinhronizacije strani ob zahtevah obiskovalcev ali skrbnika.

Na kratko:

- **Navidezne poti**: postrezite galerijo komponent, katalog ali drug celovit dokument, ne da bi ustvarili objavo ali napisali lastni upravljalnik preusmeritev.
- **Ciljane gradnje za vnaprejšnje upodabljanje**: gradnje HTTP beležijo izvorne datoteke, ki jih uporablja posamezna stran, zato lahko naslednja gradnja upodobi samo prizadete poti.
- **Ohranjanje predpomnilnika**: upokojene slogovne datoteke naj ostanejo na voljo za predpomnjene strani, neuporabljene vnose zemljevida zgodnjega streženja pa preglejte ali odstranite.
- **Zanesljivejši urejevalnik**: bloki z večkratnim izborom ohranijo svoje vrednosti, razveljavitev in ponovitev delujeta za RichText in polja stranske vrstice, podedovani kontekst pa ostane povezan s pravim blokom.
- **Zvestoba vsebine datotek**: ugnezdeni seznami, elementi za razdelitev vsebine na odseke, vrstična oznaka HTML, kratke kode in ubežni atributi se ohranijo pri razčlenjevanju in upodabljanju.
- **Izboljšave za PHPStan**: oznake s predponami, vzdevki, preslikani elementi strani in spremenljivke predlog se preverjajo glede na definicije lastnega projekta.
- **Dostopne komponente UI**: kontrolniki pravilno razkrijejo svoje stanje, oznake preklapljajo prave vnose, komponente seznamov in tabel pa uporabljajo veljavno strukturo HTML.
- **Prevodi**: nameščeni prevodi JavaScript se naložijo v urejevalniku in skrbniškem pregledu, vključno s prej neprevedenimi kontrolniki polj.

## Navidezne poti

Nekatere strani izvirajo iz podatkov in ne iz objave, ki jo upravlja urejevalnik. Referenca komponent lahko na primer potrebuje lastno URL in naslov dokumenta, vendar ne potrebuje vnosa v `wp_posts`.

Ta dokument registrirajte z `Blockstudio\Virtual_Routes`:

```php title="functions.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']
    );
});
```

Pot streže `/components/`. Njen povratni klic se izvede znotraj izhodnega medpomnilnika za Blockstudio, zato upodobljeni bloki prejmejo sloge, skripte, priložena sredstva UI in izhod Tailwind po običajnem postopku. WordPress ujemajoče se poti ne spremeni v 404 in je ne preusmeri na objavo.

Za skupino URL-jev nastavite `prefix` na `true` in podajte povratni klic `match`. Povratni klic prejme pot pod potjo in vrne vrednost, ki jo potrebuje upodabljalnik. Če vrne `null` ali `false`, se zahteva prepusti WordPress. Z `urls` navedite poti, ki naj jih vključuje gradnja za statično vnaprejšnje upodabljanje. Pot posamezne neprefiksne poti je privzeto vključena.

`Virtual_Routes::urls()` vrne absolutne URL-je za integracije, ki sestavljajo zemljevid spletnega mesta. Navideznih dokumentov ne doda samodejno v zemljevid objav WordPress.

Za celoten API in možnosti glejte [Navidezne poti](https://blockstudio.dev/sl/docs/pages-and-patterns/pages/#virtual-routes).

## Natančnejše gradnje za vnaprejšnje upodabljanje

Gradnje v načinu grafa, upodobljene prek HTTP, zdaj zabeležijo datoteke, ki jih je uporabila vsaka pot: predlogo WordPress, upodobljene predloge blokov in sredstva, definicije in postavitve strani iz datotek ter odvisnosti, dodane prek `blockstudio/render/dependencies`.

Pri naslednji gradnji `build_plan()` primerja te odvisnosti. Če spremenite predlogo bloka, se za upodabljanje označijo od nje odvisne poti, ne da bi bilo treba znova zgraditi vse nepovezane strani. Spremembe skupne konfiguracije še vedno vplivajo na celotno gradnjo, nove ali potekle poti pa se upodobijo kot prej.

Spremembe, ki obstajajo samo v zbirki podatkov, niso odvisnosti od datotek. Pri uvedbi, ki mora upoštevati možnost, objavo ali drugo vrednost iz zbirke podatkov, je treba vsiliti gradnjo ali izrecno upodobiti prizadete URL-je.

Izdaja odpravlja tudi spreminjanje identitet gradnje med prvim upodabljanjem, zastarele zemljevide zgodnjega streženja v predpomnilniku opkod in izločanje veljavnih URL-jev zgolj zato, ker njihova pot vsebuje `search` ali `preview`. Zahteve Markdown, ki uporabljajo `Accept: text/markdown`, obidejo predpomnjeni HTML, ustrezni odgovori pa pošljejo `Vary: Accept`.

Statično vnaprejšnje upodabljanje zdaj pri odločanju o dodajanju svojih kavljev upošteva filtre, ki jih registrira aktivna tema. Tema lahko funkcijo izklopi, ne da bi jo predhodno iskanje nastavitev pustilo aktivno.

Glejte [Statično vnaprejšnje upodabljanje](https://blockstudio.dev/sl/docs/production/static-prerendering/).

## Ohranjanje in vzdrževanje predpomnilnika

Predpomnjena stran HTML lahko ostane na voljo dlje od identitete izvajalnega okolja, v katerem je bil preveden njen slog. `cache.namespaceGrace` določa, kako dolgo ostanejo upokojeni imenski prostori na voljo po tem, ko čiščenje prvič zazna, da so upokojeni:

```json title="blockstudio.json"
{
  "cache": {
    "namespaceGrace": 777600
  }
}
```

Ta primer ohranja upokojene datoteke devet dni. Privzeta vrednost je en dan. Imenski prostori, ki so trenutno aktivni ali strežejo uvedene artefakte vnaprejšnjega upodabljanja, so zaščiteni pred čiščenjem upokojenih.

Zemljevid zgodnjega streženja ima tudi ukaza za pregled in čiščenje:

```bash
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
```

Prikažeta in odstranita vnose za izbrisana mesta ali manjkajoče imenike. Če izbrišete mesto iz večmestne namestitve, se odstranijo tudi njegovi vnosi. Manjkajoči dokumenti poti so prikazani ločeno, zato se veljaven vnos mesta ne odstrani v celoti.

Za navodila o ohranjanju glejte [Predpomnjenje](https://blockstudio.dev/sl/docs/production/caching/), za ukaze pa [vzdrževanje zemljevida](https://blockstudio.dev/sl/docs/production/static-prerendering/#warming-maintenance-and-observability).

## Zanesljivejši urejevalnik

Urejanje bloka z večkratnim izborom zdaj spremeni samo ta blok. Pri shranjevanju se vsebina, ključi, metapodatki in zaklepi vsakega bloka ohranijo, namesto da bi se atributi kopirali med izbranimi bloki.

Vrednosti RichText so neposredno v atributih bloka, zato jih lahko Gutenberg vključi v razveljavitev in ponovitev. V zgodovino so vključena tudi polja stranske vrstice. `InnerBlocks templateLock="false"` se posreduje kot prava logična vrednost in odklene vsebino, tudi če je zunanje območje zaklenjeno.

Začetni predhodni prenosi prejmejo ID in vrsto urejane objave, zato lahko predloge že pri prvem upodabljanju preberejo pravilne metapodatke. Enaki podrejeni bloki pri različnih nadrejenih blokih ohranijo ločen podedovani kontekst v predhodnih prenosih in predpomnilnikih upodabljanja. Spremembe atributov ali konteksta med začetno zahtevo ne povzročijo več zaostanka predogleda.

Blockstudio preprečuje tudi vstavljanje skritih označevalnih elementov upodabljanja med korene blokov. Izbirniki sosednjih elementov, kot je `.card + .card`, zdaj vidijo enaka razmerja med elementi v urejevalniku in na frontendu, predogledi urejevalnika in vstavljalnika pa ostanejo ločeni.

## Varnejše shranjevanje možnosti za celotno spletno mesto

Polja, vezana na možnosti, še vedno ponujajo vrednosti za celotno spletno mesto, vendar shranjevanje objave ne zapiše več slepo vsake shranjene kopije teh polj:

- Shranjevanje osnutkov, objav v čakanju, zasebnih in načrtovanih objav ne zapiše aktivnih možnosti spletnega mesta.
- Pri shranjevanju objavljenih objav se zapišejo posredovana polja, ki so bila v tem urejanju spremenjena.
- Shranjevanje stare kopije, pri katerem se spremeni samo naslov, ne povrne novejše vrednosti za celotno spletno mesto.
- Manjkajoča polja in odstranjeni bloki ne izbrišejo obstoječih možnosti.
- Izrecna vrednost `null` odstrani možnost. Prazni nizi, `false`, ničla in prazna polja ostanejo veljavne vrednosti.

To je glavna sprememba v delovanju, ki jo morate preveriti pri nadgradnji. Če je integracija za posodobitev aktivne možnosti uporabljala zasebno objavo ali osnutek, to možnost zapišite izrecno ali uporabite objavljeno konfiguracijsko objavo. Omejitev, ki velja samo za objavljene objave, ne vpliva na shranjevanje metapodatkov objave.

Za vsa pravila shranjevanja glejte [Shranjevanje](https://blockstudio.dev/sl/docs/blocks/storage/).

## Vsebina datotek ostane nespremenjena

Cevovod HTML v bloke ohrani več izvirne strukture:

- Ugnezdeni seznami postanejo notranji bloki seznama v nadrejenih elementih. Ohranijo se razredi seznamov in elementov; običajni enonivojski seznami se še naprej izpisujejo kot prej.
- `main`, `header`, `footer`, `article` in `aside` postanejo skupinski bloki, ki ohranijo svoj element, namesto da bi ustvarili surovi HTML, ki zaobide upodabljanje blokov.
- Preslikani odstavki z obogatenim besedilom ohranijo vrstično oznako, odstavki samo s slikami pa se razrešijo v preslikani slikovni blok; oznake kratkih kod ohranijo svojo vsebino.
- Ubežni atributi se enkrat razširijo in ubežno kodirajo, tudi atributi na `InnerBlocks`, `RichText` in elementu `useBlockProps`.
- Znaki za večje od znotraj narekovajev atributov samozapiralnih oznak so sprejeti.
- Globalni atributi HTML dosežejo korenski element bloka Blockstudio, če blok zanje ne določa polj. `wp bs pages sync` izpiše shranjene atribute, ki niso upodobljeni.

Strani, vzorci in predloge urejevalnika spletnega mesta, ki temeljijo na Blade, se zdaj upodabljajo prek `Blockstudio\Blade_Renderer` in podpirajo `illuminate/view` od različice 8 do 12. Registrirajo se vse razširitvene datoteke, ki ciljajo na isti blok, njihova prednostna vrednost, polja skupin in seznami ciljev pa sledijo dokumentirani shemi.

Spremljajo se tudi ugnezdene odvisnosti SCSS. Če uredite delno predlogo, ki jo uvozi druga delna predloga, se spremeni različica odvisne slogovne datoteke in sproži se ponovno prevajanje.

## Izboljšave za PHPStan

Ločeno nameščeni paket `blockstudio/phpstan` razširi preverjanje oznak blokov na oznake s predponami in vzdevki, preslikane elemente strani, postavitve, priložene bloke UI ter po izbiri tudi druge vire PHP projekta. Razreševanje imenskih prostorov se ujema z izvajalnim okoljem, tudi pri imenskih prostorih z vezaji, sprejeti pa so tudi posredovani globalni atributi HTML.

Spremenljivke predlog blokov, kot so `$a`, `$block` in `$context`, obravnava Blockstudio kot definirane. Vrste polj se ohranijo pri združevanju z ničelno vrednostjo in `isset()` v različici PHPStan 2.3, medtem ko predloga, ki dodeli svoj `$a`, ohrani dodeljeno vrsto.

Te spremembe so vključene v `blockstudio/phpstan` 0.1.9. Paket posodobite ločeno od vtičnika; zahteva PHPStan 2.1.47 ali novejši:

```bash
composer require --dev blockstudio/phpstan:^0.1.9
```

Za konfiguracijo in prednastavitve analize glejte [PHPStan](https://blockstudio.dev/sl/docs/dev/phpstan/).

## Dostopnost in prevodi

Sprožilniki priloženih komponent UI razkrijejo stanje razširitve na dejanskem gumbu. Oznake potrditvenih polj, stikal in izbirnih gumbov poimenujejo njihove kontrolnike in omogočajo njihovo preklapljanje. Krmarjenje po drobtinicah, ostranjevanje, navigacijski meniji in tabele med seznami ali tabelami ter njihovimi elementi ne vstavljajo več neveljavnih ovojnih elementov.

Preklopniki gesel razkrijejo stanje pritiska in imajo večje območje klika. Vnosi sprejemajo `autocomplete`, vnosi za gesla pa omogočajo izrecno nastavitev ID-ja in dostopne oznake. Pogledi vrtiljaka lahko prejmejo fokus s tipkovnico, animacije kazalnika nalaganja in nadomestnih okostij pa upoštevajo nastavitve za zmanjšano gibanje.

Urejevalnik in skrbniški pregled naložita nameščene prevode JavaScript za besedilno domeno `blockstudio`. Meni atributov in označbe mest, dejanja v pojavnem oknu kode ter značke slik in datotek je zdaj mogoče prevajati. Nizi brez prevoda ostanejo v angleščini.

Glejte knjižnico [UI](https://blockstudio.dev/sl/ui/) in [nastavitev prevodov](https://blockstudio.dev/sl/docs/general/getting-started/#translations).

## Dokumentacija in nadgradnja

Dokumentacija dodaja vodnike za dokumentacijska spletna mesta, Content Sync, predloge Site Editorja, oznake blokov, otoke, vrste polj po meri, uvajanje, predizrisovanje, nastavitev registra, orodja za analizo in zaslone aplikacije UI. Vodnik za selitev ACF upošteva aktualno registracijo ACF in povezave blokov.

Primeri za Custom populate zdaj uporabljajo podprti filter z enim argumentom in poimenovanim naborom podatkov. Dokumentacija o sredstvih pojasnjuje vrstni red slogovnih datotek na sprednjem delu in nalaganje preglasitev teme za CSS bloka. Namestitve za sodelavce uporabljajo javni paket Font Awesome brez poverilnic registra.

PHP 8.2 in WordPress 6.7 ostajata minimalni zahtevi. Navidezne poti in novi ukazi za vzdrževanje so na voljo brez spreminjanja obstoječih zbirk strani. Preglejte zgornja pravila za shranjevanje možnosti, posodobite ločeni paket PHPStan, če ga uporabljate, ter še naprej izrecno izvajajte sinhronizacijo strani kot doslej.

### 7.7.1 Nadaljnje spremljanje

Popravek 7.7.1 naredi rezultate sinhronizacije jasnejše in varnejše. Združevanje po ključu, ki objave ne spremeni, ne ustvari več nove revizije ali posodobi časovnega žiga spremembe. Obstoječa stanja objave se ohranijo, zamenjave naslova in polža, ki ju določa datoteka, so prikazane, zaklenjene ali odstranjene strani pa so navedene v poročilu CLI. Content Sync označi telesa, ki jih upravlja Page Sync, in ohrani obstoječe kopije za pregled. Popravek tudi zaščiti atribute, ki jih upravlja WordPress, pred nasprotujočimi se ID-ji polj ter ohrani razrede urejevalnika, ki jih dodajo drugi filtri.
