Preskoči na vsebino

Selitev na v7

Ta vodnik opisuje spremembe, ki jih morate opraviti pri nadgradnji z različice Blockstudio 6 na 7.

Uvozi modulov ES

Blockstudio 7 uvaja novo predpono npm: za uvoze modulov ES, skladno s konvencijo specifikatorja npm Deno.

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

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

Uvozi CSS

Enaka sprememba velja za uvoze CSS:

Prej (v6):

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

Potem (v7):

JavaScript
import "npm:swiper@11.0.0/swiper.min.css";

Združljivost za nazaj

Predpona blockstudio/ je zaradi združljivosti za nazaj še vedno podprta. Vaša obstoječa koda bo še naprej delovala brez sprememb. Vseeno priporočamo prehod na predpono npm:, da bo skladna s širšim ekosistemom JavaScript.

Predpona npm: prinaša več prednosti:

  • Skladnost z ekosistemom – sledi uveljavljeni konvenciji za Deno
  • Jasnost – takoj je jasno, da uvažate iz npm
  • Pripravljenost na prihodnost – predpona blockstudio/ bo morda v prihodnji glavni različici opuščena

Imena hookov

Blockstudio 7 poenoti vsa imena hookov PHP, ki zdaj uporabljajo snake_case namesto camelCase, skladno s konvencijami jedra WordPress.

Spremenjena imena hookov

Staro ime (v6) Novo ime (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

Združljivost za nazaj

Stara imena hookov v slogu camelCase so zaradi združljivosti za nazaj še vedno podprta. Vaša obstoječa koda bo še naprej delovala brez sprememb. Vseeno priporočamo prehod na nova imena v slogu snake_case zaradi doslednosti.

Primer selitve:

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

Kanonične oznake blokov

Blockstudio 7.6 še vedno podpira predpone projektov in natančne vzdevke kot razširitvene točke med izvajanjem, vendar v primerih, izpisih kataloga, deklaracijah upodabljanja in diagnostičnih sporočilih uporablja <bs:namespace-slug> kot kanonično obliko. Kanonične oznake vsebujejo dejansko registrirano ime bloka in niso odvisne od filtra, specifičnega za okolje gostitelja.

Za projekt z brand => ["theme-components"] in 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>

Samostojni ukaz za selitev pregleda obstoječi projekt in prepiše kratke zapise v kanonično obliko. Najprej pripravi poročilo, se ustavi ob nerazrešenih primerih in spremeni samo imena oznak. Za ukaz, njegove vhode in varnostno delovanje glejte Selitev oznak blokov.

Poimenovanje datotek sredstev

Blockstudio 7 uvaja zapis s piko za pripone datotek sredstev in kot priporočeno konvencijo nadomešča dosedanji zapis z vezajem.

Spremenjena imena datotek

Staro ime (v6) Novo ime (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

Združljivost za nazaj

Stari zapis z vezajem je zaradi združljivosti za nazaj še vedno podprt. Vaše obstoječe datoteke bodo še naprej delovale brez preimenovanja. Vseeno priporočamo, da pri novih blokih preidete na zapis s piko.

Primer selitve:

Koda
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

Preklop polja

Lastnost switch ima zdaj privzeto vrednost false namesto true. V v6 je imelo vsako polje na levem robu nevidno stikalo, ki je bilo privzeto vklopljeno. V v7 je stikalo treba izrecno omogočiti, v oznaki polja pa je prikazana vidna ikona očesa.

Kaj se je spremenilo

  • Privzeta vrednost je zdaj false: polja nimajo več stikala, razen če izrecno nastavite "switch": true
  • Vidna ikona očesa: namesto skritega območja za klik na levi se v območju oznake prikaže gumb z ikono očesa
  • Prekrivni sloj za onemogočeno polje: ko je polje onemogočeno, se prikaže zamegljen prekrivni sloj z besedilom »To polje je onemogočeno«; polje ni več zgolj manj neprosojno

Selitev

Če ste se zanašali na privzeto delovanje stikala v v6, ga morate izrecno omogočiti:

JSON
{
  "id": "title",
  "type": "text",
  "label": "Title",
  "switch": true
}

Če ste prej nastavili "switch": false, da onemogočite preklop, ga lahko odstranite, saj je zdaj privzeta vrednost false.

Tailwind CSS

Blockstudio 7 v celoti nadomešča pristop v6 Tailwind. V v6 je bil Tailwind CSS preveden na strani odjemalca prek CDN v urejevalniku in ob shranjevanju objave shranjen na disk. V v7 se Tailwind CSS prevaja na strani strežnika ob vsaki zahtevi za sprednji del spletnega mesta prek TailwindPHP, datoteke pa se samodejno shranjujejo v predpomnilnik.

Za vse podrobnosti o novem sistemu glejte dokumentacijo Tailwind CSS.

Vedno vključeno prevajanje na strani strežnika

Ko je tailwind.enabled nastavljen na true, se vsaka zahteva za sprednji del spletnega mesta prevede na strani strežnika. Potek prevajanja:

  1. WordPress izriše celotno stran HTML v izhodni medpomnilnik
  2. Iz HTML se izluščijo kandidati za razrede CSS (hiter regex, brez prevajanja)
  3. Kandidati se razvrstijo in zgostijo skupaj s konfiguracijo CSS, da se ustvari ključ predpomnilnika
  4. Ob zadetku v predpomnilniku se prebere predpomnjena datoteka CSS in vstavi
  5. Ob zgrešenem zadetku v predpomnilniku TailwindPHP prevede CSS, ga zapiše v skupni izvajalni predpomnilnik Blockstudio v obsegu tailwind in vstavi

Prevedeni CSS se vstavi kot oznaka <style id="blockstudio-tailwind"> z neposredno vključeno vsebino pred </head>. To vključuje preflight za Tailwind in vse ujemajoče se uporabne razrede.

Skript CDN ostane v urejevalniku aktiven samo za predogled v živo. Na sprednjem delu spletnega mesta se nikoli ne postreže.

Spremenjen format config

Lastnost config se je spremenila: prej je bila objekt JSON (Tailwind v3), zdaj je niz CSS (sintaksa Tailwind v4 CSS najprej).

Prej (v6):

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

Potem (v7):

JSON
{
  "tailwind": {
    "config": "@theme { --color-primary: pink; }"
  }
}

Nastavitev customClasses odstranjena

Nastavitev polja customClasses je bila odstranjena. Ker pristop Tailwind v4 daje prednost sintaksi CSS, se razredi po meri definirajo neposredno v nizu config z uporabo @layer utilities.

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

Potem (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; } }"
  }
}

Ali prek filtra za večvrstične konfiguracije:

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

Filter blockstudio/settings/tailwind/custom_classes je bil prav tako odstranjen. Namesto njega uporabite filter blockstudio/tailwind/css za dodajanje pravil CSS po meri.

Končna točka REST odstranjena

Končna točka POST /blockstudio/v1/editor/tailwind/save je bila odstranjena. Prevedeni CSS se ne shranjuje več iz urejevalnika. Če ste imeli kodo po meri, ki je klicala to končno točko, jo lahko varno odstranite.

Predpomnjenje

Blockstudio uporablja strategijo predpomnjenja na podlagi kandidatov. Namesto zgoščevanja celotnega HTML strani (zaradi česar bi se predpomnilnik ob vsaki zahtevi izpraznil zaradi nonce-ov in časovnih žigov) se zgostijo samo kandidati za razrede CSS. To pomeni:

  • Dve strani z enakimi razredi CSS uporabljata isto predpomnjeno datoteko
  • Dinamična vsebina (nonce-i, skrbniške vrstice, časovni žigi) ne izprazni predpomnilnika
  • Predpomnilnik se razveljavi samo, ko se spremeni nabor razredov CSS ali konfiguracija

Datoteke predpomnilnika uporabljajo nastavljeni korenski imenik izvajalnega okolja Blockstudio pod sites/{network-blog}/{runtime-identity}/tailwind/. Za ponovni prevod pokličite Blockstudio\Runtime_Cache::purge('tailwind').

Spremembe filtrov

Staro ime (v6) Novo ime (v7)
blockstudio/tailwind/on_demand/css blockstudio/tailwind/css
blockstudio/tailwind/assets/dir Odstranjeno
blockstudio/settings/tailwind/custom_classes Odstranjeno

Odstranjene datoteke in registracije sredstev

V v6 se je Tailwind CSS dodajal kot zunanji slogovni datoteki (blockstudio-tailwind, blockstudio-tailwind-preflight). V v7 se vsa vsebina CSS vstavi neposredno prek izhodnega medpomnilnika. Na sprednjem delu spletnega mesta za Tailwind ni oznak link ali dodanih slogovnih datotek.

Knjižnica blokov

Vgrajena knjižnica »Elementi Blockstudio« je bila odstranjena. Nastavitev library v blockstudio.json in filter blockstudio/settings/library ne učinkujeta več.

Če ste uporabljali bloke iz knjižnice (Galerija, Drsnik, Primerjava slik, Koda, Ikona), kopirajte mape blokov iz namestitve v6 v imeniku includes/library/blockstudio-element/ v imenik blockstudio svoje teme ter posodobite njihove datoteke block.json z novimi imeni in kategorijami.