Pereiti prie turinio

Perėjimas prie v7

Šiame vadove aprašyti pakeitimai, kuriuos reikia atlikti naujinant iš Blockstudio 6 į 7.

ES modulių importai

Blockstudio 7 pristato naują prefiksą npm: ES modulių importams, suderintą su Denonpm specifikatoriaus konvencija.

Prieš (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";

Po (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 importai

Tas pats pakeitimas taikomas ir CSS importams:

Prieš (v6):

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

Po (v7):

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

Atgalinis suderinamumas

Prefiksas blockstudio/ vis dar palaikomas dėl atgalinio suderinamumo. Jūsų esamas kodas ir toliau veiks be pakeitimų. Vis dėlto rekomenduojame pereiti prie prefikso npm:, kad jis derėtų su platesne JavaScript ekosistema.

Prefiksas npm: turi keletą privalumų:

  • Suderinamumas su ekosistema – Atitinka nusistovėjusią Deno konvenciją
  • Aiškumas – Iš karto matyti, kad importuojate iš npm
  • Parengtis ateičiai – Prefikso blockstudio/ gali būti atsisakyta būsimoje pagrindinėje versijoje

Kabliukų pavadinimai

Blockstudio 7 suvienodina visų PHP kabliukų pavadinimus: naudojamas snake_case, o ne camelCase, taip juos suderinant su WordPress pagrindinėmis konvencijomis.

Pakeisti kabliukų pavadinimai

Senas pavadinimas (v6) Naujas pavadinimas (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

Atgalinis suderinamumas

Senieji „camelCase“ kabliukų pavadinimai vis dar palaikomi dėl atgalinio suderinamumo. Jūsų esamas kodas ir toliau veiks be pakeitimų. Vis dėlto, siekiant nuoseklumo, rekomenduojame pereiti prie naujų „snake_case“ pavadinimų.

Perėjimo pavyzdys:

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

Kanoninės blokų žymos

Blockstudio 7.6 ir toliau palaiko projektų prefiksus ir tikslius slapyvardžius kaip vykdymo aplinkos išplėtimo taškus, tačiau pavyzdžiuose, katalogo išvestyje, atvaizdavimo deklaracijose ir diagnostikoje naudoja <bs:namespace-slug> kaip kanoninę rašybą. Kanoninės žymos nurodo tikrąjį registruotą bloko pavadinimą ir nepriklauso nuo konkrečios aplinkos filtro.

Projektui, kuriame yra brand => ["theme-components"] ir 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>

Atskira perėjimo komanda inventorizuoja esamą projektą ir perrašo trumpinius kanonine rašyba. Pirmiausia pateikiama ataskaita, neišspręsti atvejai blokuoja procesą, keičiami tik žymų pavadinimai. Komandą, jos įvestis ir saugaus veikimo principus rasite puslapyje Blokų žymų perėjimas.

Išteklių failų pavadinimai

Blockstudio 7 pristato taškinę išteklių failų plėtinių žymėjimo notaciją, kuri rekomenduojama vietoj senosios brūkšninės notacijos.

Pakeisti failų pavadinimai

Senas pavadinimas (v6) Naujas pavadinimas (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

Atgalinis suderinamumas

Senoji brūkšninė notacija vis dar palaikoma dėl atgalinio suderinamumo. Jūsų esami failai ir toliau veiks be pervadinimo. Vis dėlto naujiems blokams rekomenduojame pereiti prie taškinės notacijos.

Perėjimo pavyzdys:

Kodas
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

Lauko jungiklis

Savybės switch numatytoji reikšmė dabar yra false, o ne true. v6 kiekvienas laukas turėjo nematomą jungiklį kairiajame krašte, kuris pagal numatytuosius nustatymus buvo įjungtas. v7 jungiklis įjungiamas pasirinktinai, o lauko etiketėje rodoma akies piktograma.

Kas pasikeitė

  • Numatytoji reikšmė dabar yra false: laukai nebeturi jungiklio, nebent aiškiai nustatote "switch": true
  • Matoma akies piktograma: vietoj paslėptos spustelėjimo srities kairėje, etiketės srityje rodomas mygtukas su akies piktograma
  • Išjungto lauko uždanga: išjungus lauką, rodoma suliejimo uždanga su tekstu „Šis laukas išjungtas“, o ne tik sumažinamas neskaidrumas

Perėjimas

Jei naudojote numatytąją jungiklio veikseną v6, turite ją įjungti aiškiai:

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

Jei anksčiau nustatėte "switch": false, kad išjungtumėte perjungimą, galite jį pašalinti, nes dabar numatytoji reikšmė yra false.

Tailwind CSS

Blockstudio 7 visiškai pakeičia v6 Tailwind metodą. v6 aplinkoje Tailwind CSS buvo kompiliuojamas kliento pusėje per redaktoriaus CDN ir įrašomas į diską išsaugojus įrašą. v7 aplinkoje Tailwind CSS kompiliuojamas serverio pusėje per kiekvieną sąsajos užklausą naudojant TailwindPHP, o failai automatiškai talpinami į podėlį.

Išsamią informaciją apie naująją sistemą rasite dokumentacijoje Tailwind CSS.

Nuolatinis kompiliavimas serverio pusėje

Kai tailwind.enabled yra true, kiekviena sąsajos užklausa kompiliuojama serverio pusėje. Kompiliavimo eiga:

  1. WordPress atvaizduoja visą puslapį HTML į išvesties buferį
  2. CSS klasių kandidatai ištraukiami iš HTML (greita regex paieška, be kompiliavimo)
  3. Kandidatai surūšiuojami ir maišos funkcija apdorojami kartu su konfigūracija CSS, kad būtų sukurtas podėlio raktas
  4. Radus podėlio įrašą: nuskaitomas podėlyje esantis failas CSS ir įterpiamas
  5. Neradus podėlio įrašo: TailwindPHP kompiliuoja CSS, įrašo jį į bendrinamą Blockstudio vykdymo aplinkos podėlį tailwind srityje ir įterpia

Kompiliuota CSS įterpiama kaip įterptinė <style id="blockstudio-tailwind"> žyma prieš </head>. Įtraukiama Tailwind pradinė parengtis ir visos atitinkančios pagalbinės klasės.

Scenarijus CDN redaktoriuje ir toliau naudojamas tik tiesioginei peržiūrai. Sąsajoje jis niekada nepateikiamas.

Pasikeitęs config formatas

Savybė config pakeista: vietoj objekto JSON (Tailwind v3) naudojama eilutė CSS (sintaksė Tailwind v4 CSS pirmiausia).

Prieš (v6):

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

Po (v7):

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

Pašalintas nustatymas customClasses

Masyvo nustatymas customClasses pašalintas. Taikant Tailwind v4 CSS pirmiausia metodą, pasirinktinės pagalbinės klasės tiesiogiai apibrėžiamos eilutėje config naudojant @layer utilities.

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

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

Arba naudokite filtrą kelių eilučių konfigūracijoms:

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

Filtras blockstudio/settings/tailwind/custom_classes taip pat pašalintas. Norėdami pridėti pasirinktines CSS taisykles, naudokite filtrą blockstudio/tailwind/css.

Pašalintas REST galinis taškas

Galinis taškas POST /blockstudio/v1/editor/tailwind/save pašalintas. Kompiliuota CSS nebėra išsaugoma iš redaktoriaus. Jei jūsų tinkintame kode buvo iškviečiamas šis galinis taškas, jį galima saugiai pašalinti.

Spartinimas

Blockstudio naudoja kandidatais pagrįstą spartinimo strategiją. Užuot apskaičiavus viso puslapio HTML maišą (dėl vienkartinių kodų ir laiko žymų podėlis būtų išvalomas su kiekviena užklausa), apskaičiuojami tik CSS klasių kandidatų maišai. Tai reiškia:

  • Du puslapiai su tomis pačiomis CSS klasėmis naudoja tą patį podėlio failą
  • Dinaminis turinys (vienkartiniai kodai, administravimo juostos, laiko žymos) neišvalo podėlio
  • Podėlis atnaujinamas tik pasikeitus CSS klasių rinkiniui arba konfigūracijai

Podėlio failai saugomi sukonfigūruotame vykdymo aplinkos šakniniame kataloge Blockstudio, esančiame sites/{network-blog}/{runtime-identity}/tailwind/. Norėdami priverstinai kompiliuoti iš naujo, iškvieskite Blockstudio\Runtime_Cache::purge('tailwind').

Filtrų pakeitimai

Senas pavadinimas (v6) Naujas pavadinimas (v7)
blockstudio/tailwind/on_demand/css blockstudio/tailwind/css
blockstudio/tailwind/assets/dir Pašalintas
blockstudio/settings/tailwind/custom_classes Pašalintas

Pašalinti failai ir įkėlimai

v6 aplinkoje Tailwind CSS buvo įkeliamas kaip išoriniai stilių aprašai (blockstudio-tailwind, blockstudio-tailwind-preflight). v7 aplinkoje visas CSS įterpiamas tiesiogiai naudojant išvesties buferį. Sąsajoje nėra jokių Tailwind nuorodų žymų ar įkeliamų stilių aprašų.

Blokų biblioteka

Integruotoji biblioteka „Blockstudio Elements“ pašalinta. Nustatymas library aplinkoje blockstudio.json ir filtras blockstudio/settings/library nebeturi jokio poveikio.

Jei naudojote bibliotekos blokus (Gallery, Slider, Image Comparison, Code, Icon), nukopijuokite blokų aplankus iš savo v6 diegimo katalogo includes/library/blockstudio-element/ į temos blockstudio katalogą ir atnaujinkite jų failus block.json, įrašydami naujus pavadinimus ir kategorijas.