
Blockstudio 7.7 versijoje įdiegti virtualūs maršrutai dokumentams be WordPress įrašo, patobulintas tikslinis išankstinis generavimas, o esamų blokų redagavimas ir atvaizdavimas tapo patikimesni. Taip pat išplėstos PHPStan blokų žymų patikros ir pagerintas visų kartu pateikiamų UI komponentų prieinamumas.

Darbo eiga, kurioje pirmiausia naudojami failai, nesikeičia. Blokai atvaizduojami pagal savo šablonus, o failuose saugomi puslapiai keičiami tik aiškiai iškvietus CLI arba API sinchronizavimą. Šiame leidime automatinis puslapių sinchronizavimas lankytojų ar administravimo užklausų metu neįdiegtas.

Trumpai:

- **Virtualūs maršrutai**: pateikite komponentų galeriją, katalogą ar kitą visą dokumentą nesukurdami įrašo ir nerašydami pasirinktinio peradresavimo apdorojimo kodo.
- **Tikslinis išankstinis generavimas**: HTTP komponavimo procesai įrašo kiekvieno puslapio naudojamus šaltinio failus, todėl per kitą komponavimą galima atvaizduoti tik paveiktus maršrutus.
- **Talpyklos įrašų saugojimas**: išsaugokite nebenaudojamus stilių lapus, kad jie būtų pasiekiami talpykloje esantiems puslapiams, ir peržiūrėkite arba išvalykite nenaudojamus išankstinio pateikimo žemėlapio įrašus.
- **Patikimesnis redaktorius**: kartu pažymėti blokai išsaugo savo reikšmes, RichText ir šoninės juostos laukų pakeitimus galima atšaukti ir grąžinti, o paveldėtas kontekstas lieka susietas su reikiamu bloku.
- **Ištikimas failų turinys**: įdėtiniai sąrašai, skaidymo į sekcijas elementai, įterptinis HTML, trumposios žymos ir ekranuoti atributai išsaugomi analizės ir atvaizdavimo metu.
- **PHPStan patobulinimai**: prefiksų žymos, slapyvardžiai, susieti puslapio elementai ir šablonų kintamieji tikrinami pagal paties projekto apibrėžtis.
- **Prieinami UI komponentai**: valdikliai teisingai atskleidžia savo būseną, etiketės perjungia reikiamą įvesties lauką, o sąrašų ir lentelių komponentuose naudojama tinkama HTML struktūra.
- **Vertimai**: redaktoriuje ir administravimo apžvalgoje įkeliami įdiegti JavaScript vertimai, įskaitant anksčiau neišverstus laukų valdiklius.

## Virtualūs maršrutai

Kai kurie puslapiai kuriami iš duomenų, o ne redaktoriuje sukurto įrašo. Pavyzdžiui, komponento aprašui gali reikėti atskiro URL ir dokumento pavadinimo, bet jokio įrašo `wp_posts`.

Užregistruokite dokumentą naudodami `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']
    );
});
```

Maršrutas pateikia `/components/`. Jo iškvietimas vykdomas Blockstudio išvesties buferyje, todėl atvaizduojamiems blokams įprastu procesu pritaikomi jų stiliai, scenarijai, paketo UI ištekliai ir Tailwind išvestis. WordPress neatverčia atitikmens radusio maršruto į 404 ir neperadresuoja jo į įrašą.

URL grupę apibrėžkite nustatydami `prefix` į `true` ir pateikdami `match` iškvietimą. Iškvietimui perduodamas maršruto dalies kelias; jis grąžina reikšmę, kurios reikia atvaizduokliui. Grąžinus `null` arba `false`, užklausa paliekama WordPress. Naudokite `urls`, kad nurodytumėte kelius, kuriuos reikia įtraukti į statinio išankstinio generavimo procesą. Vieno maršruto be prefikso kelias įtraukiamas pagal numatytuosius nustatymus.

`Virtual_Routes::urls()` pateikia absoliučiuosius URL adresus integracijoms, kurios sudaro svetainės schemą. Virtualūs dokumentai automatiškai neįtraukiami į WordPress įrašų svetainės schemą.

Visą API ir parinktis rasite skirsnyje [Virtualūs maršrutai](https://blockstudio.dev/lt/docs/pages-and-patterns/pages/#virtual-routes).

## Tikslesni išankstinio generavimo procesai

Dabar grafiniu režimu vykdomi komponavimo procesai, atliekami per HTTP, įrašo kiekvieno maršruto naudotus failus: šabloną WordPress, atvaizduotų blokų šablonus ir išteklius, failais apibrėžtus puslapius bei maketus ir priklausomybes, pridėtas per `blockstudio/render/dependencies`.

Kito komponavimo metu `build_plan()` palygina šias priklausomybes. Pakeitus bloko šabloną, iš naujo atvaizduojami su juo susiję maršrutai, o visų nesusijusių puslapių generuoti nereikia. Bendrosios konfigūracijos pakeitimai vis dar turi įtakos visam procesui, o nauji arba nebegaliojantys maršrutai atvaizduojami kaip ir anksčiau.

Duomenų bazėje atlikti pakeitimai nelaikomi priklausomybėmis nuo failų. Jei diegiant reikia įtraukti parinktį, įrašą ar kitą duomenų bazės reikšmę, reikia priverstinai paleisti komponavimo procesą arba aiškiai atvaizduoti paveiktus URL adresus.

Leidime taip pat ištaisytos problemos, dėl kurių komponavimo proceso tapatybė keisdavosi pirmo atvaizdavimo metu, ankstyvojo pateikimo žemėlapiai likdavo pasenę opkodų talpykloje, o galiojantys URL adresai būdavo atmetami vien dėl to, kad jų kelyje yra `search` arba `preview`. Užklausos Markdown, naudojančios `Accept: text/markdown`, apeina talpykloje saugomus HTML, o atitinkami atsakymai siunčia `Vary: Accept`.

Spręsdama, ar prijungti savo kablius, statinio išankstinio generavimo funkcija dabar paiso aktyvios temos užregistruotų filtrų. Tema gali išjungti šią funkciją ir ankstesnė nustatymų paieška jos vėl neįjungs.

Žr. [Statinis išankstinis generavimas](https://blockstudio.dev/lt/docs/production/static-prerendering/).

## Talpyklos įrašų saugojimas ir priežiūra

Talpykloje esantis HTML puslapis gali likti ilgiau nei vykdymo aplinkos tapatybė, pagal kurią buvo sukompiliuotas jo stilių lapas. `cache.namespaceGrace` nustato, kiek laiko nebenaudojamos vardų sritys išlieka prieinamos po to, kai valymas pirmą kartą aptinka, kad jos nebenaudojamos:

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

Šiame pavyzdyje nebenaudojami failai saugomi devynias dienas. Pagal numatytuosius nustatymus jie saugomi vieną dieną. Šiuo metu naudojamos vardų sritys ir vardų sritys, kuriose pateikiami įdiegti išankstinio generavimo artefaktai, nuo nebereikalingų išteklių valymo apsaugotos.

Ankstyvojo pateikimo žemėlapiui taip pat skirtos peržiūros ir valymo komandos:

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

Jos pateikia ir pašalina įrašus, susijusius su ištrintomis svetainėmis arba neegzistuojančiais aplankais. Ištrynus svetainę kelių svetainių aplinkoje, pašalinami ir jos įrašai. Nerasti maršrutų dokumentai nurodomi atskirai, todėl galiojantis svetainės įrašas nepašalinamas.

Saugojimo rekomendacijas rasite skirsnyje [Talpyklos naudojimas](https://blockstudio.dev/lt/docs/production/caching/), o komandas – skirsnyje [žemėlapio priežiūra](https://blockstudio.dev/lt/docs/production/static-prerendering/#warming-maintenance-and-observability).

## Patikimesnis redaktorius

Dabar redaguojant vieną iš kelių pažymėtų blokų atnaujinamas tik tas blokas. Išsaugant išlaikomas kiekvieno bloko turinys, raktai, metaduomenys ir užraktai, o atributai nebebūna kopijuojami tarp pažymėtų blokų.

RichText reikšmės saugomos tiesiogiai bloko atributuose, todėl Gutenberg gali įtraukti jas į pakeitimų atšaukimo ir grąžinimo istoriją. Šoninės juostos laukai naudoja tą pačią istoriją. `InnerBlocks templateLock="false"` perduodama kaip loginė reikšmė ir leidžia keisti turinį net tada, kai išorinė sritis užrakinta.

Atliekant pradinį išankstinį įkėlimą perduodamas redaguojamo įrašo ID ir tipas, todėl šablonai jau pirmą kartą atvaizduojant gali nuskaityti reikiamus metaduomenis. Vienodi antriniai blokai, esantys po skirtingais tėviniais blokais, išankstinio įkėlimo ir atvaizdavimo talpyklose išsaugo atskirą paveldėtą kontekstą. Pradinės užklausos metu pakeitus atributus ar kontekstą, peržiūra nebeatsilieka.

Blockstudio taip pat nebeįterpia paslėptų atvaizdavimo žymeklių tarp blokų šakninių elementų. Gretimų elementų selektoriai, tokie kaip `.card + .card`, dabar redaktoriuje mato tokius pačius elementų ryšius kaip ir svetainės priekinėje dalyje, o redaktoriaus bei įterpiklio peržiūrų atvaizdavimas lieka atskiras.

## Saugesnis visos svetainės parinkčių saugojimas

Laukai, kurių reikšmės saugomos parinktyse, vis dar teikia visai svetainei skirtas reikšmes, tačiau įrašant įrašą nebėra aklai perrašomos visos išsaugotos šių laukų kopijos:

- Išsaugant juodraščius, laukiančius, privačius ir suplanuotus įrašus, aktyvios svetainės parinktys neįrašomos.
- Išsaugant paskelbtus įrašus, įrašomi tie pateikti laukai, kurie buvo pakeisti atliekant šį redagavimą.
- Išsaugant vien pavadinimo pakeitimą senoje kopijoje, naujesnė visos svetainės reikšmė negrąžinama į seną.
- Trūkstami laukai ir pašalinti blokai nepanaikina esamų parinkčių.
- Aiškiai nurodžius `null`, parinktis pašalinama. Tuščios eilutės, `false`, nulis ir tušti masyvai lieka galiojančiomis reikšmėmis.

Tai pagrindinis elgsenos pakeitimas, į kurį reikia atkreipti dėmesį naujinant versiją. Jei integracija naudojo privatų arba juodraštinį įrašą aktyviai parinkčiai atnaujinti, įrašykite tą parinktį aiškiai arba naudokite paskelbtą konfigūracijos įrašą. Apribojimas rašyti tik paskelbus neturi įtakos įrašo metaduomenų saugojimui.

Visas įrašymo taisykles rasite skirsnyje [Saugojimas](https://blockstudio.dev/lt/docs/blocks/storage/).

## Failų turinys išsaugomas

Daugiau jūsų parašytos struktūros išsaugoma konvertuojant HTML į blokus:

- Įdėtiniai sąrašai tampa vidiniais jų tėvinio elemento sąrašo blokais. Išsaugomos sąrašų ir elementų klasės; paprasti plokšti sąrašai išvedami kaip anksčiau.
- `main`, `header`, `footer`, `article` ir `aside` tampa grupių blokais, kuriuose išsaugomas jų elementas, užuot palikus neapdorotą HTML, apeinantį blokų atvaizdavimą.
- Susietos raiškiojo teksto pastraipos išsaugo įterptinį žymėjimą, vien vaizdų pastraipos susiejamos su vaizdo bloku, o trumpųjų žymų tekstas išsaugomas.
- Ekranuoti atributai dekoduojami ir iš naujo ekranuojami vieną kartą, taip pat atributai, priklausantys `InnerBlocks`, `RichText` ir elementui `useBlockProps`.
- Didesnysis ženklas cituojamuose savaime užsidarančios žymos atributuose priimamas.
- Visuotiniai HTML atributai perduodami į Blockstudio bloko šakninį elementą, jei blokas jų neapibrėžia kaip laukų. `wp bs pages sync` pateikia išsaugotus atributus, kurie neatvaizduojami.

Puslapiai, paremti Blade, šablonai ir Svetainės redaktoriaus šablonai dabar atvaizduojami per `Blockstudio\Blade_Renderer`; palaikomos versijos nuo `illuminate/view` 8 iki 12. Užregistruojami visi plėtinio failai, skirti tam pačiam blokui, o jų prioritetas, grupių laukai ir tikslinių elementų sąrašai atitinka dokumentuotą schemą.

Taip pat sekamos įdėtinės SCSS priklausomybės. Redaguojant dalinį šabloną, kurį importuoja kitas dalinis šablonas, pakeičiama priklausomo stilių lapo versija ir pradedamas perkompiliavimas.

## PHPStan patobulinimai

Atskirai įdiegiamas paketas `blockstudio/phpstan` išplečia blokų žymų tikrinimą, įtraukdamas prefiksų ir slapyvardžių žymas, susietus puslapio elementus, maketus, kartu pateikiamus UI blokus ir pasirinktinai kitus projekto PHP šaltinius. Vardų sritys išsprendžiamos kaip ir vykdymo aplinkoje, įskaitant tas, kurių pavadinimuose yra brūkšnelių; priimami ir perduoti visuotiniai HTML atributai.

Laikoma, kad bloko šablono kintamuosius, pavyzdžiui, `$a`, `$block` ir `$context`, apibrėžia Blockstudio. Laukų tipai išsaugomi naudojant null koalescing ir `isset()` su PHPStan 2.3, o šablonui priskyrus savo `$a`, išsaugomas jo priskirtas tipas.

Šie pakeitimai pateikiami kartu su `blockstudio/phpstan` 0.1.9. Atnaujinkite paketą atskirai nuo įskiepio; jam reikalinga PHPStan 2.1.47 arba naujesnė versija:

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

Konfigūraciją ir analizės išankstinius nustatymus rasite skirsnyje [PHPStan](https://blockstudio.dev/lt/docs/dev/phpstan/).

## Prieinamumas ir vertimai

Kartu pateikiamų UI perjungiklių išplėtimo būsena nurodoma pačiame mygtuke. Žymimųjų langelių, jungiklių ir pasirinkimo mygtukų etiketėse įvardijami valdikliai ir jas paspaudus valdikliai perjungiami. Naršymo kelio, puslapiavimo, naršymo meniu ir lentelių komponentuose nebėra įterpiama netinkamų apgaubiančių elementų tarp sąrašų ar lentelių ir jų vaikinių elementų.

Slaptažodžio matomumo perjungikliai nurodo paspaustą būseną ir turi didesnę spustelėjimo sritį. Įvesties laukams galima nurodyti `autocomplete`, o slaptažodžio įvesties laukams – aiškų ID ir prieinamą etiketę. Karuselės peržiūros sritis galima fokusuoti klaviatūra, o suktuko ir karkaso animacijos paiso sumažinto judesio nuostatų.

Redaktoriuje ir administravimo apžvalgoje įkeliami įdiegti JavaScript vertimai, skirti teksto sričiai `blockstudio`. Dabar galima versti atributų meniu ir vietos žymas, kodo iškylančiojo lango veiksmus, vaizdų ir failų ženklelius. Nepervestos eilutės paliekamos anglų kalba.

Žr. biblioteką [UI](https://blockstudio.dev/lt/ui/) ir [vertimo sąranką](https://blockstudio.dev/lt/docs/general/getting-started/#translations).

## Dokumentacija ir naujovinimas

Dokumentacijoje pateikiami vadovai apie dokumentacijos svetaines, Content Sync, svetainių redaktoriaus šablonus, blokų žymas, salas, pasirinktinius laukų tipus, diegimą, išankstinį generavimą, registro sąranką, analizės įrankius ir UI programėlės ekranus. ACF migravimo vadove atsižvelgiama į dabartinę ACF registraciją ir blokų susiejimus.

Pasirinktinio užpildymo pavyzdžiuose dabar naudojamas palaikomas vieno argumento filtras su pavadintu duomenų rinkiniu. Išteklių dokumentacijoje paaiškinama išorinių stilių lentelių tvarka ir kaip įkelti temos perrašymus po blokų CSS. Bendradarbiams skirtose diegimo instrukcijose naudojamas viešas Font Awesome paketas be registro prisijungimo duomenų.

PHP 8.2 ir WordPress 6.7 išlieka minimaliais reikalavimais. Virtualūs maršrutai ir naujos priežiūros komandos pasiekiami nekeičiant esamų puslapių kolekcijų. Peržiūrėkite anksčiau pateiktas parinkčių saugojimo taisykles, atnaujinkite atskirą PHPStan paketą, jei jį naudojate, ir toliau aiškiai vykdykite puslapių sinchronizavimą, kaip ir anksčiau.

### 7.7.1 Tolesni veiksmai

7.7.1 pataisoje sinchronizavimo rezultatai pateikiami aiškiau ir saugiau. Sujungus pagal raktą, jei įrašas nepasikeičia, nebekuriama nauja versija ir neatnaujinama jo keitimo laiko žyma. Esami publikavimo būsenos nustatymai išsaugomi, pranešama apie failų valdomų pavadinimų ir nuorodų dalių pakeitimus, o užrakinti arba pašalinti puslapiai įvardijami CLI ataskaitoje. „Content Sync“ pažymi „Page Sync“ valdomus turinius ir išsaugo esamas peržiūros kopijas. Pataisa taip pat apsaugo WordPress valdomus atributus nuo konfliktuojančių laukų ID ir išsaugo redaktoriaus klases, kurias pridėjo kiti filtrai.
