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

Δημιουργία σελίδων βάσει αρχείων

Η δημιουργία παραδοσιακών σελίδων WordPress γίνεται στον επεξεργαστή μπλοκ: σύρετε μπλοκ, διαμορφώνετε ρυθμίσεις και πατάτε αποθήκευση. Αυτό λειτουργεί για πελάτες που δημιουργούν τις δικές τους σελίδες, αλλά δημιουργεί προβλήματα στους προγραμματιστές που φτιάχνουν δομημένες σελίδες με έλεγχο εκδόσεων. Η διάταξη της σελίδας βρίσκεται στη βάση δεδομένων και όχι στον κώδικα. Δεν μπορείτε να την εξετάσετε σε ένα αίτημα συγχώνευσης, να την επαναφέρετε με το git ή να την αναπαράγετε σε μια νέα εγκατάσταση.

Οι σελίδες βάσει αρχείων του Blockstudio λύνουν αυτό το πρόβλημα. Ορίζετε τις σελίδες ως αρχεία στο θέμα σας, γράφετε πρότυπα HTML που μετατρέπονται σε μπλοκ WordPress και ελέγχετε ακριβώς τι μπορούν και τι δεν μπορούν να επεξεργαστούν οι πελάτες. Μια ρητή εντολή συγχρονίζει αυτά τα αρχεία με κανονικές αναρτήσεις WordPress, ενώ τα πρότυπά σας παραμένουν η μοναδική πηγή αλήθειας.

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

Η πρώτη σας σελίδα

Δημιουργήστε έναν φάκελο pages στο θέμα σας και, στη συνέχεια, προσθέστε έναν υποφάκελο με δύο αρχεία:

Κώδικας
theme/
└── pages/
    └── about/
        ├── page.json
        └── index.php
JSON
{
  "name": "about",
  "title": "About Us",
  "postStatus": "publish"
}
HTML
<h1>About Us</h1>
<p>We build things for the web.</p>

Εκτελέστε την εντολή συγχρονισμού σελίδων:

Κέλυφος
wp bs pages sync

Το Blockstudio αναλύει το HTML σε μπλοκ WordPress και δημιουργεί μια σελίδα με τίτλο “About Us” και σύντομο όνομα about. Ανοίξτε την στον επεξεργαστή και θα δείτε μια επικεφαλίδα και μια παράγραφο, ακριβώς όπως αν τις είχατε προσθέσει χειροκίνητα.

Επεξεργαστείτε το index.php, αλλάξτε το κείμενο και εκτελέστε ξανά την εντολή. Φορτώστε ξανά τον επεξεργαστή για να δείτε την ενημέρωση. Αυτός είναι ο βασικός κύκλος: γράφετε HTML, συγχρονίζετε σκόπιμα και λαμβάνετε μπλοκ.

Η γλώσσα προτύπων

Ο αναλυτής HTML του Blockstudio μετατρέπει τα τυπικά στοιχεία HTML σε μπλοκ WordPress. Γράψτε ένα <p> και θα λάβετε ένα μπλοκ παραγράφου. Γράψτε ένα <h2> και θα λάβετε ένα μπλοκ επικεφαλίδας. Η αντιστοίχιση είναι διαισθητική:

HTML Μπλοκ
<p> Παράγραφος
<h1> έως <h6> Επικεφαλίδα (το επίπεδο αντιστοιχεί στην ετικέτα)
<ul>, <ol> Λίστα
<blockquote> Παράθεση
<img> Εικόνα
<div>, <section> Ομάδα
<hr> Διαχωριστικό
<details> Λεπτομέρειες
<table> Πίνακας

Για μπλοκ χωρίς άμεσο ισοδύναμο HTML, χρησιμοποιήστε το στοιχείο <block> με ένα χαρακτηριστικό name:

HTML
<block name="core/cover" url="https://example.com/hero.jpg">
  <h2>Hero Title</h2>
  <p>Content over the background image.</p>
</block>

<block name="core/spacer" height="80px" />

<block name="core/buttons">
  <block name="core/button" url="/contact">Get in Touch</block>
  <block name="core/button" url="/work">See Our Work</block>
</block>

Τα χαρακτηριστικά των στοιχείων <block> περνούν ως χαρακτηριστικά μπλοκ. Οι τιμές μετατρέπονται αυτόματα: το "true" γίνεται λογική τιμή, το "3" γίνεται ακέραιος και οι συμβολοσειρές JSON, όπως το '{"type":"flex"}', αποκωδικοποιούνται σε αντικείμενα.

Διατάξεις

Οι ομάδες υποστηρίζουν διαφορετικές λειτουργίες διάταξης μέσω του χαρακτηριστικού layout:

HTML
<!-- Default group (stacked) -->
<div>
  <p>Stacked by default.</p>
</div>

<!-- Row (horizontal flex) -->
<block name="core/group" layout='{"type":"flex","flexWrap":"nowrap"}'>
  <p>Side</p>
  <p>by side</p>
</block>

<!-- Stack (vertical flex) -->
<block name="core/group" layout='{"type":"flex","orientation":"vertical"}'>
  <p>Stacked</p>
  <p>with flex</p>
</block>

<!-- Columns -->
<block name="core/columns">
  <block name="core/column">
    <p>Left column.</p>
  </block>
  <block name="core/column">
    <p>Right column.</p>
  </block>
</block>

Προσαρμοσμένα μπλοκ

Η σύνταξη <block> λειτουργεί για κάθε καταχωρισμένο μπλοκ, συμπεριλαμβανομένων των δικών σας μπλοκ Blockstudio:

HTML
<block name="my-theme/hero" title="Welcome" background="dark" />
<block name="my-theme/testimonial" quote="Great product." author="Jane" />

Τα χαρακτηριστικά αντιστοιχίζονται αυτόματα στις τιμές πεδίων Blockstudio του μπλοκ.

Δημιουργία σελίδας προορισμού

Ακολουθεί μια ολοκληρωμένη σελίδα προορισμού που χρησιμοποιεί βασικά μπλοκ για τη δομή και τη διάταξη:

JSON
{
  "name": "landing",
  "title": "Landing Page",
  "slug": "landing",
  "postStatus": "publish",
  "templateLock": "all"
}
HTML
<block name="core/cover" url="https://images.unsplash.com/photo-1497366216548-37526070297c?w=1600">
  <h1>Build faster with Blockstudio</h1>
  <p>File-based blocks. Zero build step. Full editor integration.</p>
  <block name="core/buttons">
    <block name="core/button" url="/get-started">Get Started</block>
    <block name="core/button" url="/docs">Documentation</block>
  </block>
</block>

<div>
  <h2>Why developers love it</h2>
  <block name="core/columns">
    <block name="core/column">
      <h3>No build step</h3>
      <p>Write PHP, CSS, and JavaScript. No webpack, no bundler, no transpiler.</p>
    </block>
    <block name="core/column">
      <h3>File-based</h3>
      <p>Every block is a folder. Every page is a template. Version control everything.</p>
    </block>
    <block name="core/column">
      <h3>Full editor support</h3>
      <p>Fields, previews, and InnerBlocks work in the block editor out of the box.</p>
    </block>
  </block>
</div>

<block name="core/media-text" mediaurl="https://images.unsplash.com/photo-1460925895917-afdab827c52f?w=800" mediatype="image">
  <h2>Ship entire sites from your IDE</h2>
  <p>Define pages, blocks, and patterns as files. Blockstudio handles the rest.</p>
</block>

<div>
  <h2>Frequently asked questions</h2>
  <details>
    <summary>Do I need to learn React?</summary>
    <p>No. Templates are PHP. Fields are JSON. Interactivity is optional.</p>
  </details>
  <details>
    <summary>Does it work with my existing theme?</summary>
    <p>Yes. Drop a blockstudio folder into any theme and start creating blocks.</p>
  </details>
</div>

<div>
  <block name="core/buttons">
    <block name="core/button" url="/get-started">Start Building</block>
  </block>
</div>

Αυτή η σελίδα περιλαμβάνει ένα hero εξωφύλλου, ένα πλέγμα χαρακτηριστικών με τρεις στήλες, μια ενότητα πολυμέσων και κειμένου, αναδιπλούμενες ενότητες συχνών ερωτήσεων και ένα CTA. Όλα προέρχονται από ένα αρχείο HTML. Το templateLock: "all" στο page.json σημαίνει ότι ο πελάτης δεν μπορεί να αλλάξει τίποτα. Η επόμενη ενότητα εξηγεί πώς να χαλαρώσετε αυτόν τον περιορισμό.

Έλεγχος του επεξεργαστή

Εδώ οι σελίδες που βασίζονται σε αρχεία αποκτούν πραγματικά μεγάλη δύναμη. Το Blockstudio σάς προσφέρει δύο ανεξάρτητα στοιχεία ελέγχου: κλείδωμα προτύπου και λειτουργία επεξεργασίας μπλοκ. Μαζί, σας επιτρέπουν να ορίσετε ακριβώς ποια μέρη μιας σελίδας μπορούν να τροποποιούν οι πελάτες. Κλειδώστε τη δομή, αλλά επιτρέψτε την επεξεργασία κειμένου. Παγώστε ορισμένες ενότητες, αφήνοντας άλλες εντελώς ελεύθερες. Δημιουργήστε μια σελίδα όπου το μόνο που μπορεί να κάνει ο πελάτης είναι να πληκτρολογήσει σε τρεις συγκεκριμένες επικεφαλίδες.

Κλείδωμα προτύπου

Η ιδιότητα templateLock στο page.json ελέγχει τη δομική επεξεργασία: αν μπορούν να προστεθούν, να αφαιρεθούν ή να αναδιαταχθούν μπλοκ.

"all" (προεπιλογή)

JSON
{
  "name": "terms",
  "templateLock": "all"
}

Το αυστηρότερο κλείδωμα. Οι πελάτες δεν μπορούν να προσθέσουν, να αφαιρέσουν ή να μετακινήσουν μπλοκ. Δεν μπορούν επίσης να επεξεργαστούν το περιεχόμενο των μπλοκ (εκτός αν συνδυαστεί με το blockEditingMode). Αυτή είναι η προεπιλογή όταν δεν ορίζετε τιμή.

Πότε να το χρησιμοποιείτε: Νομικές σελίδες, όροι χρήσης, πολιτικές απορρήτου. Οποιαδήποτε σελίδα της οποίας το περιεχόμενο πρέπει να αλλάζει μόνο μέσω κώδικα.

"insert"

JSON
{
  "name": "about",
  "templateLock": "insert"
}

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

Πότε να το χρησιμοποιείτε: Σελίδες όπου θέλετε ένα σταθερό σύνολο ενοτήτων, αλλά θέλετε να επιτρέπετε στον πελάτη να τις αναδιατάσσει. Μια σελίδα portfolio όπου ο αριθμός των ενοτήτων είναι προκαθορισμένος, αλλά ο πελάτης επιλέγει τη σειρά τους.

"contentOnly"

JSON
{
  "name": "homepage",
  "templateLock": "contentOnly"
}

Οι πελάτες μπορούν να επεξεργαστούν το κείμενο, αλλά δεν μπορούν να προσθέσουν, να αφαιρέσουν ή να μετακινήσουν μπλοκ. Η διαφορά από το "all" είναι ότι το "all" εμποδίζει επίσης την επεξεργασία περιεχομένου, ενώ το "contentOnly" την επιτρέπει ρητά.

Πότε να το χρησιμοποιείτε: Η συνηθέστερη επιλογή για σελίδες που προορίζονται για πελάτες. Ο προγραμματιστής ελέγχει τη διάταξη. Ο πελάτης συμπληρώνει το κείμενο.

false

JSON
{
  "name": "blog",
  "templateLock": false
}

Χωρίς κανένα κλείδωμα. Οι πελάτες έχουν πλήρη έλεγχο: μπορούν να προσθέσουν, να αφαιρέσουν, να μετακινήσουν και να επεξεργαστούν οποιοδήποτε μπλοκ. Το πρότυπο παρέχει μια αρχική δομή, αλλά από εκεί και πέρα η σελίδα ανήκει στον πελάτη.

Πότε να το χρησιμοποιείτε: Σελίδες ευρετηρίου ιστολογίου, σελίδες ελεύθερου περιεχομένου ή οποιαδήποτε σελίδα όπου ο πελάτης πρέπει να έχει πλήρη εκδοτική ελευθερία.

Λειτουργία επεξεργασίας μπλοκ

Ενώ το templateLock ελέγχει τη δομή (προσθήκη, αφαίρεση, μετακίνηση), το blockEditingMode ελέγχει την αλληλεπίδραση σε επίπεδο μεμονωμένου μπλοκ: αν τα μπλοκ μπορούν να επιλέγονται, να διαμορφώνονται ή να επεξεργάζονται.

Ορίστε μια προεπιλογή σε επίπεδο σελίδας στο page.json:

JSON
{
  "name": "landing",
  "templateLock": "all",
  "blockEditingMode": "disabled"
}

"default"

Πλήρης επεξεργασία. Μπορείτε να επιλέγετε μπλοκ, να αλλάζετε τις ρυθμίσεις τους και να επεξεργάζεστε το περιεχόμενό τους. Αυτή είναι η συνηθισμένη εμπειρία επεξεργασίας.

"contentOnly"

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

"disabled"

Τα μπλοκ είναι εντελώς μη διαδραστικά. Εμφανίζονται στον επεξεργαστή, αλλά δεν μπορείτε να τα πατήσετε, να τα επιλέξετε ή να τα τροποποιήσετε με κανέναν τρόπο. Ο πελάτης βλέπει το περιεχόμενο, αλλά δεν μπορεί να το αγγίξει.

Παρακάμψεις ανά στοιχείο

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

JSON
{
  "name": "landing",
  "templateLock": "all",
  "blockEditingMode": "disabled"
}
HTML
<block name="core/cover" url="https://example.com/hero.jpg">
  <h1 blockEditingMode="contentOnly">Edit This Heading</h1>
  <p blockEditingMode="contentOnly">Edit this paragraph too.</p>
</block>

<div>
  <h2>Features</h2>
  <p>This paragraph cannot be edited (inherits "disabled").</p>
  <p blockEditingMode="contentOnly">But this one can.</p>
</div>

<block name="core/buttons">
  <block name="core/button" url="/contact">This button is frozen</block>
</block>

Η προεπιλογή της σελίδας είναι "disabled", επομένως όλα τα μπλοκ αρχικά δεν είναι διαδραστικά. Στη συνέχεια, συγκεκριμένα στοιχεία επιλέγουν το "contentOnly", ώστε να είναι επεξεργάσιμο μόνο το κείμενό τους. Το αποτέλεσμα: μια σελίδα όπου ο πελάτης μπορεί να πληκτρολογήσει ακριβώς σε δύο πεδία κειμένου (την επικεφαλίδα και την παράγραφο του hero) και σε μία παράγραφο χαρακτηριστικού. Όλα τα υπόλοιπα είναι κλειδωμένα.

Αυτό λειτουργεί σε οποιοδήποτε στοιχείο HTML (<h1>, <p>, <div> κ.λπ.) και σε στοιχεία <block>. Μπορείτε επίσης να ορίσετε το blockEditingMode="default" σε συγκεκριμένα στοιχεία, ώστε να παρέχετε πλήρη πρόσβαση επεξεργασίας:

HTML
<block name="core/buttons" blockEditingMode="default">
  <block name="core/button" url="/contact">Fully editable button</block>
</block>

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

Η διαδοχική επίδραση των γονικών στοιχείων

Υπάρχει μια σημαντική λεπτομέρεια σχετικά με την αλληλεπίδραση των παρακάμψεων ανά στοιχείο με τα μπλοκ-περιέκτες. Αν η προεπιλογή της σελίδας είναι "disabled" και ορίσετε blockEditingMode="contentOnly" σε μια επικεφαλίδα μέσα σε μια ομάδα, πρέπει να μπορείτε να φτάσετε στην επικεφαλίδα. Όμως, η γονική της ομάδα είναι "disabled", πράγμα που σημαίνει ότι δεν μπορείτε να εισέλθετε σε αυτήν.

Το Blockstudio το χειρίζεται αυτόματα. Όταν ένα θυγατρικό μπλοκ έχει παράκαμψη λειτουργίας επεξεργασίας, όλα τα προγονικά του μπλοκ ορίζονται σε "contentOnly", ώστε το θυγατρικό μπλοκ να παραμένει προσβάσιμο. Δεν χρειάζεται να ορίσετε χειροκίνητα λειτουργίες στους γονικούς περιέκτες. Αρκεί να ορίσετε την παράκαμψη στο μπλοκ που θέλετε να είναι επεξεργάσιμο και ανοίγει η διαδρομή προς αυτό.

HTML
<!-- page default: "disabled" -->
<div>
  <!-- this group is auto-set to "contentOnly" because it contains an override -->
  <div>
    <!-- this group is also auto-set to "contentOnly" -->
    <p blockEditingMode="contentOnly">Deeply nested but still editable.</p>
  </div>
</div>

Η διαδοχική επίδραση των προγονικών στοιχείων αναβαθμίζει τους περιέκτες μόνο σε "contentOnly", ποτέ σε "default". Έτσι, οι προγονικές ομάδες γίνονται προσβάσιμες για πλοήγηση (μπορείτε να εισέλθετε σε αυτές), αλλά όχι πλήρως επεξεργάσιμες (δεν μπορείτε να αλλάξετε τις ρυθμίσεις τους).

Ο πίνακας αποφάσεων

Ο συνδυασμός των templateLock και blockEditingMode προσφέρει ένα ευρύ φάσμα ελέγχου. Ακολουθούν οι πιο χρήσιμοι συνδυασμοί:

Ο προγραμματιστής ελέγχει τα πάντα

JSON
{ "templateLock": "all" }

Δεν χρειάζεται το blockEditingMode. Το προεπιλεγμένο templateLock: "all" αποτρέπει κάθε αλλαγή. Χρησιμοποιήστε το για σελίδες που διαχειρίζεστε εξ ολοκλήρου μέσω κώδικα.

Ο πελάτης επεξεργάζεται όλο το κείμενο

JSON
{ "templateLock": "contentOnly" }

Ο πελάτης μπορεί να επεξεργαστεί το κείμενο σε οποιοδήποτε μπλοκ, αλλά δεν μπορεί να αλλάξει τη δομή της σελίδας. Απλό και ευέλικτο.

Ο πελάτης επεξεργάζεται μόνο συγκεκριμένο κείμενο

JSON
{
  "templateLock": "all",
  "blockEditingMode": "disabled"
}

Σε συνδυασμό με το blockEditingMode="contentOnly" σε συγκεκριμένα στοιχεία του προτύπου. Αυτή είναι η επιλογή με τον ακριβέστερο έλεγχο: ο πελάτης μπορεί να επεξεργαστεί μόνο τα μπλοκ που έχετε επισημάνει.

Ο πελάτης αναδιατάσσει σταθερές ενότητες

JSON
{ "templateLock": "insert" }

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

Ο πελάτης έχει πλήρη έλεγχο

JSON
{ "templateLock": false }

Το πρότυπο αποτελεί την αρχική βάση. Από εκεί και πέρα, ο πελάτης μπορεί να κάνει ό,τι θέλει.

Διατήρηση των αλλαγών του πελάτη

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

Κλειδιά

Προσθέστε ένα χαρακτηριστικό key σε οποιοδήποτε στοιχείο, ώστε να επισημάνετε ότι πρέπει να συγχωνευτεί αντί να αντικατασταθεί:

HTML
<block name="core/cover" key="hero" url="https://example.com/hero.jpg">
  <h1>Default Hero Title</h1>
  <p>Default hero description.</p>
</block>

<div key="features">
  <h2>Features</h2>
  <p>Feature introduction text.</p>
</div>

<div>
  <h2>Unkeyed Section</h2>
  <p>This gets replaced on every sync.</p>
</div>

Όταν αλλάξει το πρότυπο και συγχρονιστεί ξανά η σελίδα:

  • Τα μπλοκ με κλειδί διατηρούν το περιεχόμενο του πελάτη (κείμενο, εσωτερικά μπλοκ, μορφοποίηση). Τα δομικά χαρακτηριστικά του προτύπου (όπως το url του cover) εξακολουθούν να ενημερώνονται.
  • Τα μπλοκ χωρίς κλειδί αντικαθίστανται εξ ολοκλήρου από την έκδοση του προτύπου.

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

Τα κλειδιά πρέπει να είναι μοναδικά

Τα κλειδιά πρέπει να είναι μοναδικά σε ολόκληρο το πρότυπο. Αν δύο στοιχεία έχουν το ίδιο κλειδί, το δεύτερο αντιμετωπίζεται σαν να μην έχει κλειδί (και εμφανίζεται μια προειδοποίηση PHP). Χρησιμοποιήστε περιγραφικά ονόματα: "hero", "features", "cta", "testimonial-section".

Εξέλιξη προτύπων

Με τα κλειδιά μπορείτε να προσθέτετε νέες ενότητες σε ένα πρότυπο χωρίς να επηρεάζετε το υπάρχον περιεχόμενο του πελάτη:

HTML
<h1 key="title">Welcome</h1>
<div key="services">
  <h2>Our Services</h2>
  <p>We do great work.</p>
</div>
HTML
<h1 key="title">Welcome</h1>
<div key="services">
  <h2>Our Services</h2>
  <p>We do great work.</p>
</div>
<div key="testimonials">
  <h2>What Clients Say</h2>
  <p>Default testimonial text.</p>
</div>

Κατά τον συγχρονισμό, ο τίτλος και οι υπηρεσίες διατηρούν τις αλλαγές του πελάτη. Η νέα ενότητα μαρτυριών εμφανίζεται με το προεπιλεγμένο περιεχόμενο του προτύπου. Αν αργότερα αφαιρέσετε ένα μπλοκ με κλειδί από το πρότυπο, διαγράφεται από τη σελίδα.

Η πλήρης ροή εργασίας του πελάτη

Ας τα συνδυάσουμε όλα σε ένα πραγματικό έργο:

JSON
{
  "name": "homepage",
  "title": "Home",
  "slug": "home",
  "postStatus": "publish",
  "templateLock": "all",
  "blockEditingMode": "disabled"
}
HTML
<block name="core/cover" key="hero" url="https://example.com/hero.jpg">
  <h1 blockEditingMode="contentOnly">Your Company Name</h1>
  <p blockEditingMode="contentOnly">Your tagline goes here.</p>
  <block name="core/buttons">
    <block name="core/button" url="/contact">Contact Us</block>
  </block>
</block>

<div key="features">
  <h2 blockEditingMode="contentOnly">What We Do</h2>
  <block name="core/columns">
    <block name="core/column">
      <h3 blockEditingMode="contentOnly">Service One</h3>
      <p blockEditingMode="contentOnly">Describe this service.</p>
    </block>
    <block name="core/column">
      <h3 blockEditingMode="contentOnly">Service Two</h3>
      <p blockEditingMode="contentOnly">Describe this service.</p>
    </block>
    <block name="core/column">
      <h3 blockEditingMode="contentOnly">Service Three</h3>
      <p blockEditingMode="contentOnly">Describe this service.</p>
    </block>
  </block>
</div>

<block name="core/media-text" key="about" mediaurl="https://example.com/team.jpg" mediatype="image">
  <h2 blockEditingMode="contentOnly">About Us</h2>
  <p blockEditingMode="contentOnly">Tell your story here.</p>
</block>

<div key="cta">
  <h2 blockEditingMode="contentOnly">Ready to get started?</h2>
  <block name="core/buttons">
    <block name="core/button" url="/contact">Get in Touch</block>
  </block>
</div>

Αυτή η σελίδα έχει τέσσερις ενότητες με κλειδί. Ο πελάτης μπορεί να επεξεργαστεί τις επικεφαλίδες και τις παραγράφους που έχουν επισημανθεί με blockEditingMode="contentOnly", και αυτές οι αλλαγές διατηρούνται κατά τις ενημερώσεις του προτύπου. Ο προγραμματιστής ελέγχει τη διάταξη, τις εικόνες, τα URL των κουμπιών και τη συνολική δομή. Αν αργότερα ο προγραμματιστής προσθέσει μια ενότητα μαρτυριών ανάμεσα στις ενότητες “about” και “cta”, αυτή εμφανίζεται στον επόμενο συγχρονισμό χωρίς να επηρεάζει κανένα κείμενο του πελάτη.

Συνδέσεις μπλοκ: μια εναλλακτική λύση στα κλειδιά

Το WordPress 6.5 εισήγαγε τις Συνδέσεις μπλοκ API, οι οποίες συνδέουν τα χαρακτηριστικά μπλοκ με μεταδεδομένα άρθρων. Αντί να αποθηκεύεται επεξεργάσιμο περιεχόμενο στη σήμανση του μπλοκ (όπου το προστατεύουν τα κλειδιά), το περιεχόμενο αποθηκεύεται στο wp_postmeta (όπου δεν μπορούν να το επηρεάσουν οι συγχρονισμοί προτύπων).

HTML
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
  Default Title
</h1>

<p metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_description"}}}}'>
  Default description.
</p>

Τα κλειδιά μεταδεδομένων πρέπει να καταχωρίζονται στο PHP:

PHP
register_post_meta( 'page', 'hero_title', array(
    'show_in_rest' => true,
    'single'       => true,
    'type'         => 'string',
    'default'      => 'Default Title',
) );

Οι συνδέσεις μπλοκ έχουν δύο πλεονεκτήματα έναντι των κλειδιών: τα δεδομένα μπορούν να υποβληθούν σε ερώτημα με το WP_Query μέσω του meta_query και είναι διαθέσιμα στο REST API. Το αντάλλαγμα είναι ότι πρέπει να καταχωρίσετε κάθε κλειδί μεταδεδομένων στο PHP, ενώ οι συνδέσεις λειτουργούν μόνο σε μεμονωμένα χαρακτηριστικά μπλοκ (όχι σε σύνθετο ένθετο περιεχόμενο).

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

Πρότυπα τύπων ανάρτησης

Χρησιμοποιήστε το templateFor για να ορίσετε μια προεπιλεγμένη δομή μπλοκ για όλες τις νέες αναρτήσεις ενός συγκεκριμένου τύπου:

JSON
{
  "name": "product-template",
  "title": "Product Template",
  "templateFor": "product",
  "templateLock": "insert"
}
HTML
<h1>Product Name</h1>

<block name="core/columns">
  <block name="core/column">
    <img src="" alt="Product image" />
  </block>
  <block name="core/column">
    <p>Product description goes here.</p>
    <block name="core/buttons">
      <block name="core/button" url="#">Buy Now</block>
    </block>
  </block>
</block>

<div>
  <h2>Specifications</h2>
  <table>
    <thead>
      <tr><th>Feature</th><th>Value</th></tr>
    </thead>
    <tbody>
      <tr><td>Weight</td><td>1.2 kg</td></tr>
    </tbody>
  </table>
</div>

Κάθε νέα ανάρτηση “product” ξεκινά με αυτή τη δομή. Το templateLock: "insert" επιτρέπει στους συντάκτες να αναδιατάσσουν ενότητες και να επεξεργάζονται περιεχόμενο, αλλά όχι να προσθέτουν ή να αφαιρούν μπλοκ.

Συμβουλές

Συγχρονίστε σε ένα σκόπιμα επιλεγμένο όριο ανάπτυξης. Εκτελέστε το wp bs pages sync αφού αλλάξετε ή αναπτύξετε τις πηγές σελίδων. Οι επισκέψεις στο frontend και στο admin δεν συγχρονίζουν ποτέ σελίδες. Τα εργαλεία ανάπτυξης PHP μπορούν να καλέσουν το Blockstudio\Pages::reconcile() και να εξετάσουν την αναφορά του σε μορφή αναγνώσιμη από μηχανές.

Καρφιτσώστε τα σημαντικά ID αναρτήσεων. Χρησιμοποιήστε το postId στο page.json για σελίδες στις οποίες αναφέρονται μενού, σύνδεσμοι γραμμένοι απευθείας στον κώδικα ή εξωτερικά συστήματα. Χωρίς καρφίτσωμα, μια σελίδα που διαγράφεται και δημιουργείται ξανά αποκτά νέο ID, με αποτέλεσμα να διακόπτονται αυτές οι αναφορές.

Χρησιμοποιήστε το sync: false για πρόχειρα. Αν θέλετε να δημιουργήσετε μια σελίδα μία φορά και μετά να την παραδώσετε εξ ολοκλήρου στον πελάτη, ορίστε το "sync": false και δημιουργήστε τη με το Blockstudio\Pages::force_sync(). Η κανονική διαδικασία συμφιλίωσης την αγνοεί στη συνέχεια.

Κλειδώστε και ξεκλειδώστε μέσω του PHP. Καλέστε το Blockstudio\Pages::lock('about') για να αποτρέψετε τον συγχρονισμό μιας συγκεκριμένης σελίδας (χρήσιμο κατά τη διάρκεια περιόδων εντατικής επεξεργασίας από τον πελάτη). Καλέστε το Blockstudio\Pages::unlock('about') για να ενεργοποιήσετε ξανά τον συγχρονισμό.

Μηχανές προτύπων. Εκτός από το PHP, μπορείτε να γράψετε πρότυπα σε Twig (απαιτείται το Timber) ή σε Blade (απαιτείται το illuminate/view). Αυτό είναι χρήσιμο για βρόχους και φίλτρα, αλλά τα πρότυπα σελίδων μεταγλωττίζονται κατά τον ρητό συγχρονισμό και όχι κατά το αίτημα του frontend. Προτιμήστε το PHP αν η ίδια η μεταγλώττιση της πηγής χρειάζεται βοηθητικές συναρτήσεις αποκλειστικά για PHP.

Ο εξαναγκασμένος συγχρονισμός αγνοεί τα κλειδιά. Η κλήση του Pages::force_sync('about') αντικαθιστά ολόκληρο το περιεχόμενο της σελίδας, αγνοώντας τα κλειδιά και τους ελέγχους χρόνου τροποποίησης. Χρησιμοποιήστε το όταν θέλετε σκόπιμα να επαναφέρετε μια σελίδα στην κατάσταση του προτύπου.

Επόμενα βήματα

  • Αναφορά σελίδων: όλες οι ιδιότητες page.json, τα PHP API και ο αλγόριθμος συγχώνευσης με κλειδιά, αναλυτικά.
  • Επισκόπηση σελίδων και μοτίβων: ο αναλυτής HTML, αναφορά σύνταξης μπλοκ, προσαρμοσμένοι αποδοτές και αντιστοίχιση στοιχείων.
  • Μοτίβα: η ίδια σύνταξη προτύπων για επαναχρησιμοποιήσιμα μοτίβα μπλοκ αντί για σελίδες.