Üleminek versioonile v7
See juhend käsitleb muudatusi, mida peate tegema versioonilt Blockstudio 6 versioonile 7 üle minnes.
ES-mooduli impordid
Uus eesliide npm: (soovitatav)
Blockstudio 7 tutvustab ES-moodulite importide jaoks uut eesliidet npm:, mis ühtlustab need Deno npm-spetsiifika tavaga.
Enne (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";
Pärast (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 impordid
Sama muudatus kehtib ka CSS importide kohta:
Enne (v6):
import "blockstudio/swiper@11.0.0/swiper.min.css";
Pärast (v7):
import "npm:swiper@11.0.0/swiper.min.css";
Tagasiühilduvus
Eesliidet blockstudio/ toetatakse tagasiühilduvuse tagamiseks endiselt. Teie olemasolev kood töötab edasi muutmata kujul. Järjepidevuse huvides soovitame siiski üle minna eesliitele npm:, mis sobitub laiemalt JavaScript ökosüsteemi tavadega.
Eesliitel npm: on mitu eelist:
- Ökosüsteemiga kooskõla – järgib Deno väljakujunenud tava
- Selgus – näitab kohe, et impordite moodulist npm
- Tulevikukindlus – eesliide
blockstudio/võidakse tulevases põhiversioonis aegunuks märkida
Hook’ide nimed
Blockstudio 7 ühtlustab kõik PHP hook’ide nimed: camelCase asemel kasutatakse snake_case, järgides WordPress tuuma tavasid.
Muutunud hook’ide nimed
| Vana nimi (v6) | Uus nimi (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 |
Tagasiühilduvus
Vanad camelCase-hook’ide nimed on tagasiühilduvuse tagamiseks endiselt toetatud. Teie olemasolev kood töötab edasi muutmata kujul. Järjepidevuse huvides soovitame siiski üle minna uutele snake_case-nimedele.
Ülemineku näide:
// 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'];
});
Kanoonilised plokisildid
Blockstudio 7.6 säilitab projektide eesliited ja täpsed aliasnimed käitusaja laienduspunktidena, kuid kasutab näidetes, kataloogi väljundis, renderdusdeklaratsioonides ja diagnostikas kanoonilise kirjapildina <bs:namespace-slug>. Kanoonilised sildid sisaldavad ploki tegelikku registreeritud nime ega sõltu hostipõhisest filtrist.
Projektis, kus on brand => ["theme-components"] ja ui => ["bsui"]:
<!-- Legacy project shorthand -->
<brand-card>
<ui-input />
</brand-card>
<!-- Canonical output -->
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Eraldiseisev üleminekukäsk loetleb olemasoleva projekti sisu ja kirjutab lühivormid kanoonilisel kujul ümber. See esitab esmalt aruande, peatub lahendamata juhtude korral ja muudab ainult silte. Käsu, sisendite ja ohutu käitumise kohta leiate teavet jaotisest Plokisiltide üleminek.
Varafailide nimetamine
Blockstudio 7 võtab kasutusele varafailide järelliidete punktkirja, mis asendab soovitatava tavanina vana sidekriipsukirja.
Muutunud failinimed
| Vana nimi (v6) | Uus nimi (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 |
Tagasiühilduvus
Vana sidekriipsukiri on tagasiühilduvuse tagamiseks endiselt toetatud. Teie olemasolevad failid töötavad edasi ka ilma ümbernimetamiseta. Uute plokkide puhul soovitame siiski kasutada punktkirja.
Ülemineku näide:
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
Väljalüliti
Atribuudi switch vaikeväärtus on nüüd false, mitte true. Versioonis v6 oli igal väljal vasakus servas vaikimisi sisse lülitatud nähtamatu lüliti. Versioonis v7 on lüliti valikuline ja selle asemel kuvatakse välja sildil nähtav silmaikoon.
Mis muutus
- Vaikeväärtus on nüüd
false: väljadel pole enam lülitit, kui te ei määra sõnaselgelt"switch": true - Nähtav silmaikoon: peidetud vasakpoolse klõpsuala asemel kuvatakse sildialal silmaikooniga nupp
- Keelatud välja ülekate: kui väli on keelatud, kuvatakse üksnes läbipaistvuse vähendamise asemel hägustav ülekate tekstiga "See väli on keelatud"
Üleminek
Kui kasutasite versioonis v6 lülitit vaikeväärtuse põhjal, peate selle sõnaselgelt lubama:
{
"id": "title",
"type": "text",
"label": "Title",
"switch": true
}
Kui määrasite varem "switch": false lüliti keelamiseks, võite selle eemaldada, sest nüüd on vaikeväärtus false.
Tailwind CSS
Blockstudio 7 asendab täielikult lähenemisviisi v6 Tailwind. v6-s kompileeriti Tailwind CSS redaktoris CDN abil kliendipoolselt ja salvestati postituse salvestamisel kettale. v7-s kompileeritakse Tailwind CSS iga esikülje päringu ajal serveripoolselt TailwindPHP abil ning failipõhine vahemälu luuakse automaatselt.
Uue süsteemi täieliku kirjelduse leiate Tailwind CSS dokumentatsioonist.
Alati sisse lülitatud serveripoolne kompileerimine
Kui tailwind.enabled on true, kompileeritakse iga eesliidese päring serveris. Kompileerimine käib nii:
- WordPress renderdab kogu lehe HTML väljundpuhvrisse
- HTML-st eraldatakse CSS klassikandidaadid (kiire regulaaravaldis, kompileerimist pole vaja)
- Kandidaadid sorditakse ja räsitakse koos konfiguratsiooniga CSS vahemälu võtme loomiseks
- Vahemälutabamuse korral loetakse vahemällu salvestatud fail CSS ja lisatakse väljundisse
- Vahemälumöödalasu korral kompileerib TailwindPHP CSS, kirjutab selle Blockstudio jagatud käitusaja vahemällu ulatuses
tailwindja lisab väljundisse
Kompileeritud CSS lisatakse tekstisisese sildina <style id="blockstudio-tailwind"> enne elementi </head>. See sisaldab Tailwind lähtestuslaadi ja kõiki sobitatud utiliidiklasse.
Skript CDN jääb redaktoris aktiivseks ainult reaalajas eelvaate jaoks. Eesliideses seda kunagi ei edastata.
Muutus vormingus config
Atribuut config muutus objektist JSON (Tailwind v3) stringiks CSS (Tailwind v4 süntaks, kus esimene element on CSS).
Enne (v6):
{
"tailwind": {
"config": {
"theme": {
"extend": {
"colors": {
"primary": "pink"
}
}
}
}
}
}
Pärast (v7):
{
"tailwind": {
"config": "@theme { --color-primary: pink; }"
}
}
Seadistus customClasses eemaldati
Massiivi seadistus customClasses on eemaldatud. Lähenemisega Tailwind v4, kus esikohal on CSS, määratletakse kohandatud utiliidiklassid otse stringis config, kasutades @layer utilities.
Enne (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" }
]
}
}
Pärast (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; } }"
}
}
Või mitmerealiste konfiguratsioonide puhul filtri kaudu:
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;
});
Samuti on eemaldatud filter blockstudio/settings/tailwind/custom_classes. Kohandatud CSS-reeglite lisamiseks kasutage selle asemel filtrit blockstudio/tailwind/css.
Lõpp-punkt REST eemaldati
Lõpp-punkt POST /blockstudio/v1/editor/tailwind/save on eemaldatud. Kompileeritud CSS-i ei salvestata enam redaktorist. Kui teil on kohandatud kood, mis seda lõpp-punkti kutsub, võite selle ohutult eemaldada.
Vahemällu salvestamine
Blockstudio kasutab kandidaatidel põhinevat vahemällu salvestamist. Kogu lehe HTML räsimise asemel (mis tühjendaks vahemälu iga päringuga nonce’ide ja ajatemplite tõttu) räsitakse ainult CSS klassikandidaadid. See tähendab järgmist:
- Kaks sama CSS-klassiga lehte jagavad sama vahemällu salvestatud faili
- Dünaamiline sisu (nonce’id, haldusribad, ajatemplid) ei tühjenda vahemälu
- Vahemälu tühjeneb ainult siis, kui CSS klasside hulk või konfiguratsioon muutub
Vahemälufailid kasutavad seadistatud Blockstudio käitusaja juurkausta asukohas
sites/{network-blog}/{runtime-identity}/tailwind/. Ümberkompileerimise sundimiseks kutsuge välja
Blockstudio\Runtime_Cache::purge('tailwind').
Filtrite muudatused
| Vana nimi (v6) | Uus nimi (v7) |
|---|---|
blockstudio/tailwind/on_demand/css |
blockstudio/tailwind/css |
blockstudio/tailwind/assets/dir |
Eemaldatud |
blockstudio/settings/tailwind/custom_classes |
Eemaldatud |
Eemaldatud failid ja järjekorda lisamised
Versioonis v6 lisati Tailwind CSS väliste stiililehtedena (blockstudio-tailwind, blockstudio-tailwind-preflight). Versioonis v7 lisatakse kogu CSS tekstisiseselt väljundpuhvri kaudu. Eesliideses pole Tailwind jaoks lingisilte ega järjekorda lisatud stiililehti.
Plokiteek
Sisseehitatud teek “Blockstudio Elements” on eemaldatud. Seadistus library asukohas blockstudio.json ja filter blockstudio/settings/library ei avalda enam mingit mõju.
Kui kasutasite teegi plokke (Gallery, Slider, Image Comparison, Code, Icon), kopeerige plokkide kaustad oma v6 paigalduse kataloogist includes/library/blockstudio-element/ teema kataloogi blockstudio ning uuendage nende block.json faile uute nimede ja kategooriatega.