Liigu sisu juurde

Üleminek versioonile v7

See juhend käsitleb muudatusi, mida peate tegema versioonilt Blockstudio 6 versioonile 7 üle minnes.

ES-mooduli impordid

Blockstudio 7 tutvustab ES-moodulite importide jaoks uut eesliidet npm:, mis ühtlustab need Deno npm-spetsiifika tavaga.

Enne (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ärast (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 impordid

Sama muudatus kehtib ka CSS importide kohta:

Enne (v6):

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

Pärast (v7):

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

Tagasiühilduvus

Eesliidet blockstudio/ toetatakse tagasiühilduvuse tagamiseks endiselt. Teie olemasolev kood töötab edasi muutmata kujul. Järjepidevuse huvides soovitame siiski üle minna eesliitele npm:, mis sobitub laiemalt JavaScript ökosüsteemi tavadega.

Eesliitel npm: on mitu eelist:

  • Ökosüsteemiga kooskõla – järgib Deno väljakujunenud tava
  • Selgus – näitab kohe, et impordite moodulist npm
  • Tulevikukindlus – eesliide blockstudio/ võidakse tulevases põhiversioonis aegunuks märkida

Hook’ide nimed

Blockstudio 7 ühtlustab kõik PHP hook’ide nimed: camelCase asemel kasutatakse snake_case, järgides WordPress tuuma tavasid.

Muutunud hook’ide nimed

Vana nimi (v6) Uus nimi (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

Tagasiühilduvus

Vanad camelCase-hook’ide nimed on tagasiühilduvuse tagamiseks endiselt toetatud. Teie olemasolev kood töötab edasi muutmata kujul. Järjepidevuse huvides soovitame siiski üle minna uutele snake_case-nimedele.

Ülemineku näide:

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

Kanoonilised plokisildid

Blockstudio 7.6 säilitab projektide eesliited ja täpsed aliasnimed käitusaja laienduspunktidena, kuid kasutab näidetes, kataloogi väljundis, renderdusdeklaratsioonides ja diagnostikas kanoonilise kirjapildina <bs:namespace-slug>. Kanoonilised sildid sisaldavad ploki tegelikku registreeritud nime ega sõltu hostipõhisest filtrist.

Projektis, kus on brand => ["theme-components"] ja 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>

Eraldiseisev üleminekukäsk loetleb olemasoleva projekti sisu ja kirjutab lühivormid kanoonilisel kujul ümber. See esitab esmalt aruande, peatub lahendamata juhtude korral ja muudab ainult silte. Käsu, sisendite ja ohutu käitumise kohta leiate teavet jaotisest Plokisiltide üleminek.

Varafailide nimetamine

Blockstudio 7 võtab kasutusele varafailide järelliidete punktkirja, mis asendab soovitatava tavanina vana sidekriipsukirja.

Muutunud failinimed

Vana nimi (v6) Uus nimi (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

Tagasiühilduvus

Vana sidekriipsukiri on tagasiühilduvuse tagamiseks endiselt toetatud. Teie olemasolevad failid töötavad edasi ka ilma ümbernimetamiseta. Uute plokkide puhul soovitame siiski kasutada punktkirja.

Ülemineku näide:

Kood
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

Väljalüliti

Atribuudi switch vaikeväärtus on nüüd false, mitte true. Versioonis v6 oli igal väljal vasakus servas vaikimisi sisse lülitatud nähtamatu lüliti. Versioonis v7 on lüliti valikuline ja selle asemel kuvatakse välja sildil nähtav silmaikoon.

Mis muutus

  • Vaikeväärtus on nüüd false: väljadel pole enam lülitit, kui te ei määra sõnaselgelt "switch": true
  • Nähtav silmaikoon: peidetud vasakpoolse klõpsuala asemel kuvatakse sildialal silmaikooniga nupp
  • Keelatud välja ülekate: kui väli on keelatud, kuvatakse üksnes läbipaistvuse vähendamise asemel hägustav ülekate tekstiga "See väli on keelatud"

Üleminek

Kui kasutasite versioonis v6 lülitit vaikeväärtuse põhjal, peate selle sõnaselgelt lubama:

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

Kui määrasite varem "switch": false lüliti keelamiseks, võite selle eemaldada, sest nüüd on vaikeväärtus false.

Tailwind CSS

Blockstudio 7 asendab täielikult lähenemisviisi v6 Tailwind. v6-s kompileeriti Tailwind CSS redaktoris CDN abil kliendipoolselt ja salvestati postituse salvestamisel kettale. v7-s kompileeritakse Tailwind CSS iga esikülje päringu ajal serveripoolselt TailwindPHP abil ning failipõhine vahemälu luuakse automaatselt.

Uue süsteemi täieliku kirjelduse leiate Tailwind CSS dokumentatsioonist.

Alati sisse lülitatud serveripoolne kompileerimine

Kui tailwind.enabled on true, kompileeritakse iga eesliidese päring serveris. Kompileerimine käib nii:

  1. WordPress renderdab kogu lehe HTML väljundpuhvrisse
  2. HTML-st eraldatakse CSS klassikandidaadid (kiire regulaaravaldis, kompileerimist pole vaja)
  3. Kandidaadid sorditakse ja räsitakse koos konfiguratsiooniga CSS vahemälu võtme loomiseks
  4. Vahemälutabamuse korral loetakse vahemällu salvestatud fail CSS ja lisatakse väljundisse
  5. Vahemälumöödalasu korral kompileerib TailwindPHP CSS, kirjutab selle Blockstudio jagatud käitusaja vahemällu ulatuses tailwind ja lisab väljundisse

Kompileeritud CSS lisatakse tekstisisese sildina <style id="blockstudio-tailwind"> enne elementi </head>. See sisaldab Tailwind lähtestuslaadi ja kõiki sobitatud utiliidiklasse.

Skript CDN jääb redaktoris aktiivseks ainult reaalajas eelvaate jaoks. Eesliideses seda kunagi ei edastata.

Muutus vormingus config

Atribuut config muutus objektist JSON (Tailwind v3) stringiks CSS (Tailwind v4 süntaks, kus esimene element on CSS).

Enne (v6):

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

Pärast (v7):

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

Seadistus customClasses eemaldati

Massiivi seadistus customClasses on eemaldatud. Lähenemisega Tailwind v4, kus esikohal on CSS, määratletakse kohandatud utiliidiklassid otse stringis config, kasutades @layer utilities.

Enne (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ärast (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; } }"
  }
}

Või mitmerealiste konfiguratsioonide puhul filtri kaudu:

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

Samuti on eemaldatud filter blockstudio/settings/tailwind/custom_classes. Kohandatud CSS-reeglite lisamiseks kasutage selle asemel filtrit blockstudio/tailwind/css.

Lõpp-punkt REST eemaldati

Lõpp-punkt POST /blockstudio/v1/editor/tailwind/save on eemaldatud. Kompileeritud CSS-i ei salvestata enam redaktorist. Kui teil on kohandatud kood, mis seda lõpp-punkti kutsub, võite selle ohutult eemaldada.

Vahemällu salvestamine

Blockstudio kasutab kandidaatidel põhinevat vahemällu salvestamist. Kogu lehe HTML räsimise asemel (mis tühjendaks vahemälu iga päringuga nonce’ide ja ajatemplite tõttu) räsitakse ainult CSS klassikandidaadid. See tähendab järgmist:

  • Kaks sama CSS-klassiga lehte jagavad sama vahemällu salvestatud faili
  • Dünaamiline sisu (nonce’id, haldusribad, ajatemplid) ei tühjenda vahemälu
  • Vahemälu tühjeneb ainult siis, kui CSS klasside hulk või konfiguratsioon muutub

Vahemälufailid kasutavad seadistatud Blockstudio käitusaja juurkausta asukohas sites/{network-blog}/{runtime-identity}/tailwind/. Ümberkompileerimise sundimiseks kutsuge välja Blockstudio\Runtime_Cache::purge('tailwind').

Filtrite muudatused

Vana nimi (v6) Uus nimi (v7)
blockstudio/tailwind/on_demand/css blockstudio/tailwind/css
blockstudio/tailwind/assets/dir Eemaldatud
blockstudio/settings/tailwind/custom_classes Eemaldatud

Eemaldatud failid ja järjekorda lisamised

Versioonis v6 lisati Tailwind CSS väliste stiililehtedena (blockstudio-tailwind, blockstudio-tailwind-preflight). Versioonis v7 lisatakse kogu CSS tekstisiseselt väljundpuhvri kaudu. Eesliideses pole Tailwind jaoks lingisilte ega järjekorda lisatud stiililehti.

Plokiteek

Sisseehitatud teek “Blockstudio Elements” on eemaldatud. Seadistus library asukohas blockstudio.json ja filter blockstudio/settings/library ei avalda enam mingit mõju.

Kui kasutasite teegi plokke (Gallery, Slider, Image Comparison, Code, Icon), kopeerige plokkide kaustad oma v6 paigalduse kataloogist includes/library/blockstudio-element/ teema kataloogi blockstudio ning uuendage nende block.json faile uute nimede ja kategooriatega.