Pāriet uz saturu

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

Blockstudio 7 ievieš jaunu prefiksu npm: ES moduļu importēšanai, saskaņojot to ar Deno npm specifikatora konvenciju.

Pirms (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";

Pēc (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 importēšana

Tās pašas izmaiņas attiecas uz CSS importēšanu:

Pirms (v6):

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

Pēc (v7):

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

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'];
});

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

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

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

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

  1. WordPress attēlo visu lapu HTML izvades buferī
  2. CSS klašu kandidāti tiek izgūti no HTML (ātra regex izteiksme, bez kompilēšanas)
  3. Kandidāti tiek sakārtoti un jaukti kopā ar CSS konfigurāciju, lai izveidotu kešatmiņas atslēgu
  4. Ja kešatmiņā ir trāpījums: tiek nolasīts un ievietots kešotais CSS fails
  5. Ja kešatmiņā ir iztrūkums: TailwindPHP kompilē CSS, ieraksta to Blockstudio koplietojamajā izpildlaika kešatmiņā tvērumā tailwind un 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):

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

Pēc (v7):

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

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" }
    ]
  }
}

Pēc (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; } }"
  }
}

Vai izmantojot filtru vairākrindu konfigurācijām:

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;
});

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.