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

Σελίδες

Οι σελίδες είναι πρότυπα που βασίζονται σε αρχεία και συγχρονίζονται με τη βάση δεδομένων WordPress ως αναρτήσεις. Ο συγχρονισμός γίνεται ρητά: εκτελέστε το wp bs pages sync ή καλέστε το Pages API όταν θέλετε να εφαρμόσετε αλλαγές στην πηγή. Η φόρτωση του frontend ή της διαχείρισης WordPress δεν αναζητά εξαντλητικά σελίδες ούτε τροποποιεί αναρτήσεις σελίδων.

Οι σελίδες μπορούν να οριστούν ως ένας φάκελος page.json, ως αυτόνομα Markdown ή ως συλλογή με ένα manifest pages.json. Οι συλλογές είναι χρήσιμες για τεκμηρίωση, βάσεις γνώσεων, βιβλιοθήκες σελίδων προορισμού ή κάθε σύνολο ένθετων σελίδων που πρέπει να δημιουργείται από αρχεία.

page.json

Για μια σελίδα που ορίζεται από JSON, προσθέστε ένα αρχείο ρυθμίσεων page.json:

JSON
{
  "name": "about",
  "title": "About Us",
  "slug": "about-us",
  "postType": "page",
  "postStatus": "publish",
  "templateLock": "all"
}

Ιδιότητες

Ιδιότητα Τύπος Προεπιλογή Περιγραφή
name string απαιτείται Μοναδικό αναγνωριστικό της σελίδας
title string Αυτόματα από το όνομα Ο τίτλος της σελίδας
slug string Ίδιο με το όνομα Το URL slug της σελίδας
path string "." Λογική διαδρομή μέσα σε μια συλλογή
order integer 0 Σειρά μενού για τη συγχρονισμένη ανάρτηση
postType string "page" Τύπος ανάρτησης WordPress
postStatus string "draft" Κατάσταση για νέες αναρτήσεις (publish, draft, pending, private)
postId integer – Καρφιτσώστε τη σελίδα σε συγκεκριμένο ID ανάρτησης WordPress
blockEditingMode string – Λειτουργία επεξεργασίας μπλοκ: "default", "contentOnly" ή "disabled"
templateLock string|false "all" Λειτουργία κλειδώματος: "all", "insert", "contentOnly" ή false
templateFor string|null null Ορισμός ως προεπιλεγμένο πρότυπο για έναν τύπο ανάρτησης
sync boolean true Αν η κανονική ρητή συμφιλίωση μπορεί να δημιουργήσει ή να ενημερώσει την ανάρτηση
render string|object|false – Απόδοση της σελίδας με καταχωρισμένο αποδοτή σελίδων (δείτε Σελίδες στοιχείων)

Στα page.json, στα frontmatter και στις καταχωρίσεις loader, τα αναγνωρισμένα κλειδιά περιλαμβάνουν τα blockEditingMode, collection, content, contentType, defaults, file, html, markdown, meta, name, order, path, postId, postStatus, postType, postTypeArgs, render, slug, template, templateFor, templateLock και title. Κάθε κλειδί που δεν αναφέρεται παραπάνω αποθηκεύεται στον πίνακα meta της σελίδας.

Πηγές περιεχομένου

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

Όταν ένας φάκελος σελίδας περιέχει ένα page.json, το Blockstudio αναζητά ένα γειτονικό αρχείο πηγής με την εξής σειρά:

Αρχείο Χρήση
index.php Σήμανση μπλοκ τύπου HTML, διαβάζεται ως έχει (ο κώδικας PHP δεν εκτελείται)
index.blade.php Περιεχόμενο προτύπου Blade
index.twig Περιεχόμενο προτύπου Twig
index.md Περιεχόμενο Markdown

Το page.json μπορεί επίσης να περιέχει ενσωματωμένο markdown ή html αντί για γειτονικό αρχείο:

JSON
{
  "name": "intro",
  "title": "Intro",
  "markdown": "# Intro\n\nThis page is generated from inline markdown."
}
JSON
{
  "name": "notice",
  "title": "Notice",
  "html": "<h1>Notice</h1><p>This page is generated from inline HTML.</p>"
}

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

  • Αρχεία Markdown που εντοπίζονται απευθείας στο δέντρο της συλλογής.
  • Εγγραφές loader που επιστρέφονται από το loader.php.

Οι εγγραφές loader μπορούν να χρησιμοποιούν markdown, html ή content με contentType. Μπορούν επίσης να δείχνουν σε τοπικό file ή template. Ο τύπος των πηγών αρχείων και προτύπων συνάγεται από την επέκταση, εκτός αν οριστεί ρητά το contentType.

Οι υποστηριζόμενες τιμές contentType είναι οι php, blade, twig, markdown και html. Το Markdown μετατρέπεται πρώτα σε HTML και έπειτα αναλύεται σε εγγενή μπλοκ WordPress. Οι πηγές PHP, Blade, Twig και HTML περνούν από τον κανονικό αναλυτή σελίδων Blockstudio.

Κλάσεις στα βασικά μπλοκ

Μια class σε ένα στοιχείο HTML που αντιστοιχίζεται σε βασικό μπλοκ γίνεται το className του. Μια ρητή ετικέτα βασικού μπλοκ μπορεί να χρησιμοποιήσει απευθείας το className. Και οι δύο μορφές διατηρούν τις κλάσεις στο αποθηκευμένο περίβλημα του μπλοκ, μαζί με τις κλάσεις που δημιουργεί το WordPress:

HTML
<p class="intro">Introduction</p>
<block name="core/group" className="feature">
  <h2 class="title">Feature</h2>
</block>

Αν υπάρχουν και οι δύο ιδιότητες, υπερισχύει το className. Αυτή η μετατροπή ισχύει μόνο για βασικά μπλοκ: η αντιστοίχιση προσαρμοσμένου μπλοκ διατηρεί αμετάβλητο το πεδίο class. Οι κλάσεις στυλ κουμπιού, όπως η is-style-outline, ανήκουν στο περίβλημα του κουμπιού και όχι στον σύνδεσμό του.

Εκτελέστε το wp bs pages sync για να εφαρμοστούν διορθώσεις του parser στις σελίδες που είχαν συγχρονιστεί προηγουμένως. Οι αναβαθμίσεις του parser αναγνωρίζονται στον επόμενο ρητό συγχρονισμό, χωρίς να απαιτείται αλλαγή στο αρχείο προέλευσης. Οι κλειδωμένες σελίδες και οι σελίδες με sync: false διατηρούν τις συνήθεις προστασίες τους· τα αιτήματα frontend δεν εκτελούν ποτέ αυτόν τον συγχρονισμό.

Αποθηκευμένα μπλοκ WordPress

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

HTML
<!-- wp:paragraph {"className":"intro"} -->
<p class="intro">Introduction</p>
<!-- /wp:paragraph -->

Όταν η πηγή περιέχει ένα <!-- wp:... --> οριοθέτη μπλοκ, το Blockstudio χρησιμοποιεί τον εγγενή αναλυτή μπλοκ του WordPress για ολόκληρη την πηγή. Τα γνωρίσματα, τα ένθετα μπλοκ, τα δυναμικά μπλοκ όπως το Query Loop και τα μπλοκ Blockstudio διατηρούν τη σειριοποιημένη δομή τους. Το HTML έξω από τα σχόλια μπλοκ παραμένει εγγενές ελεύθερο περιεχόμενο HTML· δεν αντιστοιχίζεται σε επιπλέον μπλοκ. Μην αναμειγνύετε τις ετικέτες μπλοκ HTML του Blockstudio με αυτήν τη μορφή και περιμένετε να μετατραπούν. Τα συνηθισμένα σχόλια HTML δεν επιλέγουν τη λειτουργία σειριοποιημένων μπλοκ.

Σελίδες Markdown

Χρησιμοποιήστε το Markdown όταν το κείμενο πρέπει να βρίσκεται σε αρχεία, αλλά να μετατρέπεται σε επεξεργάσιμο περιεχόμενο μπλοκ WordPress μετά τον συγχρονισμό. Η πηγή Markdown μετατρέπεται σε σήμανση μπλοκ κατά τον συγχρονισμό. Η συγχρονισμένη ανάρτηση αποθηκεύει μπλοκ, όχι το ακατέργαστο σώμα Markdown.

Το Markdown μπορεί να χρησιμοποιηθεί με τρεις τρόπους:

Πηγή Απαιτείται frontmatter; Σημειώσεις
Αυτόνομο pages/example/index.md Ναι Το frontmatter παρέχει την ταυτότητα της σελίδας.
page.json μαζί με index.md Όχι Το page.json ορίζει τη σελίδα και το Markdown παρέχει το περιεχόμενο.
Markdown μέσα σε συλλογή Όχι Η συλλογή συνάγει τα name και path από τη θέση του αρχείου.

Ένα αυτόνομο index.md χωρίς frontmatter παραλείπεται, επειδή το Blockstudio δεν έχει ταυτότητα σελίδας για συγχρονισμό. Το Markdown συλλογής δεν χρειάζεται frontmatter, επειδή το manifest της συλλογής και η διαδρομή του αρχείου παρέχουν αυτή την ταυτότητα.

Markdown
---
name: about
title: About
slug: about
postStatus: publish
---

# About

This Markdown content is synced as native WordPress blocks.

Μπορείτε επίσης να συνδυάσετε το page.json με το index.md. Σε αυτή την περίπτωση, το page.json ορίζει τη σελίδα και το index.md παρέχει το περιεχόμενο. Το frontmatter στο index.md υπερισχύει των αντίστοιχων τιμών του page.json.

JSON
{
  "name": "docs-reference",
  "title": "Reference",
  "path": "reference",
  "sync": true
}
Markdown
---
title: API Reference
order: 20
---

# Reference

This page uses `page.json` with Markdown content.

Για το Markdown συλλογής, η διαδρομή του αρχείου γίνεται η λογική διαδρομή της σελίδας, εκτός αν το frontmatter την παρακάμπτει:

Αρχείο Προεπιλεγμένη διαδρομή
pages/docs/index.md .
pages/docs/getting-started.md getting-started
pages/docs/guide/install/index.md guide/install
pages/docs/guide/install.md guide/install

Τα άγνωστα κλειδιά frontmatter διατηρούνται στον πίνακα meta της σελίδας. Έτσι μπορείτε να επισυνάψετε δεδομένα όπως section ή description και να τα διαβάσετε από το PHP API.

Το Markdown αναλύεται ως GitHub Flavored Markdown. Επιτρέπεται ακατέργαστο HTML, οι μη ασφαλείς σύνδεσμοι αφαιρούνται και οι επικεφαλίδες χωρίς ρητό ID λαμβάνουν ένα σταθερό ID. Το ένθετο frontmatter YAML απαιτεί τον συμπεριλαμβανόμενο αναλυτή YAML.

Ακατέργαστο Markdown

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

Ζητήστε τη σελίδα με επίθημα .md, όπως το https://example.com/docs/reference.md. Εναλλακτικά, στείλτε κεφαλίδα Accept: text/markdown στο κανονικό URL της σελίδας:

Κέλυφος
curl -H "Accept: text/markdown" https://example.com/docs/reference/

Το frontmatter αφαιρείται από την απόκριση. Οι επιτυχείς ακατέργαστες αποκρίσεις Markdown στέλνουν πίσω τα Content-Type: text/markdown, X-Robots-Tag: noindex και μια κανονική κεφαλίδα Link στη σελίδα HTML. Οι διαδρομές .md που δεν υπάρχουν επιστρέφουν πραγματικό 404.

Η διαπραγμάτευση λειτουργεί με στατική προαπόδοση: ένα αίτημα του οποίου η κεφαλίδα Accept περιέχει text/markdown δεν απαντάται ποτέ από τον χώρο αποθήκευσης προαποδοσμένων σελίδων ή το drop-in πρόωρης εξυπηρέτησης, επομένως φτάνει στο WordPress και τον χειριστή Markdown. Οι προαποδοσμένες αποκρίσεις HTML, η HTML μιας σελίδας που διαπραγματεύεται επίσης Markdown, και η Markdown που απαντάται μέσω Accept στέλνουν Vary: Accept, ώστε οι κρυφές μνήμες που λαμβάνουν υπόψη το Vary να τις διατηρούν χωριστά. Ένα CDN που βασίζει την κρυφή μνήμη του μόνο στο URL χρειάζεται δικό του κανόνα για παράκαμψη της κρυφής μνήμης σε τέτοια αιτήματα. Το Pages::negotiates_markdown( $post_id ) αναφέρει αν μια σελίδα απαντά σε αιτήματα Markdown.

Το Markdown συλλογής διατηρεί την ίδια μορφή URL για ακατέργαστο Markdown:

Σελίδα URL Ακατέργαστο Markdown URL
/docs/ /docs.md
/docs/getting-started/ /docs/getting-started.md
/docs/guide/install/ /docs/guide/install.md

Απενεργοποιήστε τις ακατέργαστες αποκρίσεις Markdown με το φίλτρο blockstudio/pages/serve_markdown:

PHP
add_filter( 'blockstudio/pages/serve_markdown', '__return_false' );

Ένα αίτημα .md URL που δεν αντιστοιχεί σε σελίδα βασισμένη σε Markdown επιστρέφει 404 μόνο όταν η διαδρομή βρίσκεται μέσα σε συλλογή σελίδων. Εκτός όλων των συλλογών, το Blockstudio αφήνει το αίτημα στα WordPress και άλλα πρόσθετα.

Σελίδες στοιχείων

Μια σελίδα στοιχείου αποδίδεται από έναν αποδοτή σελίδων αντί να αποθηκεύεται ως μπλοκ. Το Blockstudio δεν περιλαμβάνει αποδοτή. Ένα θέμα ή πρόσθετο καταχωρίζει έναν για τα αρχεία καταχώρισης που χειρίζεται, όπως έναν αποδοτή React για το page.tsx, και το Blockstudio τον καλεί με τη σελίδα, την ανάρτηση WordPress και το αποδοσμένο περιεχόμενο υποδοχής.

Text
pages/legal-notice/
  page.json
  page.tsx
  data.php
JSON
{
  "name": "legal-notice",
  "title": "Legal Notice",
  "slug": "legal-notice",
  "postStatus": "publish",
  "render": { "entry": "page.tsx", "data": "data.php" }
}

Το render είναι ρητό. Ένας κατάλογος με ένα index.php και ένα page.tsx, αλλά χωρίς render, παραμένει μια συνηθισμένη σελίδα, ώστε η προσθήκη αποδότη να μην αποδίδει ποτέ ξανά μια υπάρχουσα σελίδα. Οι μορφές είναι:

Τιμή Σημασία
"page.tsx" Μόνο καταχώριση, χωρίς loader δεδομένων
{ "entry": "page.tsx", "data": "data.php" } Καταχώριση και loader δεδομένων
{ "entry": "page.tsx", "renderer": "react" } Καταχώριση με ρητό αναγνωριστικό αποδότη
false Χωρίς αποδοτή, ακόμη κι όταν μια προεπιλογή συλλογής καθορίζει έναν

Οι διαδρομές επιλύονται σε σχέση με τον κατάλογο της σελίδας ή με τη ρίζα της συλλογής για καταχωρίσεις loader. Πρέπει να παραμένουν μέσα στην πηγή ανακάλυψης, εκτός αν το blockstudio/pages/allow_external_loader_path το επιτρέπει. Χωρίς το renderer, χρησιμοποιείται ο αποδοτής που αναλαμβάνει την επέκταση της καταχώρισης. Ένα render που αναφέρεται σε ανύπαρκτη καταχώριση ή αρχείο δεδομένων, σε άγνωστο αποδοτή ή σε επέκταση που δεν αναλαμβάνει κανένας αποδοτής αποτελεί σφάλμα ανακάλυψης, το οποίο διακόπτει τη συμφιλίωση πριν διαγραφεί οτιδήποτε.

Τι αποθηκεύει ο συγχρονισμός

Ο συγχρονισμός αποθηκεύει ένα μπλοκ blockstudio/page. Όταν ο κατάλογος της σελίδας περιέχει επίσης μια πηγή index.*, η πηγή αναλύεται όπως κάθε πηγή σελίδας και γίνεται τα εσωτερικά μπλοκ του μπλοκ, δηλαδή η υποδοχή του:

HTML
<!-- wp:blockstudio/page /-->

<!-- wp:blockstudio/page -->
<!-- wp:paragraph -->
<p>[download_checkout]</p>
<!-- /wp:paragraph -->
<!-- /wp:blockstudio/page -->

Διατηρήστε στην υποδοχή περιεχόμενο που ανήκει στο WordPress, όπως τα shortcode. Μια πηγή που αποτελείται από ένα μόνο shortcode, όπως το [download_checkout], αποθηκεύεται ως μπλοκ core/shortcode, ώστε η έξοδός του να μην περιβάλλεται από παράγραφο. Παραμένει στο post_content, ώστε να το βλέπουν οι έλεγχοι has_shortcode(), τα μπλοκ υποδοχής με κλειδιά να συγχωνεύονται με τις αλλαγές του επεξεργαστή όπως τα εμφωλευμένα μπλοκ με κλειδιά και το do_shortcode να επεκτείνει τα shortcode μία φορά, με τη συνήθη προτεραιότητα the_content, αφού ο αποδοτής τα έχει πλαισιώσει.

Ο ορισμός απόδοσης αποθηκεύεται μαζί με την ανάρτηση ως φορητές διαδρομές theme:. Το αποτύπωμα της σελίδας καλύπτει τον ορισμό, όχι τα byte της καταχώρισης ή του loader δεδομένων: η επεξεργασία των page.tsx ή data.php αφήνει την ανάρτηση αμετάβλητη και φτάνει στους επισκέπτες μέσω της απόδοσης και του γραφήματος στατικής προαπόδοσης, το οποίο καταγράφει την καταχώριση, τον loader δεδομένων και κάθε αρχείο που αναφέρει ο αποδοτής.

Καταχώριση αποδότη

Καταχωρίστε αποδότες στην ενέργεια blockstudio/pages/renderers. Εκτελείται μία φορά ανά αίτημα, πριν από την πρώτη ανακάλυψη ή απόδοση, ώστε τα αιτήματα wp bs pages sync και τα αιτήματα διεπαφής χρήστη να βλέπουν το ίδιο μητρώο.

PHP
add_action(
	'blockstudio/pages/renderers',
	static function (): void {
		Blockstudio\Page_Renderers::register(
			'react',
			array(
				'extensions' => array( 'tsx' ),
				'layouts'    => array( 'layout.tsx' ),
				'render'     => 'my_theme_render_page',
			)
		);
	}
);

Τα αναγνωριστικά αποδότη είναι πεζά. Μια επέκταση ή ένα όνομα διάταξης μπορεί να ανήκει σε έναν μόνο αποδοτή και το layout.php παραμένει διάταξη που ανήκει στο Blockstudio. Η συνάρτηση δέχεται ένα αίτημα:

Κλειδί Τιμή
kind page ή layout για διάταξη αποδότη διάταξη
renderer Αναγνωριστικό αποδότη
entry Απόλυτη διαδρομή καταχώρισης
data Απόλυτη διαδρομή loader δεδομένων ή null
page Κανονικά δεδομένα σελίδας, συμπεριλαμβανομένου του meta
post_id Αναγνωριστικό ανάρτησης WordPress
slot Αποδοσμένο περιεχόμενο υποδοχής ή το περιεχόμενο της σελίδας για μια διάταξη
context frontend, rest, feed ή cli

Επιστρέφει το HTML, τα αρχεία που διάβασε η απόδοση και προαιρετικά στοιχεία:

PHP
function my_theme_render_page( array $request ): array {
	return array(
		'html'         => '<main>...</main>',
		'dependencies' => array( '/abs/path/to/a/file/the/render/read.tsx' ),
		'assets'       => array( array( 'path' => '/abs/path/to/page.js' ) ),
	);
}

Το context προέρχεται από τον τύπο του αιτήματος και ποτέ από τον επισκέπτη, επομένως ένας renderer δεν μπορεί να διαταράξει την ισοτιμία byte μεταξύ συνδεδεμένων και ανώνυμων χρηστών διαβάζοντάς το. Αν ένας renderer αποτύχει, προκαλεί εξαίρεση: η σελίδα δεν αποδίδει κενό σώμα. Σε προεπισκόπηση επεξεργασίας REST, το μπλοκ εμφανίζει αντί γι’ αυτό το σφάλμα ως ειδοποίηση. Μετά από επιτυχή απόδοση, η ενέργεια blockstudio/pages/rendered λαμβάνει τη σελίδα, το HTML και τις εξαρτήσεις της.

Το assets παραθέτει τα αρχεία script και style που χρειάζεται η σελίδα. Υποβάλλονται στην επεξεργασία των στοιχείων ενεργητικού των μπλοκ (τη σύμβαση *.inline.*, τις μονάδες ES, την ελαχιστοποίηση και το ?ver), και η σελίδα τα εκτυπώνει μία φορά, μέσω του ίδιου buffer που εκτυπώνει τα στοιχεία ενεργητικού των μπλοκ, ώστε να περιλαμβάνονται στις προαποδοσμένες σελίδες. Ένα στοιχείο ενεργητικού μπορεί να ορίσει το version για να αντικαταστήσει την τιμή ?ver του. Κώδικας εκτός renderer μπορεί να χρησιμοποιήσει το ίδιο κανάλι μέσω του Blockstudio\Assets::register_owner(), το οποίο επιστρέφει το σχόλιο-δείκτη προς εκτύπωση.

Επεξεργαστής

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

Συλλογές σελίδων

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

Κώδικας
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
    loader.php
JSON
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "postTypeArgs": {
    "label": "Docs",
    "rewrite": {
      "slug": "docs"
    },
    "supports": ["title", "editor", "page-attributes"]
  },
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}
Ιδιότητα Τύπος Περιγραφή
collection / slug / name string Slug συλλογής. Το collection είναι η σαφέστερη μορφή και γίνεται η βασική τιμή του δημόσιου URL.
title string Τίτλος συλλογής κατανοητός από τον άνθρωπο.
postType string Τύπος δημοσίευσης για τις σελίδες που δημιουργούνται. Προεπιλογή είναι το page. Αν δεν υπάρχει, το Blockstudio τον καταχωρίζει.
postTypeArgs object Ορίσματα που περνούν στο register_post_type() όταν το Blockstudio καταχωρίζει τον τύπο δημοσίευσης της συλλογής.
defaults object Προεπιλεγμένες ιδιότητες σελίδας που εφαρμόζονται σε κάθε σελίδα της συλλογής. Μια προεπιλεγμένη τιμή render εφαρμόζεται σε σελίδα μόνο όταν υπάρχει η αντίστοιχη καταχώριση στον κατάλογο σελίδων.
scope string collection (προεπιλογή) ή site. Δείτε τις Συλλογές ιστότοπων.
meta object Προσαρμοσμένα μεταδεδομένα συλλογής. Τα άγνωστα κλειδιά της δήλωσης αποθηκεύονται επίσης στο meta.

Οι διαδρομές σελίδων μιας συλλογής είναι λογικές διαδρομές. Μια σελίδα με path: "guide/install" συγχρονίζεται ως θυγατρική της guide, ενώ η guide συγχρονίζεται ως θυγατρική της ρίζας της συλλογής, εφόσον υπάρχουν αυτές οι γονικές σελίδες.

Αν μια ιεραρχική συλλογή έχει ένθετη σελίδα αλλά δεν υπάρχει πηγή για έναν ενδιάμεσο γονέα, το Blockstudio δημιουργεί μια κενή σελίδα-κοντέινερ για αυτή τη διαδρομή, διατηρώντας πλήρη την ιεραρχία WordPress. Οι μη ιεραρχικοί τύποι αναρτήσεων (χωρίς υποστήριξη γονέα page-attributes) δεν δημιουργούν κενά κοντέινερ. Δρομολογούν βάσει της αποθηκευμένης διαδρομής συλλογής, οπότε ένθετες διαδρομές όπως οι guide/install και setup/install μπορούν να συνυπάρχουν, παρότι και οι δύο καταλήγουν στο install.

Τύποι αναρτήσεων και URL συλλογών

Ορίστε το postType στο manifest της συλλογής για να συγχρονίζονται όλες οι σελίδες της συλλογής με αυτόν τον τύπο ανάρτησης. Δεν χρειάζεται να επαναλάβετε την ίδια τιμή μέσα στο defaults. Οι μεμονωμένες σελίδες μπορούν και πάλι να παρακάμπτουν το postType στο frontmatter ή στο page.json.

Όταν ο τύπος ανάρτησης δεν υπάρχει, το Blockstudio τον καταχωρίζει με το show_in_rest: true, μια ρύθμιση επεξεργαστή τύπου σελίδας και το slug συλλογής ως δημόσια βάση URL. Το postTypeArgs μπορεί να παρακάμψει τα ορίσματα καταχώρισης. Οι κανόνες επανεγγραφής για τους τύπους αναρτήσεων συλλογής ανανεώνονται αυτόματα όταν αλλάζουν οι καταχωρισμένοι τύποι αναρτήσεων συλλογής ή τα ορίσματα επανεγγραφής, οπότε δεν χρειάζεται να αποθηκεύσετε ξανά τους μόνιμους συνδέσμους WordPress.

Τα URL συλλογών χρησιμοποιούν το slug της συλλογής και τη λογική διαδρομή path κάθε σελίδας:

Διαδρομή πηγής Δημόσια URL
path: "." /docs/
path: "getting-started" /docs/getting-started/
path: "guide/install" /docs/guide/install/

Αυτό το μοντέλο URL λειτουργεί τόσο για ιεραρχικούς όσο και για μη ιεραρχικούς τύπους αναρτήσεων συλλογών. Το Blockstudio ανακατευθύνει επίσης διπλές διευθύνσεις URL, όπως /docs/docs/ ή /docs/docs/getting-started/, στην κανονική διεύθυνση URL.

Οι σελίδες συλλογών εκθέτουν ακατέργαστο Markdown στις ίδιες διευθύνσεις URL (δείτε Ακατέργαστο Markdown).

Αν αλλάξετε μια συλλογή από postType: "page" σε προσαρμοσμένο τύπο ανάρτησης, το Blockstudio μεταφέρει επί τόπου τις ήδη συγχρονισμένες αναρτήσεις συλλογής, όταν η αποθηκευμένη ταυτότητα σελίδας τους ταιριάζει. Έτσι διατηρούνται τα αναγνωριστικά αναρτήσεων, τα μεταδεδομένα και το υπάρχον περιεχόμενο, ενώ αποφεύγονται οι διπλότυπες αναρτήσεις παλιού τύπου. Οι παρωχημένες αναρτήσεις συλλογής καθαρίζονται σε όλες τις καταστάσεις ανάρτησης σύμφωνα με το φίλτρο blockstudio/pages/orphan_action.

Συλλογές ιστότοπων

Μια δήλωση με "scope": "site" ομαδοποιεί όλες τις σελίδες που βρίσκονται από κάτω της, χωρίς να τις μετατρέπει σε σελίδες συλλογής. Χρησιμοποιήστε τη στη ρίζα του δέντρου σελίδων ενός ιστότοπου για να εφαρμόσετε κοινές προεπιλογές και να παραθέσετε τις σελίδες του ιστότοπου με το blockstudio_page_tree( 'my-site' ).

JSON
{
  "collection": "my-site",
  "title": "My Site",
  "scope": "site",
  "defaults": {
    "postStatus": "publish",
    "templateLock": "all",
    "render": { "entry": "page.tsx", "data": "data.php" }
  }
}

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

  • Τα κλειδιά παραμένουν καθολικά: το Pages::get_page( 'home' ) και τα αποθηκευμένα κλειδιά σελίδων συνεχίζουν να αντιστοιχούν.
  • Οι διευθύνσεις URL παραμένουν διευθύνσεις σελίδων WordPress. Δεν εφαρμόζονται κανόνες επανεγγραφής συλλογών, φίλτρο μόνιμων συνδέσμων ή ανακατεύθυνση διπλού URL, και δεν δημιουργούνται κενές σελίδες-περιέκτες.
  • Οι λογικές διαδρομές, τα slug, οι γονικές σελίδες και οι ταυτότητες πηγής είναι εκείνες των αυτόνομων σελίδων, ενώ οι διατάξεις επιλύονται με βάση τον πλησιέστερο πρόγονο.
  • Οι εμφωλευμένες δηλώσεις pages.json διατηρούν τις δικές τους συλλογές, και τα υποδέντρα τους εξαιρούνται από τη συλλογή ιστότοπου.
  • Οι προεπιλογές εφαρμόζονται ανά σελίδα: μια προεπιλεγμένη τιμή render εφαρμόζεται μόνο σε σελίδες των οποίων ο κατάλογος περιέχει την αντίστοιχη καταχώριση, ώστε οι σελίδες shortcode και Markdown να διατηρούν τις πηγές τους.

Φορτωτές συλλογών

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

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

PHP
<?php

return array(
  'meta' => array(
    'source' => 'loader',
  ),
  'paths' => array(
    __DIR__ . '/external-docs',
    array(
      'path' => __DIR__ . '/cli-docs',
      'prefix' => 'cli',
      'meta' => array(
        'doc_set' => 'cli',
      ),
    ),
  ),
  'pages' => array(
    array(
      'name' => 'docs-api',
      'title' => 'API',
      'path' => 'api',
      'content' => "# API\n\nGenerated markdown content.",
      'contentType' => 'markdown',
    ),
    array(
      'name' => 'docs-template',
      'title' => 'Template',
      'path' => 'template',
      'file' => __DIR__ . '/template.md',
    ),
  ),
);

Ένας φορτωτής μπορεί να επιστρέψει έναν πίνακα με κλειδιά pages, meta και paths:

Κλειδί Περιγραφή
pages Λίστα πινάκων σελίδων. Κάθε σελίδα υποστηρίζει τα ίδια αναγνωρισμένα κλειδιά με το frontmatter page.json και Markdown.
meta Μεταδεδομένα που συγχωνεύονται στον πίνακα meta κάθε σελίδας που δημιουργείται από το loader.
paths Επιπλέον τοπικοί κατάλογοι προς ανακάλυψη ως μέρος αυτής της συλλογής. Οι καταχωρίσεις μπορεί να είναι συμβολοσειρές ή αντικείμενα διαδρομής.
render Ένας ορισμός απόδοσης για κάθε σελίδα Markdown που εντοπίζεται από το paths.

Ως συντομογραφία, ο φορτωτής μπορεί να επιστρέψει απευθείας μια λίστα πινάκων σελίδων.

Οι καταχωρίσεις σελίδων του φορτωτή μπορούν να παρέχουν περιεχόμενο με τους εξής τρόπους:

Μορφή Περιγραφή
markdown Ενσωματωμένο περιεχόμενο Markdown.
html Ενσωματωμένο περιεχόμενο HTML.
content + contentType Γενικό ενσωματωμένο περιεχόμενο. Το contentType πρέπει να αντιστοιχεί σε markdown ή html.
file Πηγή τοπικού αρχείου. Ο τύπος συνάγεται από την επέκταση, εκτός αν έχει οριστεί το contentType.
template Ψευδώνυμο για το file.

Οι αναφορές αρχείων του φορτωτή μπορούν να δείχνουν σε πηγές PHP, Blade, Twig, Markdown ή HTML. Οι σχετικές διαδρομές επιλύονται από τη ρίζα της συλλογής. Οι απόλυτες διαδρομές και οι διαδρομές εκτός της ρίζας της συλλογής επιτρέπονται μόνο αν το φίλτρο blockstudio/pages/allow_external_loader_path το επιτρέπει.

Οι σελίδες φορτωτή έχουν ως προεπιλογή το generated: true. Όταν μια σελίδα που δημιουργήθηκε από τον φορτωτή εξαφανιστεί από την έξοδό του, το Blockstudio αντιμετωπίζει τη συγχρονισμένη ανάρτηση ως ορφανή στον επόμενο συγχρονισμό και την καθαρίζει σύμφωνα με το φίλτρο blockstudio/pages/orphan_action.

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

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

PHP
'paths' => array(
  array(
    'path' => __DIR__ . '/cli-docs',
    'prefix' => 'cli',
    'meta' => array(
      'doc_set' => 'cli',
    ),
  ),
),

Με αυτή τη ρύθμιση, το cli-docs/index.md γίνεται path: "cli" και το cli-docs/getting-started.md γίνεται path: "cli/getting-started" στη συλλογή. Τα προθέματα αποτρέπουν επίσης τις συγκρούσεις ονομάτων για τις σελίδες που δημιουργούνται, ώστε πολλοί προσαρτημένοι κατάλογοι να μπορούν να περιέχουν ο καθένας index.md ή getting-started.md. Ορίστε το preserveNames σε true στο αντικείμενο διαδρομής, αν θέλετε να διατηρούνται οι ρητές τιμές name από το frontmatter των page.json ή Markdown.

Ιδιότητες αντικειμένου διαδρομής:

Ιδιότητα Τύπος Περιγραφή
path string Τοπικός κατάλογος προς ανακάλυψη. Οι σχετικές διαδρομές επιλύονται από τη ρίζα της συλλογής.
prefix string Προαιρετικό πρόθεμα λογικής διαδρομής μέσα στη συλλογή.
preserveNames boolean Διατηρεί ρητά ονόματα σελίδων αντί να δημιουργεί ονόματα από τη διαδρομή με το πρόθεμα. Προεπιλογή είναι το false όταν έχει οριστεί το prefix.
meta object Μεταδεδομένα που συγχωνεύονται σε κάθε σελίδα που εντοπίζεται από αυτή τη διαδρομή. Τα μεταδεδομένα σε επίπεδο σελίδας υπερισχύουν για διπλότυπα κλειδιά.
render string|object Ορισμός απόδοσης για τις σελίδες Markdown αυτής της διαδρομής, ο οποίος υπερισχύει του render του loader.

Απόδοση του Markdown μέσω στοιχείου

Με το render, οι σελίδες Markdown που εντοπίζει ένας loader αποδίδονται μέσω renderer σελίδας αντί να αποθηκεύονται ως μπλοκ:

PHP
<?php

return array(
  'paths'  => array( __DIR__ . '/external-docs' ),
  'render' => array(
    'entry' => __DIR__ . '/document.tsx',
    'data'  => __DIR__ . '/document.php',
  ),
);

Παραμένουν σελίδες Markdown: ο τύπος περιεχομένου, η διαδρομή περιεχομένου, οι αποκρίσεις .md και το frontmatter παραμένουν αμετάβλητα. Ο συγχρονισμός αποθηκεύει ένα μπλοκ blockstudio/page, του οποίου το εσωτερικό HTML είναι το μετατρεπόμενο Markdown, καθαρισμένο αν η συλλογή καθαρίζει το περιεχόμενό της, αντί για αναλυμένα μπλοκ, ώστε το post_content να διατηρεί το κείμενο του εγγράφου. Ο renderer λαμβάνει αυτό το HTML ως υποδοχή και μπορεί να διαβάσει την πηγή από το page.content_path. Οι σχετικές διαδρομές επιλύονται από τη ρίζα της συλλογής· το εξωτερικό φίλτρο διαδρομής εφαρμόζεται όπως και για τις διαδρομές. Μια σελίδα με frontmatter που ορίζει δικό της render ή render: false εξαιρείται.

Διατάξεις

Ένα αρχείο layout.php περιβάλλει την απόδοση στο frontend μιας σελίδας που βασίζεται σε αρχείο. Δεν αντικαθιστά το συγχρονισμένο post_content που είναι αποθηκευμένο στο WordPress και δεν περιβάλλει τον καμβά του επεξεργαστή. Η διάταξη εκτελείται μόνο σε αιτήματα μεμονωμένων σελίδων στο frontend.

Για συλλογές, τοποθετήστε το layout.php δίπλα στο pages.json για να περιβάλλετε κάθε σελίδα αυτής της συλλογής στο frontend:

PHP
<?php $current = blockstudio_current_page(); ?>

<main class="docs-layout">
  <aside>
    <?php foreach (blockstudio_page_tree('docs') as $item) : ?>
      <?php $is_current = ($item['post_id'] ?? null) === ($current['post_id'] ?? null); ?>
      <a
        href="<?php echo esc_url($item['permalink'] ?? '#'); ?>"
        <?php echo $is_current ? 'aria-current="page"' : ''; ?>
      >
        <?php echo esc_html($item['title']); ?>
      </a>
    <?php endforeach; ?>
  </aside>

  <article>
    <?php echo blockstudio_page_content(); ?>
  </article>
</main>

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

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

PHP
blockstudio_current_page();
blockstudio_page_collection('docs');
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_content();

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

Διατάξεις renderer

Μια διάταξη μπορεί επίσης να είναι καταχώριση renderer, όπως το layout.tsx για έναν renderer που καταχωρίζει το layouts: ["layout.tsx"]. Εντοπίζεται στα ίδια σημεία με το layout.php, ενώ ένα προαιρετικό layout.data.php δίπλα του είναι ο loader δεδομένων του. Κατά την απόδοση, ο renderer λαμβάνει το kind: "layout" και το αποδοσμένο περιεχόμενο της σελίδας ως slot, με την ίδια προτεραιότητα the_content όπως το layout.php. Ένας κατάλογος μπορεί να περιέχει layout.php ή μία διάταξη renderer, όχι και τα δύο· αν περιέχει και τα δύο, προκύπτει σφάλμα εντοπισμού. Σε περίπτωση αποτυχίας διάταξης ενεργοποιείται το blockstudio/pages/layout_error και το περιεχόμενο της σελίδας παραμένει χωρίς περίβλημα, όπως συμβαίνει και με το layout.php.

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

Η ιδιότητα blockEditingMode ελέγχει τον τρόπο με τον οποίο μπορούν να επεξεργαστούν τα μπλοκ στον επεξεργαστή. Ορίστε μια προεπιλεγμένη τιμή σε επίπεδο σελίδας στο page.json και παρακάμψτε την ανά στοιχείο στο πρότυπο:

JSON
{
  "name": "about",
  "title": "About Us",
  "templateLock": "all",
  "blockEditingMode": "disabled"
}
HTML
<h1 blockEditingMode="contentOnly">Editable Title</h1>
<p>This paragraph inherits "disabled" from the page default.</p>
<block name="core/buttons" blockEditingMode="default">
  <block name="core/button" url="/contact">Fully editable button</block>
</block>
Τιμή Περιγραφή
"default" Πλήρης επεξεργασία. Μπορείτε να επιλέγετε, να μετακινείτε και να επεξεργάζεστε μπλοκ
"contentOnly" Μόνο επεξεργασία κειμένου. Το κείμενο των μπλοκ είναι επεξεργάσιμο, αλλά οι ρυθμίσεις και η δομή είναι κλειδωμένες
"disabled" Χωρίς επεξεργασία. Τα μπλοκ δεν είναι καθόλου διαδραστικά

Οι παρακάμψεις ανά στοιχείο ορίζονται ως ιδιότητες HTML σε οποιοδήποτε στοιχείο (<h1>, <p>, <div> κ.λπ.) ή σε στοιχεία <block>. Τα μπλοκ κοντέινερ-πρόγονοι των στοιχείων με παράκαμψη ορίζονται αυτόματα σε contentOnly, ώστε τα παιδιά τους να παραμένουν προσβάσιμα. Αυτή η διάδοση ανεβαίνει από το στοιχείο με παράκαμψη έως τη ρίζα της σελίδας, επομένως χρειάζεται να ορίσετε το blockEditingMode μόνο στα στοιχεία που θέλετε να είναι επεξεργάσιμα.

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

Η ιδιότητα templateLock ελέγχει τον τρόπο με τον οποίο οι χρήστες μπορούν να επεξεργαστούν τη σελίδα στον επεξεργαστή:

Τιμή Προσθήκη/Αφαίρεση Μετακίνηση Επεξεργασία περιεχομένου
"all" Όχι Όχι Όχι
"insert" Όχι Ναι Ναι
"contentOnly" Όχι Όχι Ναι
false Ναι Ναι Ναι

Όταν ορίζεται ένα templateLock, το Blockstudio απενεργοποιεί τη δυνατότητα ξεκλειδώματος μπλοκ μέσω του UI του επεξεργαστή.

Εικονικές διαδρομές

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

PHP
add_action( 'init', function () {
    Blockstudio\Virtual_Routes::register(
        'components',
        function ( $component, string $rest ) {
            get_header();
            echo my_component_page( $component );
            get_footer();
        },
        [
            'prefix' => true,
            'match'  => fn ( string $rest ) => '' === $rest ? 'index' : my_component( $rest ),
            'title'  => fn ( $component ) => my_component_title( $component ),
            'urls'   => fn () => my_component_paths(),
        ]
    );
} );

Η διαδρομή είναι σχετική με την αρχική σελίδα του ιστότοπου. Με το prefix, η διαδρομή εξυπηρετεί επίσης κάθε διαδρομή κάτω από αυτήν, και το match λαμβάνει το υπόλοιπο (κενή συμβολοσειρά για την ίδια τη διαδρομή) και επιστρέφει την τιμή που λαμβάνει η συνάρτηση επανάκλησης απόδοσης ή το null για να αφήσει το URL στο WordPress, το οποίο στη συνέχεια απαντά στο 404 όπως συνήθως. Η συνάρτηση επανάκλησης απόδοσης εκτυπώνει το έγγραφο ή το επιστρέφει ως συμβολοσειρά· το title είναι συμβολοσειρά ή κλείσιμο που λαμβάνει την τιμή αντιστοίχισης.

Για ένα αίτημα που αντιστοιχίστηκε, το Blockstudio εμποδίζει το WordPress να επισημάνει ένα 404 και το redirect_canonical να το ανακατευθύνει, εκκαθαρίζει την κατάσταση μεμονωμένης σελίδας που αναφέρει το κύριο ερώτημα, στέλνει την κατάσταση (status, 200 από προεπιλογή) και αποδίδει με προτεραιότητα Virtual_Routes::PRIORITY στο template_redirect. Αυτό γίνεται αμέσως μετά το άνοιγμα του buffer εξόδου του Blockstudio στο Assets::BUFFER_PRIORITY, ώστε το τελικό έγγραφο να λάβει τα στοιχεία μπλοκ, τα ενσωματωμένα στοιχεία UI και το μεταγλωττισμένο Tailwind, όπως κάθε σελίδα, και πριν από το redirect_canonical στην προτεραιότητα 10. Ένας χειριστής που αποδίδει ολόκληρο το έγγραφο μόνος του πρέπει επίσης να εκτελεστεί μετά το Assets::BUFFER_PRIORITY, διαφορετικά παραλείπεται αυτή η επεξεργασία. Οι διαδρομές στο urls (από προεπιλογή η ίδια η διαδρομή της διαδρομής, όταν δεν είναι διαδρομή προθέματος) προστίθενται στις εκδόσεις στατικής προαπόδοσης, και το Virtual_Routes::urls() τις επιστρέφει ως απόλυτες διευθύνσεις URL για χάρτη ιστοτόπου. Το Virtual_Routes::match( $path ) επιλύει μια διαδρομή όπως θα την έλυνε ένα αίτημα.

Συμπεριφορά συγχρονισμού

Οι αναρτήσεις σελίδων αλλάζουν μόνο μέσω ρητής λειτουργίας συγχρονισμού:

Κέλυφος
wp bs pages sync

Η εντολή ανακαλύπτει ολόκληρο το απόθεμα πηγών, δημιουργεί ή ενημερώνει τις αναρτήσεις που άλλαξαν, αφαιρεί επιβεβαιωμένες ορφανές αναρτήσεις, ανανεώνει τη δρομολόγηση συλλογών και τη μεταγλωττισμένη διαμόρφωση templateFor και αναφέρει τις αλλαγές. Προσθέστε το --authoritative για να αντικαταστήσετε το διαχειριζόμενο περιεχόμενο αντί να διατηρήσετε το περιεχόμενο επεξεργαστή με κλειδιά, και το --full για να αναφέρετε τη διεργασία ως πλήρη συμφιλίωση, ανεξάρτητα από την αποθηκευμένη ταυτότητα πηγής:

Κέλυφος
wp bs pages sync --authoritative --full

Τα κανονικά αιτήματα frontend, διαχειριστή, AJAX, REST, cron και γενικής αρχικοποίησης WP-CLI δεν εκτελούν πλήρη ανακάλυψη σελίδων, δεν αναζητούν το απόθεμα συμφιλίωσης που διαχειρίζεται το σύστημα και δεν γράφουν αναρτήσεις σελίδων. Χρησιμοποιούν ήδη συγχρονισμένες αναρτήσεις WordPress μαζί με συμπαγή διαμόρφωση συλλογών και προτύπων τύπων αναρτήσεων που αποθηκεύτηκε στην τελευταία ρητή λειτουργία. Μια νέα εγκατάσταση ή αναβάθμιση μπορεί να σαρώσει μία φορά τα μανιφέστα συλλογών για να επαναφέρει τα μεταδεδομένα δρομολόγησης· αυτή η αρχικοποίηση μόνο για ανάγνωση δεν συγχρονίζει ποτέ περιεχόμενο. Το προαιρετικό, με έλεγχο ταυτότητας, τελικό σημείο ανανέωσης Canvas είναι μια ρητή λειτουργία σύνταξης API: το Canvas το καλεί μία φορά όταν ανοίγει ο χώρος εργασίας, ώστε οι νέες ή τροποποιημένες πηγές να εμφανιστούν στο αρχικό απόθεμα. Η ζωντανή λειτουργία καλεί το ίδιο όριο όταν ανιχνεύει αλλαγή σε πηγή σελίδας.

Το Blockstudio\Pages::init() πλέον καταχωρίζει μόνο άγκιστρα κατά τον χρόνο αιτήματος. Οι ενσωματώσεις που προηγουμένως περνούσαν όρισμα force σε αυτή τη μέθοδο πρέπει να καλούν το Blockstudio\Pages::reconcile() ή να εκτελούν το wp bs pages sync.

Για να αποτρέψετε την αντικατάσταση μιας σελίδας μετά από μη αυτόματες αλλαγές, ορίστε το "sync": false στο page.json.

Φορητές τοποθεσίες πηγών

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

Αυτό επιτρέπει στον συγχρονισμό CLI και στα αιτήματα ιστού να χρησιμοποιούν διαφορετικές ρίζες συστήματος αρχείων, όπως σε περιβάλλοντα φιλοξενίας με περιορισμένη πρόσβαση, χωρίς να διακόπτονται οι αποκρίσεις Markdown, οι διατάξεις, η σάρωση του επεξεργαστή Tailwind ή η παρακολούθηση της πηγής προαπόδοσης. Οι υπάρχουσες απόλυτες διαδρομές θεμάτων προσαρμόζονται κατά την ανάγνωση, όταν το όνομα του καταλόγου του θέματος παραμένει ίδιο. Δεν απαιτείται συγχρονισμός, μετεγκατάσταση βάσης δεδομένων ή εγγραφή μεταδεδομένων κατά το αίτημα για την ανάγνωσή τους· ο επόμενος ρητός συγχρονισμός αποθηκεύει τις φορητές τοποθεσίες.

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

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

Ιδιοκτησία πεδίων αναρτήσεων

Το postStatus ορίζει την αρχική κατάσταση. Οι επόμενοι συγχρονισμοί διατηρούν τις υπάρχουσες καταστάσεις πρόχειρου, σε εκκρεμότητα, ιδιωτική, δημοσιευμένης και προγραμματισμένης δημοσίευσης, ακόμη και με το --authoritative. Ένα πρόχειρο δεν δημοσιεύεται ξανά μόνο και μόνο επειδή το αρχείο του αναφέρει postStatus: "publish". Η υπάρχουσα συμπεριφορά ανάκτησης ορφανών παραμένει ίδια: ένας ρητός συγχρονισμός επαναφέρει μια διαγραμμένη διαχειριζόμενη ανάρτηση, αν υπάρχει η πηγή της. Κλειδώστε τη σελίδα ή απενεργοποιήστε τον συγχρονισμό για να αποτρέψετε αυτή την επαναφορά.

Το αρχείο εξακολουθεί να καθορίζει τον τίτλο, το slug, τον τύπο ανάρτησης, τη γονική ανάρτηση και τη διαμορφωμένη σειρά στο μενού. Η επεξεργασία αυτών των στοιχείων στο WordPress δεν αλλάζει τον ορισμό της πηγής. Ο επόμενος ρητός συγχρονισμός εφαρμόζει ξανά τις τιμές του αρχείου και αναφέρει τα πεδία που επηρεάζονται στο pages.<name>.overwritten, με προειδοποίηση στην έξοδο πίνακα του CLI. Εξακολουθούν να ισχύουν τα εγγενή δικαιώματα του WordPress, συμπεριλαμβανομένου του κενού slug για αναρτήσεις σε εκκρεμότητα, όταν ο χρήστης που εκτελεί τον συγχρονισμό δεν έχει δικαίωμα δημοσίευσής τους.

Χρησιμοποιήστε το blockstudio/pages/update_post_data για μια ενσωμάτωση που έχει ρητά τη δική της πολιτική κατάστασης. Τα μπλοκ με κλειδιά διατηρούν το περιεχόμενο των μπλοκ που διαχειρίζεται ο επεξεργαστής· τα κλειδιά δεν αλλάζουν την ιδιοκτησία του τίτλου ή του slug της ανάρτησης.

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

Όταν αφαιρείται μια πηγή συλλογής, το Blockstudio αφαιρεί τη σελίδα που δημιουργήθηκε, ώστε οι παλιές σελίδες συλλογής να μην παραμένουν μετά τη διαγραφή του αρχείου πηγής. Από προεπιλογή, οι ορφανές σελίδες συλλογής μεταφέρονται στον κάδο απορριμμάτων. Χρησιμοποιήστε το blockstudio/pages/orphan_action για να επιστρέψετε trash, delete ή keep.

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

Συμφιλίωση ανάπτυξης

Το Blockstudio\Pages::reconcile() είναι το σημείο εισόδου ανάπτυξης PHP. Ανακαλύπτει ολόκληρο το επιθυμητό απόθεμα, συγκρίνει τα αποτυπώματα της πηγής και της μηχανής συγχρονισμού και επιστρέφει μια αναφορά αναγνώσιμη από μηχανήματα:

PHP
$report = Blockstudio\Pages::reconcile([
  'authoritative' => true,
  'plan_valid' => true,
  'source' => [
    'commit' => $commit,
    'dirtyHash' => $dirtyHash,
  ],
  'renames' => [
    [
      'from' => 'pages/old/index.php',
      'to' => 'pages/new/index.php',
    ],
  ],
]);

Η αναφορά περιλαμβάνει discovered, created, updated, unchanged, locked, preserved, removed, removedPages, failed, fullReconciliation, αποτελέσματα ανά σελίδα, σφάλματα εντοπισμού και ένα ντετερμινιστικό sourceIdentity.

Οι κλειδωμένες σελίδες έχουν status: "locked" και καταμετρώνται ξεχωριστά από τις αμετάβλητες σελίδες. Το removedPages παραθέτει για κάθε σελίδα που αφαιρέθηκε τα name, key, postId και την πραγματική action (trash ή delete)· οι αναρτήσεις που διατηρήθηκαν ή είχαν ήδη μεταφερθεί στον κάδο δεν καταμετρώνται ως νέες αφαιρέσεις. Η έξοδος πίνακα του CLI αναφέρει επίσης τις σελίδες που δημιουργήθηκαν, ενημερώθηκαν, κλειδώθηκαν, αφαιρέθηκαν ή διατηρήθηκαν ως προς το περιεχόμενό τους, μαζί με τα αναγνωριστικά των αναρτήσεών τους.

Μετά την ανάλυση και τη συγχώνευση βάσει κλειδιών, αν η τελική ανάρτηση είναι πανομοιότυπη, δεν καλείται το wp_update_post(), δεν αλλάζει το post_modified, δεν δημιουργείται αναθεώρηση και δεν ενεργοποιούνται άγκιστρα ενημέρωσης ανάρτησης. Το αποτέλεσμα είναι unchanged. Όταν το περιεχόμενο της πηγής διαφέρει από το περιεχόμενο των μπλοκ που διαχειρίζεται ο επεξεργαστής, το preserved: true προσδιορίζει αυτή την απόφαση και η συνολική καταμέτρηση preserved την περιλαμβάνει. Το νέο αποτύπωμα της πηγής και τα μεταδεδομένα διαχείρισης εξακολουθούν να καταγράφονται, ώστε ο επόμενος αμετάβλητος συγχρονισμός να μην κάνει τίποτα. Το preserved είναι πρόσθετη σημαία, όχι αποκλειστική κατάσταση: μια σελίδα μπορεί να διατηρεί περιεχόμενο μπλοκ με κλειδιά, ενώ παράλληλα ενημερώνεται ένας τίτλος που ανήκει στο αρχείο ή προστίθεται ένα ακόμη μπλοκ.

Το authoritative: true μπορεί να εκκαθαρίσει ένα κλείδωμα Page Sync και αντικαθιστά το περιεχόμενο με βάση τον ορισμό του αρχείου, αντί να διατηρεί το περιεχόμενο επεξεργαστή με κλειδιά. Αφήστε το false για κανονικό ρητό συγχρονισμό. Τα plan_valid: false, full: true, broad: true, μια απούσα προηγούμενη ταυτότητα πηγής ή ένα αλλαγμένο αποτύπωμα μηχανής συγχρονισμού χαρακτηρίζουν τη διεργασία ως πλήρη συμφιλίωση (fullReconciliation στην αναφορά). Σε κάθε περίπτωση, κάθε διεργασία συγκρίνει ολόκληρο το απόθεμα. Οι εγγραφές μετονομασίας Git είναι μόνο υποδείξεις ταυτότητας. Δεν αντικαθιστούν ποτέ τη σύγκριση του πλήρους αποθέματος.

Τα ίδια αποτυπώματα με αμετάβλητες διαδρομές εκτέλεσης δεν προκαλούν εγγραφές σε αναρτήσεις ή postmeta και δεν ενεργοποιούν άγκιστρα ενημέρωσης. Όταν μια αμετάβλητη πηγή μετακινείται σε νέο κατάλογο έκδοσης, η συμφιλίωση ανανεώνει μόνο τις αποθηκευμένες διαδρομές προτύπου, περιεχομένου, διάταξης και καταλόγου· δεν ενημερώνει το post_content ή τη χρονική σήμανση τροποποίησης της ανάρτησης. Οι σελίδες που λείπουν και τις διαχειρίζεται το σύστημα αφαιρούνται μόνο αφού ολοκληρωθεί η πλήρης διεργασία συμφιλίωσης χωρίς σφάλματα ανακάλυψης ή εγγραφής σελίδας.

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

PHP
Blockstudio\Pages::store_successful_source_identity(
  $report['sourceIdentity']
);

Το wp bs pages sync αποθηκεύει την ταυτότητα που επιστράφηκε μετά από επιτυχημένη διεργασία. Η συνήθης αρχικοποίηση WP-CLI καταχωρίζει μόνο τους αποθηκευμένους τύπους αναρτήσεων συλλογών και τους κανόνες επανεγγραφής. Δεν ανακαλύπτει ούτε συγχρονίζει σελίδες.

Καρφίτσωμα αναγνωριστικού ανάρτησης

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

Χρησιμοποιήστε το postId για να καρφιτσώσετε μια σελίδα σε συγκεκριμένο αναγνωριστικό:

JSON
{
  "name": "about",
  "title": "About Us",
  "postId": 42
}

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

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

Συγχώνευση μπλοκ με κλειδιά

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

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

Προσθήκη κλειδιών

Χρησιμοποιήστε την ιδιότητα key σε οποιοδήποτε στοιχείο HTML ή <block>:

HTML
<h1 key="title">Default Title</h1>
<p key="intro">Default intro text.</p>

<div key="features">
  <p>First feature.</p>
  <p>Second feature.</p>
</div>

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

<block
  name="acme/testimonial"
  key="featured-quote"
  quote="Default quote"
/>

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

Τα κλειδιά λειτουργούν με τον ίδιο τρόπο για προσαρμοσμένα μπλοκ Blockstudio. Το key είναι δομικά μεταδεδομένα του Page Sync· οι τιμές των προσαρμοσμένων πεδίων παραμένουν κανονικές ιδιότητες Blockstudio. Όταν ένας χρήστης αλλάζει αυτά τα πεδία, ένας μεταγενέστερος συγχρονισμός προτύπου διατηρεί τις τιμές του χρήστη, εφαρμόζοντας παράλληλα ανεξάρτητες αλλαγές προτύπου. Οι σελίδες που δημιουργήθηκαν από παλαιότερες εκδόσεις με το κλειδί μέσα στα δεδομένα του προσαρμοσμένου πεδίου μεταφέρονται αυτόματα στον επόμενο συγχρονισμό.

Πώς λειτουργεί η συγχώνευση

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

Μπλοκ Συμπεριφορά
Μπλοκ με κλειδί Το περιεχόμενο των χρηστών και οι τιμές πεδίων Blockstudio διατηρούνται. Εφαρμόζονται οι ιδιότητες και η δομή που ελέγχονται από το πρότυπο.
Μπλοκ χωρίς κλειδί Αντικαθίσταται πλήρως από την έκδοση του προτύπου (όπως και χωρίς κλειδιά)

Παραδείγματα

Οι αλλαγές χρηστών διατηρούνται στα μπλοκ με κλειδί:

  1. Το πρότυπο ορίζει το <p key="intro">Default intro.</p>
  2. Ο χρήστης επεξεργάζεται την παράγραφο στον επεξεργαστή και την αλλάζει σε "Προσαρμοσμένο εισαγωγικό κείμενο."
  3. Ο προγραμματιστής ενημερώνει το πρότυπο, προσθέτει ένα νέο μπλοκ και αλλάζει τη διάταξη
  4. Κατά τον συγχρονισμό: η παράγραφος διατηρεί το "Προσαρμοσμένο εισαγωγικό κείμενο.", ενώ εφαρμόζεται η νέα διάταξη

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

  1. Το πρότυπο έχει ένα μπλοκ εξωφύλλου με key="hero" και μια ιδιότητα url
  2. Ο προγραμματιστής αλλάζει την ιδιότητα url του εξωφύλλου σε νέα εικόνα φόντου
  3. Κατά τον συγχρονισμό: εφαρμόζεται η νέα εικόνα φόντου, αλλά διατηρούνται οι αλλαγές περιεχομένου του χρήστη μέσα στο εξώφυλλο

Οριακές περιπτώσεις

Περίπτωση Συμπεριφορά
Προστίθεται νέο μπλοκ με κλειδί στο πρότυπο Εμφανίζεται με το προεπιλεγμένο περιεχόμενο του προτύπου
Αφαιρείται μπλοκ με κλειδί από το πρότυπο Διαγράφεται από την ανάρτηση
Αλλάζει ο τύπος μπλοκ (ίδιο κλειδί) Υπερισχύει πλήρως το πρότυπο, χωρίς συγχώνευση περιεχομένου
Διπλότυπα κλειδιά Η δεύτερη εμφάνιση αντιμετωπίζεται ως μπλοκ χωρίς κλειδί
Δεν υπάρχουν κλειδιά στο πρότυπο Πλήρης αντικατάσταση (όπως και χωρίς κλειδιά)
Αναγκαστικός συγχρονισμός Πλήρης αντικατάσταση, τα κλειδιά αγνοούνται
Κλειδωμένη ανάρτηση Δεν γίνεται καθόλου συγχρονισμός

Συνδυασμός με στοιχεία ελέγχου επεξεργασίας

Τα κλειδιά, το templateLock και το blockEditingMode συνδυάζονται και σας δίνουν λεπτομερή έλεγχο του τι μπορούν και τι δεν μπορούν να κάνουν οι πελάτες. Ακολουθούν συνήθη μοτίβα ροής εργασίας.

Πλήρως κλειδωμένη σελίδα

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

JSON
{
  "name": "terms",
  "title": "Terms of Service",
  "templateLock": "all"
}
HTML
<h1>Terms of Service</h1>
<p>Last updated: January 2025</p>
<p>These terms govern your use of our service...</p>

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

Κλειδωμένη διάταξη με επεξεργάσιμο περιεχόμενο

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

JSON
{
  "name": "landing",
  "title": "Landing Page",
  "templateLock": "all",
  "blockEditingMode": "disabled"
}
HTML
<block name="core/cover" key="hero" url="https://example.com/bg.jpg">
  <h1 blockEditingMode="contentOnly">Edit This Title</h1>
  <p blockEditingMode="contentOnly">Edit this description.</p>
</block>

<div key="features">
  <h2>Features</h2>
  <p blockEditingMode="contentOnly">Editable feature intro.</p>
</div>

<block name="core/buttons">
  <block name="core/button" url="/contact">Contact Us</block>
</block>

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

Εξελισσόμενο πρότυπο με διατήρηση περιεχομένου

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

HTML
<h1 key="title">Welcome</h1>
<p key="intro">Our introduction.</p>
<div key="services">
  <h2>Our Services</h2>
  <p>We offer great things.</p>
</div>
HTML
<h1 key="title">Welcome</h1>
<p key="intro">Our introduction.</p>
<div key="services">
  <h2>Our Services</h2>
  <p>We offer great things.</p>
</div>
<div key="testimonials">
  <h2>Testimonials</h2>
  <p>What our clients say.</p>
</div>
<block name="core/buttons">
  <block name="core/button" url="/contact">Get in Touch</block>
</block>

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

Εφάπαξ βασική δομή

Δημιουργήστε μια σελίδα με αρχική δομή και, στη συνέχεια, παραδώστε την εξ ολοκλήρου. Ορίστε το sync σε false, ώστε ο κανονικός συγχρονισμός να μη δημιουργεί ούτε να ενημερώνει τη σελίδα, και δημιουργήστε την μία φορά με το Blockstudio\Pages::force_sync('blog'). Έπειτα, ο πελάτης έχει πλήρη κυριότητα της σελίδας.

JSON
{
  "name": "blog",
  "title": "Blog",
  "sync": false
}
HTML
<h1>Our Blog</h1>
<p>Welcome to our blog. Start writing!</p>

Το wp bs pages sync παραλείπει αυτή τη σελίδα, ώστε το force_sync() να τη δημιουργήσει μία φορά. Έπειτα, ο πελάτης μπορεί ελεύθερα να προσθέτει, να αφαιρεί και να αναδιατάσσει μπλοκ. Οι αλλαγές στο πρότυπο αγνοούνται.

Συνδέσεις μπλοκ

Μια εναλλακτική στη συγχώνευση με κλειδιά είναι η χρήση των Συνδέσεων μπλοκ API του πυρήνα του WordPress, για τη σύνδεση μπλοκ με μεταδεδομένα αναρτήσεων. Αυτή η δυνατότητα δεν προέρχεται από το Blockstudio· είναι εγγενής δυνατότητα του WordPress API. Το Blockstudio απλώς περνά το χαρακτηριστικό metadata στη δημιουργημένη σήμανση του μπλοκ. Το περιεχόμενο αποθηκεύεται στα μεταδεδομένα της ανάρτησης αντί στη σήμανση του μπλοκ, επομένως οι συγχρονισμοί προτύπων μπορούν να αντικαθιστούν ελεύθερα τη σήμανση, καθώς ο επεξεργαστής διαβάζει τα μεταδεδομένα και όχι το innerHTML.

Περάστε το χαρακτηριστικό metadata σε οποιοδήποτε στοιχείο HTML ή <block>:

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 text.
</p>

<img
  metadata='{"bindings":{"url":{"source":"core/post-meta","args":{"key":"hero_image"}},"alt":{"source":"core/post-meta","args":{"key":"hero_image_alt"}}}}'
/>

Τα κλειδιά μεταδεδομένων πρέπει να έχουν καταχωριστεί με ενεργοποιημένο το show_in_rest:

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

Κλειδιά και συνδέσεις

Πτυχή Κλειδιά Συνδέσεις
Αποθήκευση περιεχομένου Σήμανση μπλοκ (post_content) Μεταδεδομένα ανάρτησης (wp_postmeta)
Διατηρείται μετά τον συγχρονισμό προτύπου Ναι (συγχωνεύεται βάσει κλειδιού) Ναι (τα δεδομένα βρίσκονται στα μεταδεδομένα)
Υποβάλλεται σε ερωτήματα μέσω WP_Query Όχι Ναι (meta_query)
Διαθέσιμο στο REST API Όχι Ναι
Απαιτεί καταχώριση Όχι Ναι (register_post_meta)
Ο χρήστης μπορεί να μετακινήσει μπλοκ Όχι (το πρότυπο επιβάλλει ξανά τη δομή) Όχι (το πρότυπο επιβάλλει ξανά τη δομή)

Μπορείτε να χρησιμοποιήσετε και τις δύο προσεγγίσεις στο ίδιο πρότυπο. Χρησιμοποιήστε κλειδιά για ενότητες όπου έχει σημασία η δομή των μπλοκ (e.g., μια ομάδα με πολλά παιδιά). Χρησιμοποιήστε συνδέσεις για μεμονωμένα πεδία, όταν θέλετε επίσης τα δεδομένα να είναι προσβάσιμα εκτός του επεξεργαστή μπλοκ.

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

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

JSON
{
  "name": "product-template",
  "title": "Product Template",
  "templateFor": "product",
  "templateLock": "insert"
}

Όλες οι νέες αναρτήσεις αυτού του τύπου θα ξεκινούν με την καθορισμένη δομή μπλοκ.

Προσαρμοσμένες διαδρομές

Από προεπιλογή, το Blockstudio σαρώνει το get_template_directory() . '/pages'. Προσθέστε επιπλέον διαδρομές με το φίλτρο:

PHP
add_filter( 'blockstudio/pages/paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/custom-pages';
    $paths[] = MY_PLUGIN_DIR . '/pages';
    return $paths;
} );

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

Φίλτρα και ενέργειες

Ο εντοπισμός σελίδων, ο συγχρονισμός και η δρομολόγηση συλλογών παρέχουν τα εξής σημεία επέκτασης:

Άγκιστρο Τύπος Περιγραφή
blockstudio/pages/paths Φίλτρο Προσθήκη καταλόγων στους οποίους το Blockstudio αναζητά πηγές σελίδων.
blockstudio/pages/collection_post_type_args Φίλτρο Προσαρμογή των ορισμάτων register_post_type() για ένα CPT συλλογής.
blockstudio/pages/template_candidates Φίλτρο Προσαρμογή των ονομάτων αρχείων προτύπων που λαμβάνονται υπόψη για μια πηγή σελίδας.
blockstudio/pages/serve_markdown Φίλτρο Ενεργοποίηση ή απενεργοποίηση των ακατέργαστων αποκρίσεων Markdown.
blockstudio/pages/orphan_action Φίλτρο Επιστροφή trash, delete ή keep για τον καθαρισμό ορφανών στοιχείων.
blockstudio/pages/docs_allowed_html Φίλτρο Προσαρμογή των επιτρεπόμενων HTML για το περιεχόμενο τεκμηρίωσης που δημιουργείται από το Markdown.
blockstudio/pages/allow_external_loader_path Φίλτρο Επιτρέπει στο πρόγραμμα φόρτωσης paths να βρίσκεται εκτός της ρίζας της συλλογής.
blockstudio/pages/manifest_scan_interval Φίλτρο Ορισμός της μέγιστης ηλικίας μιας παλιάς προσωρινής μνήμης manifest, πριν από το 7.6.2, η οποία μπορεί να τροφοδοτήσει τη μόνιμη διαμόρφωση χρόνου εκτέλεσης κατά την αναβάθμιση.
blockstudio/pages/create_post_data Φίλτρο Τροποποίηση των δεδομένων ανάρτησης πριν από τη δημιουργία μιας συγχρονισμένης σελίδας.
blockstudio/pages/update_post_data Φίλτρο Τροποποίηση των δεδομένων ανάρτησης πριν από την ενημέρωση μιας συγχρονισμένης σελίδας.
blockstudio/pages/sync_engine_inputs Φίλτρο Προσθήκη έκδοσης αναλυτή, αντιστοίχισης ή μετεγκατάστασης που πρέπει σκόπιμα να διευρύνει τη συμφιλίωση μία φορά.
blockstudio/pages/post_created Ενέργεια Εκτελείται μετά τη δημιουργία μιας συγχρονισμένης ανάρτησης σελίδας.
blockstudio/pages/post_updated Ενέργεια Εκτελείται μετά την ενημέρωση μιας συγχρονισμένης ανάρτησης σελίδας.
blockstudio/pages/synced Ενέργεια Εκτελείται όταν ολοκληρωθεί ο συγχρονισμός του μητρώου σελίδων.
blockstudio/pages/reconciled Ενέργεια Εκτελείται μετά από ρητή συμφιλίωση, μαζί με την αναγνώσιμη από μηχανές αναφορά της.
blockstudio/pages/renderers Ενέργεια Καταχωρίζει αποδοτές σελίδων με το Blockstudio\Page_Renderers::register(). Εκτελείται μία φορά ανά αίτημα.
blockstudio/pages/rendered Ενέργεια Εκτελείται μετά την απόδοση μιας σελίδας στοιχείου, μαζί με τη σελίδα, το HTML της και τις εξαρτήσεις της.
blockstudio/pages/layout_error Ενέργεια Εκτελείται όταν δεν είναι δυνατή η απόδοση μιας διάταξης, μαζί με το σφάλμα, τη διαδρομή της διάταξης και τη σελίδα.

PHP API

PHP
// Get all registered pages.
$pages = Blockstudio\Pages::pages();

// Get pages from one collection.
$docs = Blockstudio\Pages::pages('docs');

// Get the pages of one collection, sorted (same result as pages('docs')).
$docs = Blockstudio\Pages::in_collection('docs');

// Get a nested page tree.
$tree = Blockstudio\Pages::tree('docs');

// Get direct children for a page.
$children = Blockstudio\Pages::children('docs-guide', 'docs');

// Get collection metadata.
$collection = Blockstudio\Pages::collection('docs');

// Get a specific page.
$page = Blockstudio\Pages::get_page('about');

// Get the WordPress post ID for a page.
$postId = Blockstudio\Pages::get_post_id('about');

// Force sync a page explicitly (ignores fingerprints, locks, and sync: false).
Blockstudio\Pages::force_sync('about');

// Force sync all discovered pages explicitly.
Blockstudio\Pages::force_sync_all();

// Reconcile a complete deployment inventory without rewriting equal pages.
$report = Blockstudio\Pages::reconcile([
  'authoritative' => true,
  'plan_valid' => true,
  'source' => [
    'commit' => $commit,
    'dirtyHash' => $dirtyHash,
  ],
]);

// Store this only after the matching static artifact and routes verify.
Blockstudio\Pages::store_successful_source_identity($report['sourceIdentity']);

// Lock a page against non-authoritative reconciliation.
Blockstudio\Pages::lock('about');

// Unlock a page.
Blockstudio\Pages::unlock('about');

// Register a page renderer (inside the blockstudio/pages/renderers action).
Blockstudio\Page_Renderers::register('react', [
  'extensions' => ['tsx'],
  'layouts' => ['layout.tsx'],
  'render' => 'my_theme_render_page',
]);

// Find the renderer of an entry file.
$renderer = Blockstudio\Page_Renderers::for_entry('page.tsx');

// Register assets for rendered output and print the returned marker with it.
$marker = Blockstudio\Assets::register_owner('page-home', [$scriptPath]);

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

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

PHP
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();

Οι πίνακες σελίδων που επιστρέφονται από τα Blockstudio\Pages::pages(), Blockstudio\Pages::tree(), Blockstudio\Pages::children() και τις καθολικές βοηθητικές συναρτήσεις περιλαμβάνουν την ταυτότητα της συγχρονισμένης ανάρτησης, τις διαδρομές πηγής και προτύπου, τα μεταδεδομένα συλλογής και διαδρομής, τον τύπο περιεχομένου, την πολιτική συγχρονισμού, τον τύπο και την κατάσταση ανάρτησης, την πολιτική επεξεργασίας, τα προσαρμοσμένα μεταδεδομένα και ένα κλειδί permalink. Τα μεταδεδομένα συλλογής φορτώνονται από την τελευταία επιτυχημένη ρητή συμφιλίωση. Τα κανονικά αιτήματα ανακατασκευάζουν αυτά τα δεδομένα χρόνου εκτέλεσης από τη διατηρούμενη διαμόρφωση και τα συγχρονισμένα μεταδεδομένα ανάρτησης, χωρίς να διαβάζουν τα δέντρα πηγών σελίδων. Η κλάση Pages δεν παρέχει ξεχωριστή μέθοδο μόνιμου συνδέσμου.

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

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