Μετάβαση στο περιεχόμενο

Μετάβαση στο v7

Αυτός ο οδηγός καλύπτει τις αλλαγές που πρέπει να κάνετε κατά την αναβάθμιση από το Blockstudio 6 στην έκδοση 7.

Εισαγωγές ES Module

Το Blockstudio 7 εισάγει ένα νέο πρόθεμα npm: για εισαγωγές ES module, σε συμφωνία με τη σύμβαση Deno specifiernpm.

Πριν (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";

Μετά (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

Η ίδια αλλαγή ισχύει και για τις εισαγωγές CSS:

Πριν (v6):

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

Μετά (v7):

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

Συμβατότητα με παλαιότερες εκδόσεις

Το πρόθεμα blockstudio/ εξακολουθεί να υποστηρίζεται για συμβατότητα με παλαιότερες εκδόσεις. Ο υπάρχων κώδικάς σας θα συνεχίσει να λειτουργεί χωρίς αλλαγές. Ωστόσο, συνιστούμε να μεταβείτε στο πρόθεμα npm: για συνέπεια με το ευρύτερο οικοσύστημα JavaScript.

Το πρόθεμα npm: προσφέρει αρκετά πλεονεκτήματα:

  • Εναρμόνιση με το οικοσύστημα – Ακολουθεί την καθιερωμένη σύμβαση του Deno
  • Σαφήνεια – Δείχνει αμέσως ότι εισάγετε από το npm
  • Προετοιμασία για το μέλλον – Το πρόθεμα blockstudio/ ενδέχεται να καταργηθεί σε μια μελλοντική κύρια έκδοση

Ονόματα hook

Το Blockstudio 7 τυποποιεί όλα τα ονόματα hook PHP, ώστε να χρησιμοποιούν snake_case αντί για camelCase, σύμφωνα με τις βασικές συμβάσεις του WordPress.

Ονόματα hook που άλλαξαν

Παλιό όνομα (v6) Νέο όνομα (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

Συμβατότητα με παλαιότερες εκδόσεις

Τα παλιά ονόματα hook σε camelCase εξακολουθούν να υποστηρίζονται για συμβατότητα με παλαιότερες εκδόσεις. Ο υπάρχων κώδικάς σας θα συνεχίσει να λειτουργεί χωρίς αλλαγές. Ωστόσο, συνιστούμε να μεταβείτε στα νέα ονόματα snake_case για συνέπεια.

Παράδειγμα μετάβασης:

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

Κανονικές ετικέτες block

Το Blockstudio 7.6 διατηρεί τα προθέματα έργου και τα ακριβή ψευδώνυμα ως σημεία επέκτασης κατά τον χρόνο εκτέλεσης, αλλά χρησιμοποιεί το <bs:namespace-slug> ως κανονική γραφή στα παραδείγματα, στην έξοδο καταλόγου, στις δηλώσεις απόδοσης και στα διαγνωστικά. Οι κανονικές ετικέτες περιέχουν το πραγματικό καταχωρισμένο όνομα block και δεν εξαρτώνται από φίλτρο συγκεκριμένου host.

Για ένα έργο με brand => ["theme-components"] και 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>

Μια αυτόνομη εντολή μετάβασης καταγράφει τα στοιχεία ενός υπάρχοντος έργου και ξαναγράφει τις συντομογραφίες με την κανονική γραφή. Πρώτα παράγει αναφορά, σταματά όταν υπάρχουν ανεπίλυτες περιπτώσεις και αλλάζει μόνο τα ονόματα των ετικετών. Δείτε τη σελίδα Μετάβαση ετικετών block για την εντολή, τις εισόδους της και τη συμπεριφορά ασφαλείας της.

Ονομασία αρχείων πόρων

Το Blockstudio 7 εισάγει τη σημειογραφία με τελείες για τις καταλήξεις αρχείων πόρων, αντικαθιστώντας την παλιά σημειογραφία με παύλες ως συνιστώμενη σύμβαση.

Ονόματα αρχείων που άλλαξαν

Παλιό όνομα (v6) Νέο όνομα (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

Συμβατότητα με παλαιότερες εκδόσεις

Η παλιά σημειογραφία με παύλες εξακολουθεί να υποστηρίζεται για συμβατότητα με παλαιότερες εκδόσεις. Τα υπάρχοντα αρχεία σας θα συνεχίσουν να λειτουργούν χωρίς μετονομασία. Ωστόσο, συνιστούμε να μεταβείτε στη σημειογραφία με τελείες για νέα block.

Παράδειγμα μετάβασης:

Κώδικας
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

Διακόπτης πεδίου

Η ιδιότητα switch έχει πλέον ως προεπιλογή την τιμή false αντί για true. Στο v6, κάθε πεδίο είχε έναν αόρατο διακόπτη στο αριστερό άκρο, ενεργοποιημένο από προεπιλογή. Στο v7, ο διακόπτης είναι προαιρετικός και χρησιμοποιεί ένα ορατό εικονίδιο ματιού στην ετικέτα του πεδίου.

Τι άλλαξε

  • Η προεπιλογή είναι πλέον false: τα πεδία δεν έχουν πλέον διακόπτη, εκτός αν ορίσετε ρητά το "switch": true
  • Ορατό εικονίδιο ματιού: αντί για μια κρυφή ζώνη κλικ στα αριστερά, εμφανίζεται κουμπί με εικονίδιο ματιού στην περιοχή της ετικέτας
  • Επικάλυψη απενεργοποίησης: όταν ένα πεδίο είναι απενεργοποιημένο, εμφανίζεται μια θολή επικάλυψη με το κείμενο «Αυτό το πεδίο είναι απενεργοποιημένο» αντί να μειώνεται απλώς η αδιαφάνεια

Μετάβαση

Αν βασιζόσασταν στην προεπιλεγμένη συμπεριφορά διακόπτη στο v6, πρέπει να τον ενεργοποιήσετε ρητά:

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

Αν είχατε ορίσει προηγουμένως το "switch": false για να απενεργοποιήσετε τον διακόπτη, μπορείτε να το αφαιρέσετε, καθώς πλέον το false είναι η προεπιλογή.

Tailwind CSS

Το Blockstudio 7 αντικαθιστά πλήρως την προσέγγιση v6 Tailwind. Στο v6, το Tailwind CSS μεταγλωττιζόταν στην πλευρά του client μέσω του CDN στον editor και αποθηκευόταν στον δίσκο κατά την αποθήκευση της ανάρτησης. Στο v7, το Tailwind CSS μεταγλωττίζεται στην πλευρά του server σε κάθε αίτημα frontend μέσω του TailwindPHP, με αυτόματη προσωρινή αποθήκευση βάσει αρχείων.

Για όλες τις λεπτομέρειες σχετικά με το νέο σύστημα, δείτε την τεκμηρίωση Tailwind CSS.

Συνεχής μεταγλώττιση στην πλευρά του server

Όταν το tailwind.enabled είναι true, κάθε αίτημα frontend μεταγλωττίζεται στην πλευρά του server. Η ροή μεταγλώττισης:

  1. Το WordPress αποδίδει ολόκληρη τη σελίδα HTML σε ένα buffer εξόδου
  2. Τα υποψήφια ονόματα κλάσεων CSS εξάγονται από το HTML (γρήγορη regex, χωρίς μεταγλώττιση)
  3. Τα υποψήφια ονόματα ταξινομούνται και κατακερματίζονται με τη διαμόρφωση CSS για τη δημιουργία κλειδιού προσωρινής αποθήκευσης
  4. Σε επιτυχημένη εύρεση στην προσωρινή μνήμη: γίνεται ανάγνωση και εισαγωγή του αποθηκευμένου αρχείου CSS
  5. Σε αποτυχία εύρεσης: το TailwindPHP μεταγλωττίζει το CSS, το γράφει στην κοινόχρηστη προσωρινή μνήμη εκτέλεσης του Blockstudio στην εμβέλεια tailwind και το εισάγει

Το μεταγλωττισμένο CSS εισάγεται ως ενσωματωμένη ετικέτα <style id="blockstudio-tailwind"> πριν από το </head>. Περιλαμβάνει το preflight του Tailwind και όλες τις αντιστοιχισμένες βοηθητικές κλάσεις.

Το script CDN παραμένει ενεργό στον editor μόνο για ζωντανή προεπισκόπηση. Δεν σερβίρεται ποτέ στο frontend.

Άλλαξε η μορφή του config

Η ιδιότητα config άλλαξε από αντικείμενο JSON (Tailwind v3) σε συμβολοσειρά CSS (σύνταξη με προτεραιότητα στο Tailwind v4 CSS).

Πριν (v6):

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

Μετά (v7):

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

Καταργήθηκε η ρύθμιση customClasses

Η ρύθμιση πίνακα customClasses έχει καταργηθεί. Με την προσέγγιση του CSS με προτεραιότητα στο Tailwind v4, οι προσαρμοσμένες βοηθητικές κλάσεις ορίζονται απευθείας στη συμβολοσειρά config με χρήση του @layer utilities.

Πριν (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" }
    ]
  }
}

Μετά (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; } }"
  }
}

Ή μέσω του φίλτρου για πολυγραμμικές διαμορφώσεις:

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

Το φίλτρο blockstudio/settings/tailwind/custom_classes έχει επίσης καταργηθεί. Χρησιμοποιήστε το φίλτρο blockstudio/tailwind/css για να προσθέσετε προσαρμοσμένους κανόνες CSS.

Καταργήθηκε το τελικό σημείο REST

Το τελικό σημείο POST /blockstudio/v1/editor/tailwind/save έχει καταργηθεί. Το μεταγλωττισμένο CSS δεν αποθηκεύεται πλέον από τον editor. Αν είχατε προσαρμοσμένο κώδικα που καλούσε αυτό το τελικό σημείο, μπορείτε να τον αφαιρέσετε με ασφάλεια.

Προσωρινή αποθήκευση

Το Blockstudio χρησιμοποιεί στρατηγική προσωρινής αποθήκευσης βάσει υποψήφιων ονομάτων. Αντί να κατακερματίζει ολόκληρο το HTML της σελίδας (κάτι που θα ακύρωνε την προσωρινή μνήμη σε κάθε αίτημα λόγω nonce και χρονικών σημάνσεων), κατακερματίζει μόνο τα υποψήφια ονόματα κλάσεων CSS. Αυτό σημαίνει ότι:

  • Δύο σελίδες με τις ίδιες κλάσεις CSS μοιράζονται το ίδιο αποθηκευμένο αρχείο
  • Το δυναμικό περιεχόμενο (nonce, γραμμές διαχείρισης, χρονικές σημάνσεις) δεν ακυρώνει την προσωρινή μνήμη
  • Η προσωρινή μνήμη ακυρώνεται μόνο όταν αλλάξει το σύνολο των κλάσεων CSS ή η διαμόρφωση

Τα αρχεία προσωρινής μνήμης χρησιμοποιούν τη διαμορφωμένη ρίζα εκτέλεσης Blockstudio στο sites/{network-blog}/{runtime-identity}/tailwind/. Καλέστε το Blockstudio\Runtime_Cache::purge('tailwind') για να επιβάλετε επαναμεταγλώττιση.

Αλλαγές φίλτρων

Παλιό όνομα (v6) Νέο όνομα (v7)
blockstudio/tailwind/on_demand/css blockstudio/tailwind/css
blockstudio/tailwind/assets/dir Καταργήθηκε
blockstudio/settings/tailwind/custom_classes Καταργήθηκε

Αρχεία και φορτώσεις που καταργήθηκαν

Στο v6, το Tailwind CSS φορτωνόταν ως εξωτερικά φύλλα στυλ (blockstudio-tailwind, blockstudio-tailwind-preflight). Στο v7, όλο το CSS εισάγεται ενσωματωμένο μέσω buffer εξόδου. Δεν υπάρχουν ετικέτες link ή φορτωμένα φύλλα στυλ για το Tailwind στο frontend.

Βιβλιοθήκη block

Η ενσωματωμένη βιβλιοθήκη «Blockstudio Elements» έχει καταργηθεί. Η ρύθμιση library στο blockstudio.json και το φίλτρο blockstudio/settings/library δεν έχουν πλέον καμία επίδραση.

Αν χρησιμοποιούσατε τα block της βιβλιοθήκης (Gallery, Slider, Image Comparison, Code, Icon), αντιγράψτε τους φακέλους block από την εγκατάσταση v6 στον κατάλογο includes/library/blockstudio-element/ του θέματός σας, μέσα στον κατάλογο blockstudio, και ενημερώστε τα αρχεία block.json με νέα ονόματα και κατηγορίες.