Selitev na v7
Ta vodnik opisuje spremembe, ki jih morate opraviti pri nadgradnji z različice Blockstudio 6 na 7.
Uvozi modulov ES
Nova predpona npm: (priporočeno)
Blockstudio 7 uvaja novo predpono npm: za uvoze modulov ES, skladno s konvencijo specifikatorja npm Deno.
Prej (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";
Potem (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";
Uvozi CSS
Enaka sprememba velja za uvoze CSS:
Prej (v6):
import "blockstudio/swiper@11.0.0/swiper.min.css";
Potem (v7):
import "npm:swiper@11.0.0/swiper.min.css";
Združljivost za nazaj
Predpona blockstudio/ je zaradi združljivosti za nazaj še vedno podprta. Vaša obstoječa koda bo še naprej delovala brez sprememb. Vseeno priporočamo prehod na predpono npm:, da bo skladna s širšim ekosistemom JavaScript.
Predpona npm: prinaša več prednosti:
- Skladnost z ekosistemom – sledi uveljavljeni konvenciji za Deno
- Jasnost – takoj je jasno, da uvažate iz npm
- Pripravljenost na prihodnost – predpona
blockstudio/bo morda v prihodnji glavni različici opuščena
Imena hookov
Blockstudio 7 poenoti vsa imena hookov PHP, ki zdaj uporabljajo snake_case namesto camelCase, skladno s konvencijami jedra WordPress.
Spremenjena imena hookov
| Staro ime (v6) | Novo ime (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 |
Združljivost za nazaj
Stara imena hookov v slogu camelCase so zaradi združljivosti za nazaj še vedno podprta. Vaša obstoječa koda bo še naprej delovala brez sprememb. Vseeno priporočamo prehod na nova imena v slogu snake_case zaradi doslednosti.
Primer selitve:
// 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'];
});
Kanonične oznake blokov
Blockstudio 7.6 še vedno podpira predpone projektov in natančne vzdevke kot razširitvene točke med izvajanjem, vendar v primerih, izpisih kataloga, deklaracijah upodabljanja in diagnostičnih sporočilih uporablja <bs:namespace-slug> kot kanonično obliko. Kanonične oznake vsebujejo dejansko registrirano ime bloka in niso odvisne od filtra, specifičnega za okolje gostitelja.
Za projekt z brand => ["theme-components"] in ui => ["bsui"]:
<!-- Legacy project shorthand -->
<brand-card>
<ui-input />
</brand-card>
<!-- Canonical output -->
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Samostojni ukaz za selitev pregleda obstoječi projekt in prepiše kratke zapise v kanonično obliko. Najprej pripravi poročilo, se ustavi ob nerazrešenih primerih in spremeni samo imena oznak. Za ukaz, njegove vhode in varnostno delovanje glejte Selitev oznak blokov.
Poimenovanje datotek sredstev
Blockstudio 7 uvaja zapis s piko za pripone datotek sredstev in kot priporočeno konvencijo nadomešča dosedanji zapis z vezajem.
Spremenjena imena datotek
| Staro ime (v6) | Novo ime (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 |
Združljivost za nazaj
Stari zapis z vezajem je zaradi združljivosti za nazaj še vedno podprt. Vaše obstoječe datoteke bodo še naprej delovale brez preimenovanja. Vseeno priporočamo, da pri novih blokih preidete na zapis s piko.
Primer selitve:
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
Preklop polja
Lastnost switch ima zdaj privzeto vrednost false namesto true. V v6 je imelo vsako polje na levem robu nevidno stikalo, ki je bilo privzeto vklopljeno. V v7 je stikalo treba izrecno omogočiti, v oznaki polja pa je prikazana vidna ikona očesa.
Kaj se je spremenilo
- Privzeta vrednost je zdaj
false: polja nimajo več stikala, razen če izrecno nastavite"switch": true - Vidna ikona očesa: namesto skritega območja za klik na levi se v območju oznake prikaže gumb z ikono očesa
- Prekrivni sloj za onemogočeno polje: ko je polje onemogočeno, se prikaže zamegljen prekrivni sloj z besedilom »To polje je onemogočeno«; polje ni več zgolj manj neprosojno
Selitev
Če ste se zanašali na privzeto delovanje stikala v v6, ga morate izrecno omogočiti:
{
"id": "title",
"type": "text",
"label": "Title",
"switch": true
}
Če ste prej nastavili "switch": false, da onemogočite preklop, ga lahko odstranite, saj je zdaj privzeta vrednost false.
Tailwind CSS
Blockstudio 7 v celoti nadomešča pristop v6 Tailwind. V v6 je bil Tailwind CSS preveden na strani odjemalca prek CDN v urejevalniku in ob shranjevanju objave shranjen na disk. V v7 se Tailwind CSS prevaja na strani strežnika ob vsaki zahtevi za sprednji del spletnega mesta prek TailwindPHP, datoteke pa se samodejno shranjujejo v predpomnilnik.
Za vse podrobnosti o novem sistemu glejte dokumentacijo Tailwind CSS.
Vedno vključeno prevajanje na strani strežnika
Ko je tailwind.enabled nastavljen na true, se vsaka zahteva za sprednji del spletnega mesta prevede na strani strežnika. Potek prevajanja:
- WordPress izriše celotno stran HTML v izhodni medpomnilnik
- Iz HTML se izluščijo kandidati za razrede CSS (hiter regex, brez prevajanja)
- Kandidati se razvrstijo in zgostijo skupaj s konfiguracijo CSS, da se ustvari ključ predpomnilnika
- Ob zadetku v predpomnilniku se prebere predpomnjena datoteka CSS in vstavi
- Ob zgrešenem zadetku v predpomnilniku TailwindPHP prevede CSS, ga zapiše v skupni izvajalni predpomnilnik Blockstudio v obsegu
tailwindin vstavi
Prevedeni CSS se vstavi kot oznaka <style id="blockstudio-tailwind"> z neposredno vključeno vsebino pred </head>. To vključuje preflight za Tailwind in vse ujemajoče se uporabne razrede.
Skript CDN ostane v urejevalniku aktiven samo za predogled v živo. Na sprednjem delu spletnega mesta se nikoli ne postreže.
Spremenjen format config
Lastnost config se je spremenila: prej je bila objekt JSON (Tailwind v3), zdaj je niz CSS (sintaksa Tailwind v4 CSS najprej).
Prej (v6):
{
"tailwind": {
"config": {
"theme": {
"extend": {
"colors": {
"primary": "pink"
}
}
}
}
}
}
Potem (v7):
{
"tailwind": {
"config": "@theme { --color-primary: pink; }"
}
}
Nastavitev customClasses odstranjena
Nastavitev polja customClasses je bila odstranjena. Ker pristop Tailwind v4 daje prednost sintaksi CSS, se razredi po meri definirajo neposredno v nizu config z uporabo @layer utilities.
Prej (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" }
]
}
}
Potem (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; } }"
}
}
Ali prek filtra za večvrstične konfiguracije:
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;
});
Filter blockstudio/settings/tailwind/custom_classes je bil prav tako odstranjen. Namesto njega uporabite filter blockstudio/tailwind/css za dodajanje pravil CSS po meri.
Končna točka REST odstranjena
Končna točka POST /blockstudio/v1/editor/tailwind/save je bila odstranjena. Prevedeni CSS se ne shranjuje več iz urejevalnika. Če ste imeli kodo po meri, ki je klicala to končno točko, jo lahko varno odstranite.
Predpomnjenje
Blockstudio uporablja strategijo predpomnjenja na podlagi kandidatov. Namesto zgoščevanja celotnega HTML strani (zaradi česar bi se predpomnilnik ob vsaki zahtevi izpraznil zaradi nonce-ov in časovnih žigov) se zgostijo samo kandidati za razrede CSS. To pomeni:
- Dve strani z enakimi razredi CSS uporabljata isto predpomnjeno datoteko
- Dinamična vsebina (nonce-i, skrbniške vrstice, časovni žigi) ne izprazni predpomnilnika
- Predpomnilnik se razveljavi samo, ko se spremeni nabor razredov CSS ali konfiguracija
Datoteke predpomnilnika uporabljajo nastavljeni korenski imenik izvajalnega okolja Blockstudio pod
sites/{network-blog}/{runtime-identity}/tailwind/. Za ponovni prevod pokličite
Blockstudio\Runtime_Cache::purge('tailwind').
Spremembe filtrov
| Staro ime (v6) | Novo ime (v7) |
|---|---|
blockstudio/tailwind/on_demand/css |
blockstudio/tailwind/css |
blockstudio/tailwind/assets/dir |
Odstranjeno |
blockstudio/settings/tailwind/custom_classes |
Odstranjeno |
Odstranjene datoteke in registracije sredstev
V v6 se je Tailwind CSS dodajal kot zunanji slogovni datoteki (blockstudio-tailwind, blockstudio-tailwind-preflight). V v7 se vsa vsebina CSS vstavi neposredno prek izhodnega medpomnilnika. Na sprednjem delu spletnega mesta za Tailwind ni oznak link ali dodanih slogovnih datotek.
Knjižnica blokov
Vgrajena knjižnica »Elementi Blockstudio« je bila odstranjena. Nastavitev library v blockstudio.json in filter blockstudio/settings/library ne učinkujeta več.
Če ste uporabljali bloke iz knjižnice (Galerija, Drsnik, Primerjava slik, Koda, Ikona), kopirajte mape blokov iz namestitve v6 v imeniku includes/library/blockstudio-element/ v imenik blockstudio svoje teme ter posodobite njihove datoteke block.json z novimi imeni in kategorijami.