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

Προσαρμοσμένα μπλοκ σε 3 αρχεία

Χωρίς JavaScript, χωρίς βήμα δημιουργίας, χωρίς περιττό κώδικα.

Ορίστε πεδία στο JSON

Προσθέστε ένα κλειδί blockstudio στο block.json. Ορίστε γνωρίσματα με τύπους όπως text, toggle και color. Το Blockstudio δημιουργεί αυτόματα το UI του επεξεργαστή, με τύπους πεδίων 27 από πεδία εισαγωγής κειμένου έως επαναλήπτες και επεξεργαστές κώδικα, καθώς και τύπους πεδίων που καταχωρίζετε εσείς.

Η πλήρης υποστήριξη σχήματος JSON παρέχει αυτόματη συμπλήρωση και επικύρωση στο VS Code, στο PhpStorm και σε κάθε συμβατό επεξεργαστή.

Κάθε πεδίο μπορεί να ορίσει ένα default για νέα blocks και ένα fallback που λαμβάνει το πρότυπο όσο το πεδίο είναι κενό.

block.json
{
  "name": "starter/hero",
  "title": "Hero",
  "blockstudio": {
    "attributes": [
      { "id": "heading", "type": "text", "label": "Heading" },
      { "id": "showCta", "type": "toggle", "label": "Show CTA" },
      { "id": "background", "type": "color", "label": "Background" }
    ]
  }
}

Ροή εργασίας 3 αρχείων

Το block.json για τα πεδία, ένα πρότυπο για τη σήμανση και ένα προαιρετικό φύλλο στυλ.

React στο PHP

Τα RichText, InnerBlocks και useBlockProps λειτουργούν απευθείας σε PHP, Twig ή Blade.

SCSS και Tailwind

Χρησιμοποιήστε τα CSS, SCSS ή Tailwind. Το SCSS υποστηρίζει διαδρομές εισαγωγής και κοινό πρόλογο, ενώ η επεξεργασία ενός ένθετου μερικού αρχείου μεταγλωττίζει ξανά κάθε αρχείο που το εισάγει.

27 τύποι πεδίων

Κείμενο, χρώμα, εικόνα, επαναλήπτης, επιλογή, επεξεργαστής κώδικα και άλλα, διαμορφωμένα στο JSON.

JSON Schema

Αυτόματη συμπλήρωση και επικύρωση στα VS Code, PhpStorm και σε συμβατούς επεξεργαστές.

Τρεις γλώσσες προτύπων

Τα PHP, Twig και Blade χρησιμοποιούν τις ίδιες μεταβλητές και τα ίδια στοιχεία.

Εισαγωγές npm

Εισαγάγετε πακέτα στο script.js· τοπικά στην παραγωγή και με βάση το CDN στον επεξεργαστή.

Interactivity API

Ενεργοποιήστε την Interactivity του WordPress API με μία σημαία.

Στοιχεία React σε πρότυπα PHP

Χρησιμοποιήστε το <RichText /> για επεξεργασία εντός γραμμής και στατικά frontend HTML, το <InnerBlocks /> για ένθετα blocks και το useBlockProps για το περίβλημα, όλα σε ένα πρότυπο.

Στον επεξεργαστή γίνονται πραγματικά στοιχεία React. Στο frontend αποδίδονται ως HTML από την πλευρά του διακομιστή, χωρίς να αποστέλλεται κανένα JavaScript στους επισκέπτες.

index.php
<div useBlockProps class="container">
  <RichText
    class="text-xl font-semibold"
    tag="h1"
    attribute="headline"
    placeholder="Enter headline"
  />

  <?php if ($a['showCta']): ?>
    <a href="<?= esc_url($a['ctaUrl']) ?>">
      <?= esc_html($a['ctaLabel']) ?>
    </a>
  <?php endif; ?>

  <InnerBlocks class="mt-4 p-4 border" />
</div>

Γράψτε σε PHP, Twig ή Blade

Χρησιμοποιήστε τη γλώσσα προτύπων που γνωρίζετε. Το PHP λειτουργεί άμεσα, το Twig εκτελείται μόλις εγκατασταθεί το Timber και το Blade εκτελείται σε illuminate/view 8 έως 12 μέσω του Blockstudio\Blade_Renderer. Οι μεταβλητές, τα στοιχεία και η συμπεριφορά παραμένουν ίδια.

Τα $a (γνωρίσματα), $b (block), $c (περιβάλλον) και $innerBlocks είναι διαθέσιμα σε κάθε γλώσσα.

Τα πρότυπα λαμβάνουν επίσης ολόκληρο το Twig πλαίσιο Timber. Το Blade αποδίδει επίσης σελίδες, μοτίβα και πρότυπα του Site Editor. Το παλιότερο περιτύλιγμα jenssegers/blade αποτυγχάνει με το illuminate/view 10 και νεότερες εκδόσεις, οπότε χρησιμοποιήστε το Blade_Renderer.

index.twig
<div useBlockProps class="card">
  <RichText tag="h2" attribute="title" placeholder="Card title" />
  {% if a.image %}
    <img src="{{ a.image.url|esc_url }}"
      alt="{{ a.image.alt|esc_attr }}" />
  {% endif %}
  <div class="card__body">{{ a.description|esc_html }}</div>
  <InnerBlocks allowedBlocks='["core/button"]' />
</div>

Λογική υπό όρους και δυναμικές επιλογές

Εμφανίστε και αποκρύψτε πεδία με τελεστές όπως ==, !=, includes, empty και συγκρίσεις. Συνδυάστε συνθήκες με λογική OR.

Οι επιλογές μπορεί να εξαρτώνται από ένα άλλο πεδίο. Προσθέστε το {attributes.post_type.value} στα ορίσματα populate και η λίστα θα φορτώνεται ξανά όταν αλλάζει εκείνο το πεδίο. Προσθέστε το fetch: true για αναζήτηση άρθρων καθώς πληκτρολογεί ο συντάκτης.

Μοιραστείτε μία λίστα επιλογών μεταξύ μπλοκ με το type: custom και το φίλτρο blockstudio/blocks/attributes/populate, και καταχωρίστε δικές σας καθολικές συνθήκες, όπως έναν έλεγχο αγοράς, μέσω του blockstudio/blocks/conditions.

block.json
{
  "name": "starter/posts",
  "title": "Posts",
  "blockstudio": {
    "attributes": [
      {
        "id": "post_type",
        "type": "select",
        "label": "Post type",
        "options": [
          { "value": "page", "label": "Pages" },
          { "value": "post", "label": "Posts" }
        ]
      },
      {
        "id": "selected_post",
        "type": "select",
        "label": "Post",
        "populate": {
          "type": "query",
          "query": "posts",
          "arguments": { "post_type": "{attributes.post_type.value}" }
        }
      },
      {
        "id": "style",
        "type": "select",
        "label": "Style",
        "populate": { "type": "custom", "custom": "cardStyles" },
        "conditions": [[
          { "type": "purchasedProduct", "operator": "==", "value": "yes" }
        ]]
      }
    ]
  }
}

Επαναλήπτες που παραμένουν διαχειρίσιμοι

Ορίστε τα min και max, ξεκινήστε νέα μπλοκ με default σειρές και συμπτύξτε τις υπάρχουσες με το minimized. Το textMinimized ονομάζει μια συμπτυγμένη σειρά με ένα από τα δικά της πεδία, όπως ένα όνομα.

Οι σειρές δέχονται κάθε τύπο πεδίου εκτός από τις καρτέλες, συμπεριλαμβανομένων των ένθετων επαναληπτών. Μια συνθήκη μέσα σε μια σειρά ελέγχει ένα πεδίο εκτός αυτής με το "context": "main", ενώ τα <RichText /> και <MediaPlaceholder /> επεξεργάζονται μία σειρά όταν το attribute τους δείχνει στο repeaterId[index].fieldId.

block.json
{
  "name": "starter/team",
  "title": "Team",
  "blockstudio": {
    "attributes": [
      {
        "id": "members",
        "type": "repeater",
        "label": "Team members",
        "min": 1,
        "max": 12,
        "minimized": true,
        "textMinimized": { "id": "name", "fallback": "Team member" },
        "attributes": [
          { "id": "name", "type": "text", "label": "Name" },
          { "id": "bio", "type": "richtext", "label": "Bio" }
        ]
      }
    ]
  }
}

Επαναχρησιμοποιήσιμα σύνολα πεδίων

Ορίστε μια ομάδα πεδίων μία φορά σε ένα field.json και αναφερθείτε σε αυτή από οποιοδήποτε μπλοκ με το "type": "custom/cta". Τα πεδία ενσωματώνονται, ώστε τα πρότυπα να τα διαβάζουν όπως κάθε άλλο χαρακτηριστικό.

Χρησιμοποιήστε το ίδιο σύνολο δύο φορές με ένα idStructure όπως το hero_{id} και αλλάξτε ετικέτες, προεπιλογές ή συνθήκες ανά μπλοκ με το overrides. Ο τύπος πεδίου block κάνει το ίδιο με ολόκληρο μπλοκ: αναπτύσσει τα πεδία του μπλοκ ενσωματωμένα και επιστρέφει το αποδοσμένο HTML του.

fields/cta/field.json
{
  "name": "cta",
  "title": "Call to action",
  "attributes": [
    { "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
    { "id": "url", "type": "link", "label": "Button URL" }
  ]
}

ES modules χωρίς βήμα δημιουργίας

Προσθέστε το script.js και φορτώνεται ως ES module. Εισαγάγετε πακέτα npm με το πρόθεμα npm: και το Blockstudio τα κατεβάζει τοπικά για την παραγωγή.

Ο επεξεργαστής παρέχει άμεση προεπισκόπηση, ενώ το frontend χρησιμοποιεί τοπικά modules χωρίς εξωτερικές εξαρτήσεις, τα οποία προστίθενται στην ουρά μόνο μία φορά.

Τα φύλλα στυλ εισάγονται με τον ίδιο τρόπο. Το import "npm:swiper@11.0.0/swiper.min.css" κατεβάζει το αρχείο και το προσθέτει στην ουρά μία φορά ανά έκδοση, ακόμη κι όταν το χρησιμοποιούν πολλά μπλοκ.

script.js
import Swiper from "npm:swiper@11.0.0";
import "npm:swiper@11.0.0/swiper.min.css";

for (const el of document.querySelectorAll(".swiper")) {
  new Swiper(el, {
    slidesPerView: 3,
    spaceBetween: 20,
    loop: true,
  });
}

Ετικέτες μπλοκ πέρα από τα πρότυπα

Αντιστοιχίστε ένα σύντομο πρόθεμα σε έναν χώρο ονομάτων στο blockstudio.json ή μία ετικέτα σε ένα μπλοκ με ένα φίλτρο alias, και το <acme-card> αποδίδει το acme/card. Ενεργοποιήστε το blockTags.enabled για απόδοση ετικετών στο περιεχόμενο άρθρων και στα widget, με περιορισμό από τα μοτίβα allow και deny.

Τα χαρακτηριστικά data-* φτάνουν στο ριζικό στοιχείο του μπλοκ, ενώ τα χαρακτηριστικά html-* φτάνουν εκεί χωρίς το πρόθεμα. Προσθέστε δικούς σας δημιουργούς ετικετών με το blockstudio/block_tags/builders και μετατρέψτε τις συντομογραφίες στη φορητή γραφή <bs:acme-card> με την εντολή migrate-block-tags.

blockstudio.json
{
  "blockTags": {
    "enabled": true,
    "prefixes": {
      "acme": ["acme"],
      "ui": ["acme-ui"]
    },
    "deny": ["acme-ui/admin-*"]
  }
}

Προσαρμοσμένοι τύποι πεδίων

Καταχωρίστε τον δικό σας έλεγχο πεδίου και χρησιμοποιήστε τον όπως ένα ενσωματωμένο πεδίο.

Νησίδες block

Αποθηκεύστε ολόκληρη τη σελίδα στην cache και αποδώστε ένα block κατά το αίτημα του επισκέπτη.

Υπό συνθήκη καταχώριση

Καταχωρίστε ένα μπλοκ μόνο για έναν τύπο άρθρου, έναν ρόλο χρήστη ή άλλη καθολική συνθήκη, ή παραλείψτε το όταν λείπει ένα πρόσθετο ή μια έκδοση πρόσθετου που χρειάζεται.

Μεταδεδομένα αναρτήσεων και επιλογές

Αποθηκεύστε τιμές στα μεταδεδομένα αναρτήσεων ή στις επιλογές, μαζί με τα γνωρίσματα των block.

Λογική υπό όρους

Εμφανίστε πεδία βάσει τιμών με ισότητα, συμπερίληψη, κενότητα και συγκρίσεις.

Δυναμική άντληση δεδομένων

Αντλήστε επιλογές από αναρτήσεις, χρήστες, όρους, συναρτήσεις ή API.

Παρακάμψεις

Ορίστε override: true με το όνομα ενός κοινόχρηστου μπλοκ για συγχώνευση χαρακτηριστικών βάσει id, αντικατάσταση στοιχείων με αρχεία που έχουν τα ίδια ονόματα και αντικατάσταση του προτύπου. Τα πρότυπα Twig μπορούν να παρακάμπτουν μεμονωμένα μπλοκ με το extends.

Παραλλαγές

Δηλώστε παραλλαγές στο block.json που προκαθορίζουν τιμές πεδίων και αποκρύψτε με το hidden το πεδίο που τις καθορίζει.

Στοιχεία

Ορίστε component: true για ένα μπλοκ που αποδίδεται μόνο από το PHP ή από ετικέτες μπλοκ. Διατηρεί τα πεδία, τα πρότυπα, τα στοιχεία και το Tailwind, αλλά δεν εμφανίζεται ποτέ στο inserter.

Κανόνες InnerBlocks

Επιτρέψτε μπλοκ με τα διακριτικά namespace/*, category: και @theme, αλλάξτε το εσωτερικό πρότυπο από μια επιλογή select και αφαιρέστε το περίβλημα στο frontend με ένα φίλτρο.

Στοιχεία πεδίων κώδικα

Ένα πεδίο κώδικα με asset: true μετατρέπει την είσοδο του επεξεργαστή σε CSS, SCSS ή JavaScript για αυτό το μπλοκ, με εμβέλεια στην παρουσία μέσω του %selector%.

Στοιχεία ενεργητικού βάσει ονόματος αρχείου

*Το .view.js φορτώνεται μόνο στο frontend, ενώ τα προθέματα global-, admin- και block-editor- φορτώνουν ένα αρχείο σε κάθε σελίδα, στο wp-admin ή στον επεξεργαστή μπλοκ.

Εικονίδια και φάκελοι μπλοκ

Δώστε σε ένα μπλοκ ένα προσαρμοσμένο εικονίδιο SVG ή HTML, αλλάξτε τη θέση αναζήτησης με το φίλτρο blockstudio/path και προσθέστε φακέλους με το Blockstudio\Build::init().

Τιμές ACF και Meta Box

Τα πρότυπα λαμβάνουν το $post_id, ώστε τα get_field() και rwmb_get_value() να διαβάζουν το επεξεργασμένο άρθρο, ενώ το refreshOn φορτώνει ξανά την προεπισκόπηση μετά την αποθήκευση.

Πλαίσιο Query Loop

Μέσα σε ένα Query Loop, το $block[‘context’][‘postId’] ακολουθεί το τρέχον στοιχείο, ενώ το $block[‘postId’] παραμένει το άρθρο που προβάλλεται.

WPML

Η εντολή wp bs wpml config γράφει το wpml-config.xml που επισημαίνει τα πεδία κειμένου ως μεταφράσιμα, ενώ οι εικόνες που είναι αποθηκευμένες σε πεδία προστίθενται στις εργασίες μετάφρασης WPML μαζί με τα εναλλακτικά κείμενα και τις λεζάντες τους.

Plus

Το επίσημο κιτ επεκτάσεων

Premium πρότυπα ιστοτόπων, οδηγίες συστήματος AI και ιδιωτική κοινότητα Discord. Εφάπαξ αγορά, ενημερώσεις εφ’ όρου ζωής.

  • 500+ πρότυπα ιστοτόπων
  • Οδηγίες συστήματος AI
  • Ενημερώσεις εφ’ όρου ζωής
  • Ιδιωτική κοινότητα Discord