Hoppa till innehåll

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

Blockstudio 7 introducerar ett nytt prefix npm: för ES-modulimporter, i linje med konventionen för Denos npm-specifierare.

Före (v6):

JavaScript
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):

JavaScript
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):

JavaScript
import "blockstudio/swiper@11.0.0/swiper.min.css";

Efter (v7):

JavaScript
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:

PHP
// 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"]:

HTML
<!-- 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:

Kod
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:

JSON
{
  "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:

  1. WordPress renderar hela sidans HTML till en utdataringbuffert
  2. Klasskandidater för CSS extraheras från HTML (snabb regex, ingen kompilering)
  3. Kandidater sorteras och hashas med konfigurationen CSS för att skapa en cache-nyckel
  4. Vid cacheträff: den cachade CSS-filen läses och infogas
  5. Vid cachemiss: TailwindPHP kompilerar CSS, skriver den till Blockstudios delade runtime-cache under omfånget tailwind och 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):

JSON
{
  "tailwind": {
    "config": {
      "theme": {
        "extend": {
          "colors": {
            "primary": "pink"
          }
        }
      }
    }
  }
}

Efter (v7):

JSON
{
  "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):

JSON
{
  "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):

JSON
{
  "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:

PHP
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.