
Blockstudio 7.7 lisab virtuaalsed marsruudid dokumentidele, millel puudub WordPress postitus, parandab sihitud eelpäranduse ehitusi ning muudab olemasolevate plokkide redigeerimise ja renderdamise töökindlamaks. Samuti laiendab see PHPStan plokisiltide kontrolle ja parandab ligipääsetavust komplekti kuuluvates UI komponentides.

Failipõhine töövoog jääb samaks. Plokid renderdatakse nende mallidest ning failipõhised lehed muutuvad ainult selgesõnalise CLI või API sünkroonimise kaudu. See väljalase ei lisa automaatset lehtede sünkroonimist külastaja ega halduri päringute korral.

Lühidalt:

- **Virtuaalsed marsruudid**: esita komponentide galerii, kataloog või muu terviklik dokument ilma postitust loomata või kohandatud ümbersuunamise töötlejat kirjutamata.
- **Sihitud eelpäranduse ehitused**: HTTP ehitused salvestavad iga lehe kasutatud lähtefailid, et järgmine ehitus saaks renderdada ainult mõjutatud marsruudid.
- **Vahemälu säilitamine**: hoia kasutuselt kõrvaldatud laaditabelid vahemällu salvestatud lehtede jaoks alles ning vaata üle või kärbi kasutamata varase teenindamise kaardikirjed.
- **Redaktori töökindlus**: mitme valitud ploki väärtused jäävad eraldi, RichTexti ja külgriba väljade puhul toimivad tagasivõtmine ja uuesti tegemine ning päritud kontekst jääb õige ploki juurde.
- **Failisisu täpsus**: pesastatud loendid, sektsioonielemendid, tekstisisene HTML, lühikoodid ja paomärgistatud atribuudid säilivad parsimisel ja renderdamisel.
- **PHPStan täiustused**: eesliitesildid, aliased, vastendatud leheelemendid ja mallimuutujad kontrollitakse projekti enda definitsioonide järgi.
- **Ligipääsetav UI**: juhtelemendid esitavad oma oleku õigesti, sildid lülitavad õige sisendi sisse ning loendi- ja tabelikomponendid kasutavad kehtivat HTML struktuuri.
- **Tõlked**: paigaldatud JavaScript tõlked laaditakse redaktoris ja halduri ülevaates, sealhulgas varem tõlkimata väljade juhtelementide jaoks.

## Virtuaalsed marsruudid

Mõned lehed pärinevad andmetest, mitte redaktori hallatavast postitusest. Näiteks võib komponendi viiteleht vajada oma URL ja dokumendi pealkirja, kuid mitte kirjet jaotises `wp_posts`.

Registreeri see dokument käsuga `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']
    );
});
```

Marsruut esitab `/components/`. Selle tagasihelistusfunktsioon käivitub Blockstudio väljundpuhvris, nii et renderdatud plokid saavad oma laaditabelid, skriptid, komplekti kuuluvad UI varad ja Tailwind väljundi tavapärase töövoo kaudu. WordPress ei muuda sobitatud marsruuti 404-ks ega suuna seda postitusele.

URL-ide perekonna jaoks määra `prefix` väärtuseks `true` ja esita `match` tagasihelistusfunktsioon. Funktsioon saab marsruudile järgneva tee ja tagastab väärtuse, mida renderdaja vajab. Väärtuse `null` või `false` tagastamine jätab päringu WordPress hooleks. Staatilise eelpäranduse ehitusse kaasatavate teede loetlemiseks kasuta `urls`. Üksik, eesliiteta marsruut kaasab vaikimisi oma tee.

`Virtual_Routes::urls()` tagastab absoluutsed URL-id integratsioonidele, mis koostavad saidikaarti. See ei lisa virtuaaldokumente automaatselt WordPress postituste saidikaardile.

Täieliku API ja valikute kohta vaata teemat [virtuaalsed marsruudid](https://blockstudio.dev/et/docs/pages-and-patterns/pages/#virtual-routes).

## Täpsemad eelpäranduse ehitused

Graafirežiimi ehitused, mis renderdati üle HTTP, salvestavad nüüd iga marsruudi kasutatud failid: mall WordPress, renderdatud plokimallid ja varad, faililehe definitsioonid ning paigutused, samuti sõltuvused, mis lisati `blockstudio/render/dependencies` kaudu.

Järgmisel ehitusel võrdleb `build_plan()` neid sõltuvusi. Plokimalli muutmine märgib renderdamiseks selle sõltuvad marsruudid, ilma et kõiki sõltumatuid lehti uuesti ehitataks. Jagatud konfiguratsiooni muudatused mõjutavad endiselt kogu ehitust ning uusi või aegunud marsruute renderdatakse nagu varem.

Ainult andmebaasis tehtud muudatused ei ole failisõltuvused. Kui juurutamisel on vaja kasutusele võtta suvand, postitus või muu andmebaasiväärtus, tuleb ehitus sundida või mõjutatud URL-id selgesõnaliselt renderdada.

Väljalase parandab ka ehituse identiteedi muutumist esimese renderduse ajal, aegunud operatsioonikoodiga vahemällu salvestatud varase teenindamise kaardid ning kehtivate URL-ide välistamise pelgalt seepärast, et nende tee sisaldab `search` või `preview`. Markdown päringud, mis kasutavad `Accept: text/markdown`, jätavad vahemällu salvestatud HTML vahele ning asjakohased vastused saadavad `Vary: Accept`.

Staatiline eelpärendus arvestab nüüd aktiivse teema registreeritud filtritega, kui otsustab, kas oma konksud lisada. Teema saab funktsiooni välja lülitada, ilma et varasem seadete otsing selle aktiivseks jätaks.

Vaata teemat [Staatiline eelpärendus](https://blockstudio.dev/et/docs/production/static-prerendering/).

## Vahemälu säilitamine ja hooldus

Vahemällu salvestatud HTML leht võib jääda alles kauemaks, kui selle laaditabeli kompileerinud käitusaja identiteet. `cache.namespaceGrace` määrab, kui kaua kasutuselt kõrvaldatud nimeruumid pärast nende kõrvaldamise esmakordset tuvastamist kättesaadavaks jäävad:

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

See näide säilitab kasutuselt kõrvaldatud faile üheksa päeva. Vaikimisi on säilitusaeg üks päev. Aktiivsed nimeruumid ja juurutatud eelpäranduse artefakte teenindavad nimeruumid on eemaldamise eest kaitstud.

Varase teenindamise kaardil on ka kontrolli- ja puhastuskäsud:

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

Need annavad aru kustutatud saitide või puuduvate kataloogide kirjete kohta ning eemaldavad need. Mitme saidiga paigalduses kustutatud sait kaotab samuti oma kirjed. Puuduvate marsruudidokumentide kohta antakse eraldi teada, selle asemel et kehtiv saidikirje tervikuna eemaldada.

Säilitamisjuhised leiad teemast [Vahemällu salvestamine](https://blockstudio.dev/et/docs/production/caching/) ja käsud teemast [kaardi hooldus](https://blockstudio.dev/et/docs/production/static-prerendering/#warming-maintenance-and-observability).

## Töökindlam redaktor

Mitme valitud ploki redigeerimine uuendab nüüd ainult seda plokki. Salvestamisel säilivad iga ploki enda sisu, võtmed, metaandmed ja lukud, selle asemel et atribuute valitud plokkide vahel kopeerida.

RichTexti väärtused asuvad otse ploki atribuutides, nii et Gutenberg saab need kaasata tagasivõtmisse ja uuesti tegemisse. Külgriba väljad osalevad samas ajaloos. `InnerBlocks templateLock="false"` edastatakse tõeväärtusena ja see avab sisu ka siis, kui välimine ala on lukus.

Esialgsed eellaadimised saavad redigeeritava postituse ID ja tüübi, et mallid saaksid esimesel renderdamisel lugeda õigeid metaandmeid. Erinevate ülemplokkide all olevad identsed alamplokid säilitavad eellaadimistes ja renderdusvahemäludes eraldi päritud konteksti. Atribuudi või konteksti muutmine esialgse päringu ajal ei jäta enam eelvaadet maha.

Blockstudio ei lisa enam plokkide juurelementide vahele peidetud renderdusmärgise elemente. Kõrvuti elementide valijad, näiteks `.card + .card`, näevad nüüd redaktoris samu elementide suhteid mis esiosas, samal ajal kui redaktori ja ploki lisaja eelvaate renderdused jäävad eraldi.

## Saidiülene turvalisem suvandite salvestamine

Suvanditega seotud väljad pakuvad endiselt saidiüleseid väärtusi, kuid postituse salvestamisel ei kirjutata enam pimesi kõiki nende väljade salvestatud koopiaid:

- Mustandi, ootel, privaatse ja ajastatud postituse salvestamine ei kirjuta aktiivseid saidi suvandeid.
- Avaldatud postituse salvestamine kirjutab need esitatud väljad, mida selle muutmise käigus muudeti.
- Ainult pealkirja salvestamine vanast koopiast ei taasta saidiülese suvandi varasemat väärtust.
- Puuduvad väljad ja eemaldatud plokid ei kustuta olemasolevaid suvandeid.
- Selgesõnaline `null` eemaldab suvandi. Tühjad stringid, `false`, null ja tühjad massiivid jäävad kehtivateks väärtusteks.

Uuendamisel tuleb kõigepealt kontrollida seda peamist käitumismuudatust. Kui integratsioon kasutas aktiivse suvandi muutmiseks privaatset või mustandpostitust, kirjuta see suvand selgesõnaliselt või kasuta selle asemel avaldatud konfiguratsioonipostitust. Posti metaandmete salvestamist avaldamispiirang ei mõjuta.

Täielikud salvestusreeglid leiad teemast [Salvestamine](https://blockstudio.dev/et/docs/blocks/storage/).

## Failisisu säilib

HTML-plokkideks töövoog säilitab rohkem sinu kirjutatud struktuurist:

- Pesastatud loenditest saavad ülemüksuse elemendi sisemised loendiplokid. Säilivad loendi ja elementide klassid; tavaliste lamedate loendite väljund ei muutu.
- `main`, `header`, `footer`, `article` ja `aside` muutuvad grupiplokkideks, mis säilitavad oma elemendi, selle asemel et jätta need töötlemata kujule HTML, mis väldib plokkide renderdamist.
- Vastendatud rikasteksti lõigud säilitavad tekstisisese märgistuse, ainult pildist koosnevad lõigud teisendatakse vastendatud pildiplokiks ning lühikoodisildid säilitavad oma sisu.
- Paomärgistatud atribuudid dekodeeritakse ja paomärgistatakse ühe korra, sealhulgas atribuudid elementidel `InnerBlocks`, `RichText` ja elemendil `useBlockProps`.
- Tsiteeritud isesulguvate siltide atribuutides olevad suurem-kui-märgid on lubatud.
- Globaalsed HTML atribuudid jõuavad ploki Blockstudio juurelemendini, kui plokk ei deklareeri neid väljadena. `wp bs pages sync` annab teada salvestatud atribuutidest, mida ei renderdata.

Blade-põhised lehed, mustrid ja saidiredaktori mallid renderdatakse nüüd `Blockstudio\Blade_Renderer` kaudu, toetades versioone `illuminate/view` 8 kuni 12. Sama ploki laiendusfailid registreeritakse kõik ning nende prioriteet, rühmaväljad ja sihtloendid järgivad dokumenteeritud skeemi.

Jälgitakse ka pesastatud SCSS sõltuvusi. Teise osafaili imporditud osafaili muutmine muudab sõltuva laaditabeli versiooni ja käivitab uuesti kompileerimise.

## PHPStan täiustused

Eraldi paigaldatav pakett `blockstudio/phpstan` laiendab plokisiltide valideerimist eesliite- ja alias-siltidele, vastendatud leheelementidele, paigutustele, komplekti kuuluvatele UI plokkidele ning soovi korral ka muudele projekti PHP allikatele. Nimeruumide lahendamine vastab käitusajale, sealhulgas sidekriipse sisaldavate nimeruumide puhul, ning edastatud globaalsed HTML atribuudid aktsepteeritakse.

Plokimalli muutujaid, näiteks `$a`, `$block` ja `$context`, käsitleb Blockstudio defineeritutena. Väljade tüübid säilivad null-väärtuse korral vaikeväärtuse kasutamisel ja `isset()` all versioonis PHPStan 2.3; mall, mis määrab oma `$a`, säilitab sellele määratud tüübi.

Need muudatused sisalduvad paketis `blockstudio/phpstan` 0.1.9. Uuenda paketti pluginast eraldi; see nõuab versiooni PHPStan 2.1.47 või uuemat:

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

Konfigureerimise ja analüüsi eelseadistuste kohta vaata teemat [PHPStan](https://blockstudio.dev/et/docs/dev/phpstan/).

## Ligipääsetavus ja tõlked

Komplekti kuuluvad UI käivitajad näitavad laiendatud olekut tegelikul nupul. Märkeruudu, lüliti ja raadionupu sildid nimetavad juhtelemendid ja lülitavad need sisse või välja. Breadcrumbs-rajad, lehekülgede juhtnupud, navigeerimismenüüd ja tabelid ei lisa enam loendite ega tabelite ja nende laste vahele kehtetuid ümbritsevaid elemente.

Paroolilülitid näitavad vajutatud olekut ja nende klõpsuala on suurem. Sisendid aktsepteerivad `autocomplete` väärtust ning paroolisisenditele saab määrata selgesõnalise ID ja ligipääsetava sildi. Karusselli vaatealad saavad klaviatuurifookuse ning laaduri ja laadimisvaate animatsioonid arvestavad vähendatud liikumise eelistusega.

Redaktor ja halduri ülevaade laadivad paigaldatud JavaScript tõlked tekstidomeeni `blockstudio` jaoks. Atribuutide menüüd ja kohatäitjad, koodi hüpikakna toimingud ning pildi- ja failimärgid on nüüd tõlgitavad. Tõlketa stringid jäävad ingliskeelseks.

Vaata [UI teeki](https://blockstudio.dev/et/ui/) ja [tõlke seadistamist](https://blockstudio.dev/et/docs/general/getting-started/#translations).

## Dokumentatsioon ja uuendamine

Dokumentatsioon sisaldab juhendeid dokumentatsioonisaitide, Content Synci, Site Editori mallide, plokisiltide, saarte, kohandatud väljatüüpide, juurutamise, eeleelrenderdamise, registri seadistamise, analüüsitööriistade ja UI rakenduse vaadete kohta. ACF migreerimisjuhend kajastab praegust ACF registreerimist ja Block Bindingsit.

Kohandatud täitmise näidetes kasutatakse nüüd toetatud ühe argumendiga nimega andmestiku filtrit. Varade dokumentatsioon selgitab veebiliidese stiililehtede järjekorda ja seda, kuidas laadida teema ülekirjutused pärast ploki CSS. Kaastööliste paigaldustes kasutatakse avalikku Font Awesome'i paketti ilma registri mandaadita.

PHP 8.2 ja WordPress 6.7 jäävad miinimumnõueteks. Virtuaalsed marsruudid ja uued hoolduskäsud on saadaval olemasolevaid lehekogumeid muutmata. Vaadake üle ülaltoodud suvandite salvestamise reeglid, uuendage eraldi paketti PHPStan, kui seda kasutate, ja jätkake lehtede sünkroonimise selgesõnalist käivitamist nagu varem.

### 7.7.1 Järeltegevused

7.7.1 paiga tulemus on nüüd selgem ja turvalisem. Võtmega ühendamine, mis jätab postituse muutmata, ei loo enam uut redaktsiooni ega uuenda muutmise ajatemplit. Olemasolevad avaldamisolekud säilivad, faili hallatavate pealkirja- ja püsiviida asendustest antakse teada ning lukustatud või eemaldatud lehed nimetatakse aruandes CLI. Content Sync märgib Page Synci hallatavad sisutekstid ja säilitab olemasolevad koopiaülevaated. Paik kaitseb ka WordPress hallatavaid atribuute vastuoluliste välja-ID-de eest ja säilitab teiste filtrite lisatud redaktori klassid.
