Migrera till v7
Den här guiden går igenom ändringarna du behöver göra när du uppgraderar från Blockstudio 6 till 7.
ES-modulimporter
Nytt prefix npm: (rekommenderas)
Blockstudio 7 introducerar ett nytt prefix npm: för ES-modulimporter, i linje med konventionen för Denos npm-specifierare.
Före (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";
Efter (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-importer
Samma ändring gäller för CSS-importer:
Före (v6):
import "blockstudio/swiper@11.0.0/swiper.min.css";
Efter (v7):
import "npm:swiper@11.0.0/swiper.min.css";
Bakåtkompatibilitet
Prefixet blockstudio/ stöds fortfarande för bakåtkompatibilitet. Din befintliga kod fortsätter att fungera utan ändringar. Vi rekommenderar dock att du migrerar till prefixet npm: för att följa det bredare JavaScript-ekosystemet.
Prefixet npm: har flera fördelar:
- I linje med ekosystemet – följer Denos etablerade konvention
- Tydligare – visar direkt att du importerar från npm
- Framtidssäkert – prefixet
blockstudio/kan komma att fasas ut i en framtida huvudversion
Hooknamn
Blockstudio 7 standardiserar namnen på alla PHP-hooks så att de använder snake_case i stället för camelCase, i linje med konventionerna i WordPress core.
Ändrade hooknamn
| Gammalt namn (v6) | Nytt namn (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 |
Bakåtkompatibilitet
De gamla camelCase-hooknamnen stöds fortfarande för bakåtkompatibilitet. Din befintliga kod fortsätter att fungera utan ändringar. Vi rekommenderar dock att du migrerar till de nya snake_case-namnen för enhetlighet.
Exempel på migrering:
// 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'];
});
Kanoniska blocktaggar
Blockstudio 7.6 behåller projektspecifika prefix och exakta alias som utökningspunkter vid körning, men använder <bs:namespace-slug> som kanonisk stavning i exempel, katalogutdata, renderingsdeklarationer och diagnostik. Kanoniska taggar innehåller det verkliga registrerade blocknamnet och är inte beroende av ett värdspecifikt filter.
För ett projekt med brand => ["theme-components"] och ui => ["bsui"]:
<!-- Legacy project shorthand -->
<brand-card>
<ui-input />
</brand-card>
<!-- Canonical output -->
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Ett fristående migreringskommando inventerar ett befintligt projekt och skriver om kortformer till den kanoniska stavningen. Det prioriterar rapportering, avbryts vid olösta fall och ändrar bara taggnamn. Se Migrering av blocktaggar för information om kommandot, dess indata och säkerhetsåtgärder.
Namngivning av resursfiler
Blockstudio 7 introducerar punktnotation för suffix i resursfilnamn och ersätter den gamla bindestrecksnotationen som rekommenderad konvention.
Ändrade filnamn
| Gammalt namn (v6) | Nytt namn (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 |
Bakåtkompatibilitet
Den gamla bindestrecksnotationen stöds fortfarande för bakåtkompatibilitet. Dina befintliga filer fortsätter att fungera utan att döpas om. Vi rekommenderar dock att du migrerar till punktnotation för nya block.
Exempel på migrering:
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
Fältväxel
Egenskapen switch har nu standardvärdet false i stället för true. I v6 hade varje fält en osynlig växel vid vänsterkanten som var aktiverad som standard. I v7 är växeln valfri och visas som en synlig ögonikon i fältets etikett.
Vad har ändrats
- Standardvärdet är nu
false: fält har inte längre någon växel om du inte uttryckligen anger"switch": true - Synlig ögonikon: i stället för en dold klickyta till vänster visas en knapp med en ögonikon i etikettområdet
- Överlägg för inaktiverade fält: när ett fält är inaktiverat visas ett oskärpeöverlägg med texten "Det här fältet är inaktiverat" i stället för att bara minska opaciteten
Migrering
Om du förlitade dig på växelns standardbeteende i v6 behöver du aktivera den uttryckligen:
{
"id": "title",
"type": "text",
"label": "Title",
"switch": true
}
Om du tidigare angav "switch": false för att inaktivera växeln kan du ta bort den eftersom false nu är standardvärdet.
Tailwind CSS
Blockstudio 7 ersätter helt metoden v6 Tailwind. I v6 kompilerades Tailwind CSS på klientsidan via CDN i redigeraren och sparades på disk när inlägget sparades. I v7 kompileras Tailwind CSS på serversidan vid varje frontend-begäran via TailwindPHP, med automatisk filbaserad cachelagring.
Se dokumentationen för Tailwind CSS för fullständig information om det nya systemet.
Alltid aktiv kompilering på serversidan
När tailwind.enabled är true kompileras varje frontend-begäran på serversidan. Kompileringsflödet:
- WordPress renderar hela sidans HTML till en utdataringbuffert
- Klasskandidater för CSS extraheras från HTML (snabb regex, ingen kompilering)
- Kandidater sorteras och hashas med konfigurationen CSS för att skapa en cache-nyckel
- Vid cacheträff: den cachade CSS-filen läses och infogas
- Vid cachemiss: TailwindPHP kompilerar CSS, skriver den till Blockstudios delade runtime-cache under omfånget
tailwindoch infogar den
Den kompilerade CSS infogas som en inline-<style id="blockstudio-tailwind">-tagg före </head>. Detta omfattar Tailwinds preflight och alla matchande verktygsklasser.
Skriptet CDN är fortfarande aktivt i redigeraren, men bara för förhandsvisning i realtid. Det körs aldrig på frontend.
Ändrat config-format
Egenskapen config ändrades från ett objekt av typen JSON (Tailwind v3) till en sträng av typen CSS (syntaxen Tailwind v4 CSS först).
Före (v6):
{
"tailwind": {
"config": {
"theme": {
"extend": {
"colors": {
"primary": "pink"
}
}
}
}
}
}
Efter (v7):
{
"tailwind": {
"config": "@theme { --color-primary: pink; }"
}
}
Inställningen customClasses har tagits bort
Arrayinställningen customClasses har tagits bort. Med metoden där Tailwind v4 använder CSS först definieras anpassade verktygsklasser direkt i strängen config med @layer utilities.
Före (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" }
]
}
}
Efter (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; } }"
}
}
Eller via filtret för konfigurationer med flera rader:
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;
});
Filtret blockstudio/settings/tailwind/custom_classes har också tagits bort. Använd filtret blockstudio/tailwind/css i stället för att lägga till anpassade CSS-regler.
Slutpunkten REST har tagits bort
Slutpunkten POST /blockstudio/v1/editor/tailwind/save har tagits bort. Kompilerad CSS sparas inte längre från redigeraren. Om du har anpassad kod som anropar slutpunkten kan du ta bort den utan risk.
Cachelagring
Blockstudio använder en cachelagringsstrategi baserad på kandidater. I stället för att hasha hela sidans HTML (vilket skulle rensa cachen vid varje begäran på grund av engångsvärden och tidsstämplar) hashas bara klasskandidaterna för CSS. Det innebär att:
- Två sidor med samma klasser för CSS delar på samma cachade fil
- Dynamiskt innehåll (engångsvärden, administratörsfält, tidsstämplar) rensar inte cachen
- Cachen ogiltigförklaras bara när uppsättningen klasser för CSS eller konfigurationen ändras
Cachefiler använder den konfigurerade runtime-roten Blockstudio under
sites/{network-blog}/{runtime-identity}/tailwind/. Anropa
Blockstudio\Runtime_Cache::purge('tailwind') för att tvinga fram en ny kompilering.
Filterändringar
| Gammalt namn (v6) | Nytt namn (v7) |
|---|---|
blockstudio/tailwind/on_demand/css |
blockstudio/tailwind/css |
blockstudio/tailwind/assets/dir |
Borttaget |
blockstudio/settings/tailwind/custom_classes |
Borttaget |
Borttagna filer och köade resurser
I v6 köades Tailwind CSS som externa stilmallar (blockstudio-tailwind, blockstudio-tailwind-preflight). I v7 infogas all CSS inline via en utdataringbuffert. Inga länktaggar eller stilmallar köas för Tailwind på frontend.
Blockbibliotek
Det inbyggda biblioteket “Blockstudio Elements” har tagits bort. Inställningen library i blockstudio.json och filtret blockstudio/settings/library har inte längre någon effekt.
Om du använde biblioteksblocken (Gallery, Slider, Image Comparison, Code, Icon) kopierar du blockmapparna från din v6-installations katalog includes/library/blockstudio-element/ till temats blockstudio-katalog och uppdaterar deras block.json-filer med nya namn och kategorier.