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

Επεκτάσεις

Οι επεκτάσεις σάς επιτρέπουν να επεκτείνετε οποιοδήποτε καταχωρισμένο μπλοκ στην εγκατάσταση WordPress σας, χρησιμοποιώντας μια απλή διαμόρφωση API βασισμένη σε .json, παρόμοια με τη διαμόρφωση block.json. Αυτό περιλαμβάνει τα βασικά μπλοκ, μπλοκ τρίτων και μπλοκ που έχουν δημιουργηθεί με το Blockstudio.

Μπορείτε να προσθέσετε όλους τους τύπους πεδίων σε οποιοδήποτε μπλοκ, με τα δεδομένα να αποθηκεύονται στα γνωρίσματα του μπλοκ. Όλες οι δυνατότητες των γνωρισμάτων είναι διαθέσιμες και για τις επεκτάσεις, όπως το φιλτράρισμα, η απενεργοποίηση, η υπό όρους λογική και η συμπλήρωση επιλογών.

Τύποι επεκτάσεων

Οι εκτεταμένες τιμές μπορούν να αξιοποιηθούν με πολλούς τρόπους:

  • class: Προσθέστε μια κλάση στο block χρησιμοποιώντας την τιμή του γνωρίσματος
  • style: Προσθέστε ενσωματωμένα στυλ στο block χρησιμοποιώντας την τιμή του γνωρίσματος
  • attributes: Ορίστε οποιαδήποτε τιμή γνωρίσματος απευθείας στο block
  • data attributes: Χρησιμοποιήστε τιμές επέκτασης για να ορίσετε συγκεκριμένα γνωρίσματα δεδομένων

Ρύθμιση

Φανταστείτε το εξής σενάριο: θέλετε να προσθέσετε ένα πεδίο προσαρμοσμένης κλάσης select σε κάθε βασικό block. Αρκεί να προσθέσετε αυτό το αρχείο .json οπουδήποτε στον φάκελο των block σας και θα καταχωριστεί αυτόματα ως επέκταση.

JSON
{
  "$schema": "https://blockstudio.dev/schema/extend",
  "name": "core/*",
  "priority": 10,
  "blockstudio": {
    "extend": true,
    "attributes": [
      {
        "id": "customColor",
        "type": "select",
        "label": "Custom color",
        "options": [
          {
            "value": "#f00",
            "label": "Red"
          },
          {
            "value": "#00f",
            "label": "Blue"
          }
        ],
        "set": [
          {
            "attribute": "style",
            "value": "color: {attributes.customColor}"
          }
        ]
      }
    ]
  }
}

Έτσι, θα προστεθεί ένα πεδίο customColor σε κάθε βασικό block, ώστε να μπορείτε να ορίσετε το χρώμα του κειμένου του block.

Όνομα αρχείου

Εφόσον δεν υπάρχει πρότυπο απόδοσης, μια επέκταση δεν χρειάζεται αντίστοιχο αρχείο index και, επομένως, δεν χρειάζεται να ονομάζεται block.json. Έτσι, μπορείτε να αποθηκεύετε εύκολα όλες τις επεκτάσεις σε έναν φάκελο. Αρκετά αρχεία μπορούν να επεκτείνουν τα ίδια block, για παράδειγμα δύο αρχεία με "name": "core/*"· καθένα καταχωρίζει τα δικά του πεδία.

Σχήμα

Το Blockstudio παρέχει ένα προσαρμοσμένο σχήμα JSON για τις ρυθμίσεις επέκτασης:

Προβολή σχήματος επέκτασης

Όνομα

Η ιδιότητα name του αντικειμένου ρυθμίσεων καθορίζει ποια block θα επεκταθούν. Ανάλογα με τις ανάγκες σας, υπάρχουν τρεις επιλογές:

  • blockName: Ένα μόνο όνομα block, e.g. core/paragraph
  • [blockNameA, blockNameB]: Μια λίστα ονομάτων block, e.g. ["core/paragraph", "core/heading"]
  • core/*: Μπαλαντέρ για την επέκταση όλων των block ενός συγκεκριμένου τύπου

Κάθε όνομα που τελειώνει σε αστερίσκο είναι χαρακτήρας μπαλαντέρ προθέματος, όχι μόνο το core/*. Η παρακάτω επέκταση εφαρμόζεται σε κάθε μπλοκ του οποίου το όνομα αρχίζει με my-plugin/, συμπεριλαμβανομένων των μπλοκ που δημιουργούνται με Blockstudio:

JSON
{
  "name": "my-plugin/*",
  "blockstudio": {
    "extend": true,
    "attributes": []
  }
}

Εξαίρεση μπλοκ

Χρησιμοποιήστε έναν πίνακα exclude ανώτατου επιπέδου για να παραλείψετε μπλοκ που διαφορετικά θα ταίριαζαν με name:

JSON
{
  "$schema": "https://blockstudio.dev/schema/extend",
  "name": "core/*",
  "exclude": ["core/button", "core/image"],
  "blockstudio": {
    "extend": true,
    "attributes": []
  }
}

Οι εξαιρέσεις χρησιμοποιούν την ίδια αντιστοίχιση ακριβούς ονόματος και προθέματος με τελικό * όπως το name. Έχουν προτεραιότητα έναντι μεμονωμένων ονομάτων, λιστών ονομάτων και χαρακτήρων μπαλαντέρ. Ένα εξαιρούμενο μπλοκ δεν λαμβάνει ούτε τα πεδία επεξεργασίας της επέκτασης ούτε τα χαρακτηριστικά ή τα στοιχεία ενεργητικού του frontend. Δεν επηρεάζονται άλλες επεκτάσεις που ταιριάζουν. Παραλείψτε το exclude ή χρησιμοποιήστε έναν κενό πίνακα για να διατηρήσετε την υπάρχουσα συμπεριφορά.

Κλειδί Blockstudio

Όπως και όταν χρησιμοποιείτε το block.json για προσαρμοσμένα μπλοκ, η ιδιότητα blockstudio πρέπει να υπάρχει στο αντικείμενο διαμόρφωσης με το extend ορισμένο σε true.

Θέση

Από προεπιλογή, οι επεκτάσεις εμφανίζονται σε δική τους καρτέλα στον επιθεωρητή block. Αν θέλετε να τις μετακινήσετε αλλού, μπορείτε να χρησιμοποιήσετε την ιδιότητα group:

  • settings: Η προεπιλεγμένη θέση
  • styles: Η καρτέλα στυλ
  • advanced: Η καρτέλα για προχωρημένους
JSON
{
  "$schema": "https://blockstudio.dev/schema/extend",
  "name": "core/*",
  "blockstudio": {
    "extend": true,
    "group": "styles",
    "attributes": []
  }
}

Προτεραιότητα

Η ιδιότητα priority σάς επιτρέπει να ορίσετε τη σειρά εμφάνισης των επεκτάσεων. Οι επεκτάσεις με υψηλότερη προτεραιότητα εμφανίζονται αργότερα. Ορίστε την στο ανώτατο επίπεδο του αρχείου, όπως στο παράδειγμα ρύθμισης, ή μέσα στο extend:

JSON
{
  "$schema": "https://blockstudio.dev/schema/extend",
  "name": "core/*",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": []
  }
}

Όταν ορίζονται και τα δύο, υπερισχύει το blockstudio.extend.priority.

Χαρακτηριστικά

Για περισσότερες πληροφορίες σχετικά με τη λειτουργία των γνωρισμάτων, ανατρέξτε στην ενότητα γνωρισμάτων.

Το μόνο που χρειάζεται να γνωρίζετε για τα γνωρίσματα μέσα στις επεκτάσεις είναι η ιδιότητα set. Χρησιμοποιείται για την εφαρμογή της τιμής του γνωρίσματος σε έναν από τους τύπους επέκτασης.

JSON
{
  "$schema": "https://blockstudio.dev/schema/extend",
  "name": "core/*",
  "blockstudio": {
    "extend": true,
    "attributes": [
      {
        "id": "customColor",
        "type": "select",
        "label": "Heading color",
        "options": [
          {
            "value": "#f00",
            "label": "Red"
          },
          {
            "value": "#00f",
            "label": "Blue"
          }
        ],
        "set": [
          {
            "attribute": "style",
            "value": "color: {attributes.customColor}"
          }
        ]
      }
    ]
  }
}

Λήψη τιμών

Για να λάβετε την τιμή ενός γνωρίσματος, χρησιμοποιήστε σημειογραφία με τελείες μέσα σε άγκιστρα.

Μπορείτε επίσης να λάβετε ένθετες τιμές όταν τα γνωρίσματα δεν επιστρέφουν μία μόνο τιμή, για παράδειγμα όταν ορίζετε τη μορφή επιστροφής σε both για τύπους πεδίων με επιλογές.

JSON
{
  "attributes": [
    {
      "id": "customColor",
      "type": "select",
      "label": "Heading color",
      "options": [
        {
          "value": "#f00",
          "label": "Red"
        },
        {
          "value": "#00f",
          "label": "Blue"
        }
      ],
      "returnFormat": "both",
      "set": [
        {
          "attribute": "style",
          "value": "color: {attributes.customColor.value}"
        },
        {
          "attribute": "data-color",
          "value": "{attributes.customColor.label}"
        }
      ]
    }
  ]
}

Το παραπάνω παράδειγμα ορίζει το γνώρισμα style σε color: #f00 ή color: #00f και το γνώρισμα data-color σε Red ή Blue, ανάλογα με την τιμή.

Προς το παρόν, στους ορισμούς set μπορούν να χρησιμοποιούνται μόνο τιμές από το τρέχον γνώρισμα. Η δυνατότητα χρήσης τιμών από άλλα γνωρίσματα ενδέχεται να προστεθεί στο μέλλον.

Πίνακες

Όταν χρησιμοποιείτε πίνακες, η ιδιότητα set εφαρμόζεται σε κάθε στοιχείο του πίνακα.

Κάθε στοιχείο προσθέτει τη δική του κλάση ή δήλωση στυλ. Κάθε άλλο χαρακτηριστικό έχει μία μόνο τιμή, επομένως κάθε στοιχείο την αντικαθιστά και επικρατεί το τελευταίο. Ορίστε το join σε true για να γράφονται αντί γι’ αυτό τα αποτελέσματα όλων των στοιχείων, χωρισμένα με κενά και χωρίς κενές ή επαναλαμβανόμενες τιμές, ώστε ένας επιλογέας όπως το [data-langs~="en"] να αντιστοιχεί σε κάθε επιλεγμένο στοιχείο. Το join δεν επηρεάζει τα class και style ούτε πεδία που επιστρέφουν μία μόνο τιμή.

JSON
{
  "id": "langs",
  "type": "checkbox",
  "label": "Languages",
  "options": [
    {
      "value": "en",
      "label": "English"
    },
    {
      "value": "de",
      "label": "German"
    }
  ],
  "set": [
    {
      "attribute": "data-langs",
      "value": "{attributes.langs}",
      "join": true
    }
  ]
}

Αν επιλέξετε και τις δύο επιλογές, αποδίδεται το data-langs="en de". Χωρίς το join, αποδίδεται το data-langs="de".

Πεδίο γνωρισμάτων

Όταν χρησιμοποιείτε το πεδίο attributes, δεν χρειάζεται η ιδιότητα set, καθώς το πεδίο αντιστοιχίζει αυτόματα τις τιμές στο όνομα και την τιμή του γνωρίσματος.

Έλεγχος πεδίων επέκτασης

Το bs_block_extension_fields('core/paragraph') επιστρέφει τους ορισμούς πεδίων κάθε επέκτασης που αντιστοιχεί σε ένα μπλοκ. Δείτε την ενότητα Έλεγχος μπλοκ για την τιμή επιστροφής και τη σχέση της με το bs_block_fields().