Perėjimas prie v7
Šiame vadove aprašyti pakeitimai, kuriuos reikia atlikti naujinant iš Blockstudio 6 į 7.
ES modulių importai
Naujas prefiksas npm: (rekomenduojama)
Blockstudio 7 pristato naują prefiksą npm: ES modulių importams, suderintą su Denonpm specifikatoriaus konvencija.
Prieš (v6):
import { h, render } from "blockstudio/preact@10.15.1";
import htm from "blockstudio/htm@3.1.1";
import confetti from "blockstudio/canvas-confetti@1.6.0";
Po (v7):
import { h, render } from "npm:preact@10.15.1";
import htm from "npm:htm@3.1.1";
import confetti from "npm:canvas-confetti@1.6.0";
CSS importai
Tas pats pakeitimas taikomas ir CSS importams:
Prieš (v6):
import "blockstudio/swiper@11.0.0/swiper.min.css";
Po (v7):
import "npm:swiper@11.0.0/swiper.min.css";
Atgalinis suderinamumas
Prefiksas blockstudio/ vis dar palaikomas dėl atgalinio suderinamumo. Jūsų esamas kodas ir toliau veiks be pakeitimų. Vis dėlto rekomenduojame pereiti prie prefikso npm:, kad jis derėtų su platesne JavaScript ekosistema.
Prefiksas npm: turi keletą privalumų:
- Suderinamumas su ekosistema – Atitinka nusistovėjusią Deno konvenciją
- Aiškumas – Iš karto matyti, kad importuojate iš npm
- Parengtis ateičiai – Prefikso
blockstudio/gali būti atsisakyta būsimoje pagrindinėje versijoje
Kabliukų pavadinimai
Blockstudio 7 suvienodina visų PHP kabliukų pavadinimus: naudojamas snake_case, o ne camelCase, taip juos suderinant su WordPress pagrindinėmis konvencijomis.
Pakeisti kabliukų pavadinimai
| Senas pavadinimas (v6) | Naujas pavadinimas (v7) |
|---|---|
blockstudio/blocks/components/useblockprops/render |
blockstudio/blocks/components/use_block_props/render |
blockstudio/blocks/components/innerblocks/render |
blockstudio/blocks/components/inner_blocks/render |
blockstudio/blocks/components/innerblocks/frontend/wrap |
blockstudio/blocks/components/inner_blocks/frontend/wrap |
blockstudio/blocks/components/richtext/render |
blockstudio/blocks/components/rich_text/render |
blockstudio/assets/process/scss/importPaths |
blockstudio/assets/process/scss/import_paths |
blockstudio/settings/assets/process/scssFiles |
blockstudio/settings/assets/process/scss_files |
blockstudio/settings/editor/formatOnSave |
blockstudio/settings/editor/format_on_save |
blockstudio/settings/blockEditor/disableLoading |
blockstudio/settings/block_editor/disable_loading |
blockstudio/settings/blockEditor/cssClasses |
blockstudio/settings/block_editor/css_classes |
blockstudio/settings/blockEditor/cssVariables |
blockstudio/settings/block_editor/css_variables |
blockstudio/settings/ai/enableContextGeneration |
blockstudio/settings/ai/enable_context_generation |
Atgalinis suderinamumas
Senieji „camelCase“ kabliukų pavadinimai vis dar palaikomi dėl atgalinio suderinamumo. Jūsų esamas kodas ir toliau veiks be pakeitimų. Vis dėlto, siekiant nuoseklumo, rekomenduojame pereiti prie naujų „snake_case“ pavadinimų.
Perėjimo pavyzdys:
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
return ['my-stylesheet'];
});
// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
return ['my-stylesheet'];
});
Kanoninės blokų žymos
Blockstudio 7.6 ir toliau palaiko projektų prefiksus ir tikslius slapyvardžius kaip vykdymo aplinkos išplėtimo taškus, tačiau pavyzdžiuose, katalogo išvestyje, atvaizdavimo deklaracijose ir diagnostikoje naudoja <bs:namespace-slug> kaip kanoninę rašybą. Kanoninės žymos nurodo tikrąjį registruotą bloko pavadinimą ir nepriklauso nuo konkrečios aplinkos filtro.
Projektui, kuriame yra brand => ["theme-components"] ir ui => ["bsui"]:
<!-- Legacy project shorthand -->
<brand-card>
<ui-input />
</brand-card>
<!-- Canonical output -->
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Atskira perėjimo komanda inventorizuoja esamą projektą ir perrašo trumpinius kanonine rašyba. Pirmiausia pateikiama ataskaita, neišspręsti atvejai blokuoja procesą, keičiami tik žymų pavadinimai. Komandą, jos įvestis ir saugaus veikimo principus rasite puslapyje Blokų žymų perėjimas.
Išteklių failų pavadinimai
Blockstudio 7 pristato taškinę išteklių failų plėtinių žymėjimo notaciją, kuri rekomenduojama vietoj senosios brūkšninės notacijos.
Pakeisti failų pavadinimai
| Senas pavadinimas (v6) | Naujas pavadinimas (v7) |
|---|---|
*-inline.(s)css |
*.inline.(s)css |
*-inline.js |
*.inline.js |
*-editor.(s)css |
*.editor.(s)css |
*-editor.js |
*.editor.js |
*-scoped.(s)css |
*.scoped.(s)css |
*-view.js |
*.view.js |
Atgalinis suderinamumas
Senoji brūkšninė notacija vis dar palaikoma dėl atgalinio suderinamumo. Jūsų esami failai ir toliau veiks be pervadinimo. Vis dėlto naujiems blokams rekomenduojame pereiti prie taškinės notacijos.
Perėjimo pavyzdys:
my-block/
├── block.json
├── index.php
├── style.css
├── style-inline.css → style.inline.css
├── style-scoped.css → style.scoped.css
├── style-editor.css → style.editor.css
├── script.js
├── script-inline.js → script.inline.js
├── script-editor.js → script.editor.js
└── script-view.js → script.view.js
Lauko jungiklis
Savybės switch numatytoji reikšmė dabar yra false, o ne true. v6 kiekvienas laukas turėjo nematomą jungiklį kairiajame krašte, kuris pagal numatytuosius nustatymus buvo įjungtas. v7 jungiklis įjungiamas pasirinktinai, o lauko etiketėje rodoma akies piktograma.
Kas pasikeitė
- Numatytoji reikšmė dabar yra
false: laukai nebeturi jungiklio, nebent aiškiai nustatote"switch": true - Matoma akies piktograma: vietoj paslėptos spustelėjimo srities kairėje, etiketės srityje rodomas mygtukas su akies piktograma
- Išjungto lauko uždanga: išjungus lauką, rodoma suliejimo uždanga su tekstu „Šis laukas išjungtas“, o ne tik sumažinamas neskaidrumas
Perėjimas
Jei naudojote numatytąją jungiklio veikseną v6, turite ją įjungti aiškiai:
{
"id": "title",
"type": "text",
"label": "Title",
"switch": true
}
Jei anksčiau nustatėte "switch": false, kad išjungtumėte perjungimą, galite jį pašalinti, nes dabar numatytoji reikšmė yra false.
Tailwind CSS
Blockstudio 7 visiškai pakeičia v6 Tailwind metodą. v6 aplinkoje Tailwind CSS buvo kompiliuojamas kliento pusėje per redaktoriaus CDN ir įrašomas į diską išsaugojus įrašą. v7 aplinkoje Tailwind CSS kompiliuojamas serverio pusėje per kiekvieną sąsajos užklausą naudojant TailwindPHP, o failai automatiškai talpinami į podėlį.
Išsamią informaciją apie naująją sistemą rasite dokumentacijoje Tailwind CSS.
Nuolatinis kompiliavimas serverio pusėje
Kai tailwind.enabled yra true, kiekviena sąsajos užklausa kompiliuojama serverio pusėje. Kompiliavimo eiga:
- WordPress atvaizduoja visą puslapį HTML į išvesties buferį
- CSS klasių kandidatai ištraukiami iš HTML (greita regex paieška, be kompiliavimo)
- Kandidatai surūšiuojami ir maišos funkcija apdorojami kartu su konfigūracija CSS, kad būtų sukurtas podėlio raktas
- Radus podėlio įrašą: nuskaitomas podėlyje esantis failas CSS ir įterpiamas
- Neradus podėlio įrašo: TailwindPHP kompiliuoja CSS, įrašo jį į bendrinamą Blockstudio vykdymo aplinkos podėlį
tailwindsrityje ir įterpia
Kompiliuota CSS įterpiama kaip įterptinė <style id="blockstudio-tailwind"> žyma prieš </head>. Įtraukiama Tailwind pradinė parengtis ir visos atitinkančios pagalbinės klasės.
Scenarijus CDN redaktoriuje ir toliau naudojamas tik tiesioginei peržiūrai. Sąsajoje jis niekada nepateikiamas.
Pasikeitęs config formatas
Savybė config pakeista: vietoj objekto JSON (Tailwind v3) naudojama eilutė CSS (sintaksė Tailwind v4 CSS pirmiausia).
Prieš (v6):
{
"tailwind": {
"config": {
"theme": {
"extend": {
"colors": {
"primary": "pink"
}
}
}
}
}
}
Po (v7):
{
"tailwind": {
"config": "@theme { --color-primary: pink; }"
}
}
Pašalintas nustatymas customClasses
Masyvo nustatymas customClasses pašalintas. Taikant Tailwind v4 CSS pirmiausia metodą, pasirinktinės pagalbinės klasės tiesiogiai apibrėžiamos eilutėje config naudojant @layer utilities.
Prieš (v6):
{
"tailwind": {
"customClasses": [
{ "className": "btn", "value": "px-4 py-2 rounded-lg font-medium" },
{ "className": "card", "value": "bg-white rounded-xl shadow-lg p-6" }
]
}
}
Po (v7):
{
"tailwind": {
"config": "@layer utilities { .btn { @apply px-4 py-2 rounded-lg font-medium; } .card { @apply bg-white rounded-xl shadow-lg p-6; } }"
}
}
Arba naudokite filtrą kelių eilučių konfigūracijoms:
add_filter('blockstudio/settings/tailwind/config', function () {
return <<<CSS
@layer utilities {
.btn { @apply px-4 py-2 rounded-lg font-medium; }
.card { @apply bg-white rounded-xl shadow-lg p-6; }
}
CSS;
});
Filtras blockstudio/settings/tailwind/custom_classes taip pat pašalintas. Norėdami pridėti pasirinktines CSS taisykles, naudokite filtrą blockstudio/tailwind/css.
Pašalintas REST galinis taškas
Galinis taškas POST /blockstudio/v1/editor/tailwind/save pašalintas. Kompiliuota CSS nebėra išsaugoma iš redaktoriaus. Jei jūsų tinkintame kode buvo iškviečiamas šis galinis taškas, jį galima saugiai pašalinti.
Spartinimas
Blockstudio naudoja kandidatais pagrįstą spartinimo strategiją. Užuot apskaičiavus viso puslapio HTML maišą (dėl vienkartinių kodų ir laiko žymų podėlis būtų išvalomas su kiekviena užklausa), apskaičiuojami tik CSS klasių kandidatų maišai. Tai reiškia:
- Du puslapiai su tomis pačiomis CSS klasėmis naudoja tą patį podėlio failą
- Dinaminis turinys (vienkartiniai kodai, administravimo juostos, laiko žymos) neišvalo podėlio
- Podėlis atnaujinamas tik pasikeitus CSS klasių rinkiniui arba konfigūracijai
Podėlio failai saugomi sukonfigūruotame vykdymo aplinkos šakniniame kataloge Blockstudio, esančiame sites/{network-blog}/{runtime-identity}/tailwind/. Norėdami priverstinai kompiliuoti iš naujo, iškvieskite Blockstudio\Runtime_Cache::purge('tailwind').
Filtrų pakeitimai
| Senas pavadinimas (v6) | Naujas pavadinimas (v7) |
|---|---|
blockstudio/tailwind/on_demand/css |
blockstudio/tailwind/css |
blockstudio/tailwind/assets/dir |
Pašalintas |
blockstudio/settings/tailwind/custom_classes |
Pašalintas |
Pašalinti failai ir įkėlimai
v6 aplinkoje Tailwind CSS buvo įkeliamas kaip išoriniai stilių aprašai (blockstudio-tailwind, blockstudio-tailwind-preflight). v7 aplinkoje visas CSS įterpiamas tiesiogiai naudojant išvesties buferį. Sąsajoje nėra jokių Tailwind nuorodų žymų ar įkeliamų stilių aprašų.
Blokų biblioteka
Integruotoji biblioteka „Blockstudio Elements“ pašalinta. Nustatymas library aplinkoje blockstudio.json ir filtras blockstudio/settings/library nebeturi jokio poveikio.
Jei naudojote bibliotekos blokus (Gallery, Slider, Image Comparison, Code, Icon), nukopijuokite blokų aplankus iš savo v6 diegimo katalogo includes/library/blockstudio-element/ į temos blockstudio katalogą ir atnaujinkite jų failus block.json, įrašydami naujus pavadinimus ir kategorijas.