Migrálás a következőre: v7
Ez az útmutató bemutatja, milyen módosításokat kell elvégeznie a Blockstudio 6-os verziójáról a 7-esre frissítéskor.
ES-modulimportok
Új npm: előtag (ajánlott)
A Blockstudio 7 új npm: előtagot vezet be az ES-modulimportokhoz, igazodva a Deno npm specifikátor konvenciójához.
Előtte (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";
Utána (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 importok
Ugyanez a változás vonatkozik a CSS importokra is:
Előtte (v6):
import "blockstudio/swiper@11.0.0/swiper.min.css";
Utána (v7):
import "npm:swiper@11.0.0/swiper.min.css";
Visszafelé kompatibilitás
A blockstudio/ előtag a visszafelé kompatibilitás érdekében továbbra is támogatott. A meglévő kód módosítás nélkül működik tovább. A szélesebb JavaScript ökoszisztémával való összhang érdekében azonban javasoljuk a npm: előtagra való átállást.
A npm: előtagnak több előnye van:
- Ökoszisztémához igazodás – Követi a Deno bevett konvencióját
- Egyértelműség – Azonnal láthatóvá teszi, hogy a npm elemből importál
- Jövőállóság – A
blockstudio/előtag egy későbbi főverzióban elavulttá válhat
Hooknevek
A Blockstudio 7 egységesíti az összes PHP hook nevét: a snake_case formát használja a camelCase helyett, igazodva a WordPress alapkódjának konvencióihoz.
Módosult hooknevek
| Régi név (v6) | Új név (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 |
Visszafelé kompatibilitás
A régi camelCase hooknevek a visszafelé kompatibilitás érdekében továbbra is támogatottak. A meglévő kód módosítás nélkül működik tovább. Az egységesség érdekében azonban javasoljuk az új snake_case nevekre való átállást.
Példa a migrációra:
// 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'];
});
Kanonikus blokkcímkék
A Blockstudio 7.6 továbbra is lehetővé teszi a projektelőtagok és pontos aliasok használatát futásidejű bővítési pontként, de a példákban, a katalógus kimenetében, a renderelési deklarációkban és a diagnosztikában a <bs:namespace-slug> alakot használja kanonikus írásmódként. A kanonikus címkék a ténylegesen regisztrált blokknevet tartalmazzák, és nem függenek gazdagép-specifikus szűrőtől.
Egy brand => ["theme-components"] és ui => ["bsui"] elemeket használó projektnél:
<!-- Legacy project shorthand -->
<brand-card>
<ui-input />
</brand-card>
<!-- Canonical output -->
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Egy önálló migrációs parancs felméri a meglévő projektet, és a rövidített alakokat a kanonikus írásmódra cseréli. Először jelentést készít, megoldatlan eseteknél leáll, és csak a címkeneveket módosítja. A parancsról, bemeneteiről és biztonsági működéséről lásd a Blokkcímkék migrációja című leírást.
Eszközfájlok elnevezése
A Blockstudio 7 ponttal tagolja az eszközfájlok utótagját; ez az ajánlott konvenció a korábbi kötőjeles írásmód helyett.
Módosult fájlnevek
| Régi név (v6) | Új név (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 |
Visszafelé kompatibilitás
A régi, kötőjeles írásmód a visszafelé kompatibilitás érdekében továbbra is támogatott. A meglévő fájlok átnevezés nélkül is működnek. Új blokkoknál azonban javasoljuk a pontozott írásmód használatát.
Példa a migrációra:
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
Mezőkapcsoló
A switch tulajdonság alapértelmezett értéke mostantól false, nem pedig true. A v6 verzióban minden mező bal szélén volt egy alapértelmezés szerint bekapcsolt, láthatatlan kapcsoló. A v7 verzióban a kapcsoló használata külön engedélyezendő, és a mező címkéjénél látható szemikon jelzi.
Mi változott
- Az alapérték mostantól
false: a mezőknek nincs kapcsolójuk, hacsak kifejezetten be nem állítja a"switch": trueértéket - Látható szemikon: a rejtett, bal oldali kattintási zóna helyett egy szemikongomb jelenik meg a címke területén
- Letiltást jelző fedőréteg: letiltott mezőnél az átlátszatlanság csökkentése helyett elmosott fedőréteg jelenik meg a „This field is disabled” szöveggel
Migráció
Ha a v6 alapértelmezett kapcsolóműködésére támaszkodott, kifejezetten engedélyeznie kell:
{
"id": "title",
"type": "text",
"label": "Title",
"switch": true
}
Ha korábban a "switch": false értékét a kapcsoló letiltására állította, eltávolíthatja, mivel mostantól a false az alapértelmezett.
Tailwind CSS
A Blockstudio 7 teljesen lecseréli a v6 Tailwind megközelítést. A v6 verzióban a Tailwind CSS a szerkesztőben, kliensoldalon, a CDN használatával fordult le, majd a bejegyzés mentésekor lemezre került. A v7 verzióban a Tailwind CSS minden előtérbeli kérésnél, szerveroldalon fordul le a TailwindPHP segítségével, automatikus fájlalapú gyorsítótárazással.
A teljes leírást az új rendszerről a Tailwind CSS dokumentációjában találja.
Mindig aktív szerveroldali fordítás
Ha a tailwind.enabled értéke true, minden előtérbeli kérés szerveroldali fordításon esik át. A fordítás menete:
- A WordPress a teljes oldalt HTML formában jeleníti meg egy kimeneti pufferbe
- A CSS osztályjelöltek kinyerése a HTML részből (gyors reguláris kifejezés, fordítás nélkül)
- A jelöltek rendezése és kivonatolása a CSS konfigurációval gyorsítótárkulcs létrehozásához
- Találat esetén: a gyorsítótárazott CSS fájl beolvasása és beillesztése
- Gyorsítótárhiány esetén: a TailwindPHP lefordítja a CSS elemet, beírja a Blockstudio megosztott futásidejű gyorsítótárába, a
tailwindhatókörén belül, majd beilleszti
A lefordított CSS egy beágyazott <style id="blockstudio-tailwind"> címkeként kerül beillesztésre, a </head> elé. Ez tartalmazza a Tailwind előfeldolgozását és az összes illeszkedő segédosztályt.
A CDN szkript csak élő előnézethez marad aktív a szerkesztőben. Az előtérben soha nem töltődik be.
Megváltozott a config formátuma
A config tulajdonság JSON objektumról (Tailwind v3) CSS szöveggé változott (Tailwind v4 CSS-első szintaxis).
Előtte (v6):
{
"tailwind": {
"config": {
"theme": {
"extend": {
"colors": {
"primary": "pink"
}
}
}
}
}
}
Utána (v7):
{
"tailwind": {
"config": "@theme { --color-primary: pink; }"
}
}
Eltávolítottuk a customClasses beállítást
A customClasses tömbbeállítást eltávolítottuk. A Tailwind v4 CSS-első megközelítésével az egyéni segédosztályok közvetlenül a config szövegben, a @layer utilities használatával definiálhatók.
Előtte (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" }
]
}
}
Utána (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; } }"
}
}
Vagy szűrővel, több soros konfigurációknál:
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;
});
A blockstudio/settings/tailwind/custom_classes szűrőt is eltávolítottuk. Egyéni CSS szabályok hozzáfűzéséhez használja helyette a blockstudio/tailwind/css szűrőt.
Eltávolítottuk a REST végpontot
A POST /blockstudio/v1/editor/tailwind/save végpontot eltávolítottuk. A lefordított CSS többé nem kerül mentésre a szerkesztőből. Ha egyéni kód hívta ezt a végpontot, biztonságosan eltávolíthatja.
Gyorsítótárazás
A Blockstudio jelöltalapú gyorsítótárazási stratégiát használ. A teljes oldal HTML kivonatolása helyett (ami nonce-ok és időbélyegek miatt minden kérésnél érvénytelenítené a gyorsítótárat) csak a CSS osztályjelöltek kivonata készül el. Ennek eredménye:
- Az azonos CSS osztályokat használó oldalak ugyanazt a gyorsítótárazott fájlt használják
- A dinamikus tartalom (nonce-ok, adminisztrációs sávok, időbélyegek) nem érvényteleníti a gyorsítótárat
- A gyorsítótár csak akkor érvénytelenül, ha megváltozik a CSS osztályok halmaza vagy a konfiguráció
A gyorsítótárfájlok a konfigurált Blockstudio futásidejű gyökérkönyvtárat használják itt:
sites/{network-blog}/{runtime-identity}/tailwind/. Újrafordítás kényszerítéséhez hívja meg ezt: Blockstudio\Runtime_Cache::purge('tailwind').
Szűrőváltozások
| Régi név (v6) | Új név (v7) |
|---|---|
blockstudio/tailwind/on_demand/css |
blockstudio/tailwind/css |
blockstudio/tailwind/assets/dir |
Eltávolítva |
blockstudio/settings/tailwind/custom_classes |
Eltávolítva |
Eltávolított fájlok és betöltések
A v6 verzióban a Tailwind CSS külső stíluslapként töltődött be (blockstudio-tailwind, blockstudio-tailwind-preflight). A v7 verzióban minden CSS közvetlenül, kimeneti pufferen keresztül kerül beillesztésre. Az előtérben a Tailwind számára nincsenek linkcímkék vagy betöltött stíluslapok.
Blokk-könyvtár
A beépített „Blockstudio Elements” könyvtárat eltávolítottuk. A blockstudio.json beállítás a library elemben és a blockstudio/settings/library szűrő többé nincs hatással semmire.
Ha a könyvtár blokkjait (Gallery, Slider, Image Comparison, Code, Icon) használta, másolja át a blokk mappáit a v6 telepítésének includes/library/blockstudio-element/ könyvtárából a témája blockstudio könyvtárába, majd frissítse a block.json fájlokat az új nevekkel és kategóriákkal.