Migrēšana uz v7
Šajā rokasgrāmatā aplūkotas izmaiņas, kas jāveic, ja jaunināt no Blockstudio 6 uz 7.
ES moduļu importēšana
Jauns prefikss npm: (ieteicams)
Blockstudio 7 ievieš jaunu prefiksu npm: ES moduļu importēšanai, saskaņojot to ar Deno npm specifikatora konvenciju.
Pirms (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ēc (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 importēšana
Tās pašas izmaiņas attiecas uz CSS importēšanu:
Pirms (v6):
import "blockstudio/swiper@11.0.0/swiper.min.css";
Pēc (v7):
import "npm:swiper@11.0.0/swiper.min.css";
Atpakaļsaderība
Prefikss blockstudio/ joprojām tiek atbalstīts atpakaļsaderības nolūkos. Esošais kods turpinās darboties bez izmaiņām. Tomēr iesakām pāriet uz prefiksu npm:, lai nodrošinātu saskaņotību ar plašāku JavaScript ekosistēmu.
Prefikss npm: sniedz vairākas priekšrocības:
- Saskaņa ar ekosistēmu — atbilst iedibinātajai Deno konvencijai
- Skaidrība — uzreiz parāda, ka importējat no npm
- Noturība nākotnē — prefikss
blockstudio/var tikt novecināts kādā no nākamajām lielajām versijām
Āķu nosaukumi
Blockstudio 7 standartizē visu PHP āķu nosaukumus, aizstājot camelCase ar snake_case, lai tie atbilstu WordPress pamata konvencijām.
Mainītie āķu nosaukumi
| Vecais nosaukums (v6) | Jaunais nosaukums (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 |
Atpakaļsaderība
Vecie āķu nosaukumi camelCase formātā joprojām tiek atbalstīti atpakaļsaderības nolūkos. Esošais kods turpinās darboties bez izmaiņām. Tomēr saskaņotības labad iesakām pāriet uz jaunajiem nosaukumiem snake_case formātā.
Migrēšanas piemērs:
// 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'];
});
Kanoniskie bloku tagi
Blockstudio 7.6 joprojām atbalsta projektu prefiksus un precīzos aizstājvārdus kā izpildlaika paplašinājumu punktus, bet piemēros, katalogu izvadē, attēlošanas deklarācijās un diagnostikas ziņojumos izmanto <bs:namespace-slug> kā kanonisko pierakstu. Kanoniskie tagi satur faktisko reģistrēto bloka nosaukumu un nav atkarīgi no konkrētai platformai pielāgota filtra.
Projektam ar brand => ["theme-components"] un ui => ["bsui"]:
<!-- Legacy project shorthand -->
<brand-card>
<ui-input />
</brand-card>
<!-- Canonical output -->
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Atsevišķa migrēšanas komanda uzskaita esošā projekta vienumus un pārraksta saīsinājumus kanoniskajā pierakstā. Vispirms tiek sagatavots pārskats; komanda aptur darbību neatrisinātos gadījumos un maina tikai tagu nosaukumus. Komandu, ievades datus un drošības darbību skatiet sadaļā Migrēšana uz bloku tagiem.
Resursu failu nosaukumi
Blockstudio 7 ievieš punktu pierakstu resursu failu sufiksiem, aizstājot veco defises pierakstu kā ieteicamo konvenciju.
Mainītie failu nosaukumi
| Vecais nosaukums (v6) | Jaunais nosaukums (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 |
Atpakaļsaderība
Vecais defises pieraksts joprojām tiek atbalstīts atpakaļsaderības nolūkos. Esošie faili turpinās darboties bez pārdēvēšanas. Tomēr jauniem blokiem iesakām pāriet uz punktu pierakstu.
Migrēšanas piemērs:
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
Lauka slēdzis
Rekvizītam switch tagad noklusējuma vērtība ir false, nevis true. Sistēmā v6 katram laukam kreisajā malā bija neredzams pārslēgs, kas pēc noklusējuma bija ieslēgts. Sistēmā v7 slēdzis ir jāieslēdz atsevišķi, un lauka etiķetē tam tiek izmantota redzama acs ikona.
Kas mainījies
- Pēc noklusējuma
false: laukiem vairs nav slēdža, ja vien skaidri nenorādāt"switch": true - Redzama acs ikona: slēptās klikšķināmās zonas kreisajā pusē vietā etiķetes apgabalā ir redzama poga ar acs ikonu
- Atspējots pārklājums: ja lauks ir atspējots, vienkāršas caurspīdīguma samazināšanas vietā tiek rādīts izpludināts pārklājums ar tekstu "Šis lauks ir atspējots"
Migrēšana
Ja paļāvāties uz noklusējuma slēdža darbību sistēmā v6, tas ir skaidri jāiespējo:
{
"id": "title",
"type": "text",
"label": "Title",
"switch": true
}
Ja iepriekš iestatījāt "switch": false, lai atspējotu pārslēgu, varat to noņemt, jo tagad tā noklusējuma vērtība ir false.
Tailwind CSS
Blockstudio 7 pilnībā aizstāj pieeju v6 Tailwind. Sistēmā v6 Tailwind CSS tika kompilēts klienta pusē, izmantojot redaktora CDN, un saglabāts diskā pēc ieraksta saglabāšanas. Sistēmā v7 Tailwind CSS tiek kompilēts servera pusē katrā priekšgala pieprasījumā, izmantojot TailwindPHP ar automātisku kešatmiņu, kuras pamatā ir faili.
Pilnu informāciju par jauno sistēmu skatiet Tailwind CSSdokumentācijā.
Vienmēr ieslēgta kompilēšana servera pusē
Ja tailwind.enabled ir true, katrs priekšgala pieprasījums tiek kompilēts servera pusē. Kompilēšanas process:
- WordPress attēlo visu lapu HTML izvades buferī
- CSS klašu kandidāti tiek izgūti no HTML (ātra regex izteiksme, bez kompilēšanas)
- Kandidāti tiek sakārtoti un jaukti kopā ar CSS konfigurāciju, lai izveidotu kešatmiņas atslēgu
- Ja kešatmiņā ir trāpījums: tiek nolasīts un ievietots kešotais CSS fails
- Ja kešatmiņā ir iztrūkums: TailwindPHP kompilē CSS, ieraksta to Blockstudio koplietojamajā izpildlaika kešatmiņā tvērumā
tailwindun ievieto
Kompilētais CSS tiek ievietots kā iekļauta <style id="blockstudio-tailwind"> birka pirms </head>. Tajā ietilpst Tailwind sākotnējie stili un visas atbilstošās utilītklases.
Skripts CDN paliek aktīvs redaktorā tikai reāllaika priekšskatījumam. Tas nekad netiek piegādāts priekšgalā.
Mainīts config formāts
Rekvizīts config ir mainīts no objekta JSON (Tailwind v3) uz virkni CSS (sintakse Tailwind v4 CSS-vispirms).
Pirms (v6):
{
"tailwind": {
"config": {
"theme": {
"extend": {
"colors": {
"primary": "pink"
}
}
}
}
}
}
Pēc (v7):
{
"tailwind": {
"config": "@theme { --color-primary: pink; }"
}
}
Iestatījums customClasses ir noņemts
Masīva iestatījums customClasses ir noņemts. Pieejā, kurā vispirms izmanto Tailwind v4 CSS, pielāgotas utilītklases tiek definētas tieši virknē config, izmantojot @layer utilities.
Pirms (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ēc (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; } }"
}
}
Vai izmantojot filtru vairākrindu konfigurācijām:
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;
});
Filtrs blockstudio/settings/tailwind/custom_classes arī ir noņemts. Izmantojiet filtru blockstudio/tailwind/css, lai pievienotu pielāgotus CSS noteikumus.
Noņemts galapunkts REST
Galapunkts POST /blockstudio/v1/editor/tailwind/save ir noņemts. Kompilētais CSS vairs netiek saglabāts no redaktora. Ja jums bija pielāgots kods, kas izsauca šo galapunktu, to var droši noņemt.
Kešatmiņa
Blockstudio izmanto uz kandidātiem balstītu kešatmiņas stratēģiju. Tā vietā, lai jauktu visu lapas HTML (kas katrā pieprasījumā iztukšotu kešatmiņu nonce vērtību un laika zīmogu dēļ), tiek jaukti tikai CSS klašu kandidāti. Tas nozīmē:
- Divām lapām ar vienādām CSS klasēm ir kopīgs kešotais fails
- Dinamisks saturs (nonce vērtības, administratora joslas, laika zīmogi) neiztukšo kešatmiņu
- Kešatmiņa tiek invalidēta tikai tad, ja mainās CSS klašu kopa vai konfigurācija
Kešatmiņas faili izmanto konfigurēto Blockstudio izpildlaika saknes direktoriju mapē
sites/{network-blog}/{runtime-identity}/tailwind/. Izsauciet
Blockstudio\Runtime_Cache::purge('tailwind'), lai piespiestu veikt atkārtotu kompilēšanu.
Filtru izmaiņas
| Vecais nosaukums (v6) | Jaunais nosaukums (v7) |
|---|---|
blockstudio/tailwind/on_demand/css |
blockstudio/tailwind/css |
blockstudio/tailwind/assets/dir |
Noņemts |
blockstudio/settings/tailwind/custom_classes |
Noņemts |
Noņemtie faili un pievienojamie resursi
Sistēmā v6 Tailwind CSS tika pievienots kā ārējās stilu lapas (blockstudio-tailwind, blockstudio-tailwind-preflight). Sistēmā v7 viss CSS tiek ievietots iekļautā veidā, izmantojot izvades buferi. Priekšgalā nav saišu tagu vai pievienotu stilu lapu resursam Tailwind.
Bloku bibliotēka
Iebūvētā bibliotēka “Blockstudio Elements” ir noņemta. Iestatījums library sistēmā blockstudio.json un filtrs blockstudio/settings/library vairs neko nemaina.
Ja izmantojāt bibliotēkas blokus (Galerija, Slīdnis, Attēlu salīdzinājums, Kods, Ikona), kopējiet bloku mapes no savas v6 instalācijas direktorija includes/library/blockstudio-element/ uz tēmas direktoriju blockstudio un atjauniniet to failus block.json, norādot jaunos nosaukumus un kategorijas.