Πλήρεις σελίδες, ορισμένες στον κώδικα
Πρότυπα και Markdown, συγχρονισμένα με το WordPress με μία εντολή.
Συλλογές από αρχεία
Ορίστε το pages.json και αφήστε το Blockstudio να εντοπίσει κάθε πηγή από κάτω. Οι ένθετες διαδρομές γίνονται ένθετες σελίδες, οι προεπιλογές εφαρμόζονται σε όλη τη συλλογή και μπορούν να δημιουργηθούν γονικές σελίδες που λείπουν.
Χρησιμοποιήστε συλλογές για τεκμηρίωση, βάσεις γνώσεων ή σελίδες προορισμού και προσαρτήστε εξωτερικούς φακέλους κάτω από ένα πρόθεμα διαδρομής με το loader.php.
Τοποθετήστε ένα layout.php ή μια διάταξη renderer, όπως το layout.tsx, δίπλα στο pages.json για να τυλίξετε κάθε σελίδα της συλλογής σε ένα ενιαίο πλαίσιο, με το blockstudio_page_tree() για την πλαϊνή γραμμή.
{
"collection": "docs",
"title": "Documentation",
"postType": "bs_docs",
"defaults": {
"postStatus": "publish",
"templateLock": "contentOnly"
}
}---
title: Installation
order: 10
---
# Installation
Install Blockstudio from this Markdown page.<?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>Ρητός συγχρονισμός
Η εντολή wp bs pages sync εφαρμόζει τις αλλαγές· οι αμετάβλητες σελίδες δεν απαιτούν καμία εγγραφή.
Πηγές Markdown
Χρησιμοποιήστε το index.md με frontmatter ή συνδυάστε το περιεχόμενο page.json με το Markdown.
Ακατέργαστο Markdown
Οι σελίδες αρχείων Markdown είναι διαθέσιμες στη διαδρομή τους URL συν .md ή στην κανονική διαδρομή URL για Accept: text/markdown, με canonical σύνδεσμο πίσω στο HTML.
Φορτωτές συλλογών
Προσαρτήστε φακέλους εξωτερικής τεκμηρίωσης σε μια συλλογή κάτω από ένα πρόθεμα διαδρομής.
Συλλογές ιστότοπου
Ένα pages.json με scope site εφαρμόζει κοινές προεπιλεγμένες ρυθμίσεις σε ολόκληρο το δέντρο σελίδων και το παραθέτει, χωρίς να αλλάζει τα URL ή τις σειρές αναρτήσεων.
Βοηθήματα πλοήγησης
Τα blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() και blockstudio_page_content() δημιουργούν πλαϊνές γραμμές, σελιδοποιητές και το κύριο σώμα.
Συλλογές και τύποι αναρτήσεων
Οι συλλογές μπορούν να καταχωρίζουν αποκλειστικούς ιεραρχικούς τύπους αναρτήσεων.
Κλείδωμα προτύπου
Κλειδώστε σελίδες ή μεμονωμένα block με contentOnly, all ή insert.
Γράψτε HTML, δημιουργήστε blocks
Τυπικά στοιχεία όπως τα <h1>, <p> και <ul> αντιστοιχίζονται σε βασικά block. Χρησιμοποιήστε το <block> για κάθε άλλο όνομα block και επίπεδο ένθεσης.
Το Blockstudio αναλύει πλήρεις διατάξεις σελίδων και τις μετατρέπει σε πραγματικά, επεξεργάσιμα block WordPress.
<div>
<h1 blockEditingMode="contentOnly">About Us</h1>
<p>We build tools for WordPress developers.</p>
<img src="/team.jpg" alt="Our team" />
</div>
<block name="core/columns">
<block name="core/column"><h2>Our Mission</h2></block>
<block name="core/column"><h2>Our Stack</h2></block>
</block>Σελίδες που αποδίδονται από components
Ορίστε το render στο page.json σε μια καταχώριση όπως το page.tsx και σε έναν loader data.php, και ο renderer σελίδων που καταχωρίζει το θέμα ή το plugin σας αποδίδει ολόκληρη τη σελίδα. Το Sync αποθηκεύει ένα block blockstudio/page, ενώ περιεχόμενο WordPress, όπως ένα shortcode, παραμένει στη θέση του.
Τα assets που επιστρέφει ο renderer υποβάλλονται στην ίδια επεξεργασία με τα assets των block και εκτυπώνονται μία φορά, ώστε μια prerendered σελίδα να τα περιλαμβάνει. Το blockstudio.dev αποτελείται από σελίδες components.
{
"name": "legal-notice",
"title": "Legal Notice",
"slug": "legal-notice",
"postStatus": "publish",
"render": { "entry": "page.tsx", "data": "data.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',
)
);
}
);Διαδρομές χωρίς ανάρτηση
Το Blockstudio\Virtual_Routes::register() εξυπηρετεί ένα έγγραφο χωρίς αντίστοιχη ανάρτηση, όπως μια αναφορά component ή έναν κατάλογο. Με τα prefix και match, μία καταχώριση καλύπτει μια ολόκληρη οικογένεια URL, ενώ επιστρέφοντας null αφήνετε το URL στο WordPress.
Η διαδρομή αποδίδεται στο buffer εξόδου του Blockstudio, ώστε τα block της να αποκτούν τα assets τους και έξοδο Tailwind. Οι διαδρομές στο urls συμμετέχουν σε builds στατικής prerendering, ενώ το Virtual_Routes::urls() τις επιστρέφει για sitemap.
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(),
]
);
} );Συγχρονισμός όταν το επιλέξετε
Τα αρχεία σελίδων αλλάζουν WordPress μόνο όταν το ζητήσετε. Το wp bs pages sync εφαρμόζει κάθε αλλαγμένη πηγή, διατηρεί το περιεχόμενο του επεξεργαστή με κλειδί και διαγράφει σελίδες των οποίων τα αρχεία δεν υπάρχουν πια.
Τα αποτυπώματα καλύπτουν δηλωτικά αρχεία, φορτωτές, διατάξεις και πηγές, οπότε οι αμετάβλητες σελίδες δεν απαιτούν καμία εγγραφή. Οι αναπτύξεις καλούν το Pages::reconcile() και λαμβάνουν μια αναφορά αναγνώσιμη από μηχανές.
# Apply changed sources, keep keyed edits
wp bs pages sync
# Replace managed content from the files
wp bs pages sync --authoritative
# Compare every page and report as JSON
wp bs pages sync --full --format=json$report = Blockstudio\Pages::reconcile();
if (0 === $report['failed']) {
// Once the release is live and verified:
Blockstudio\Pages::store_successful_source_identity(
$report['sourceIdentity']
);
}Τα block με κλειδί διατηρούν το περιεχόμενο
Προσθέστε το key σε οποιοδήποτε block. Στον επόμενο συγχρονισμό, τα block με κλειδί συνδυάζουν τα γνωρίσματα του προτύπου με το υπάρχον περιεχόμενο χρήστη, ενώ τα block χωρίς κλειδί αντικαθίστανται.
Εξελίξτε τη δομή στις αναπτύξεις, διατηρώντας ανέπαφο το περιεχόμενο των πελατών.
<h1 key="title">About Us</h1>
<block name="core/cover" key="hero" url="/hero.jpg">
<h2>Welcome to our company</h2>
<p>Edit this content freely.</p>
</block>
<block name="core/columns" key="team">
<block name="core/column"><h3>Our Team</h3></block>
</block>{
"name": "about",
"title": "About Us",
"slug": "about",
"templateLock": "contentOnly"
}Κλείδωμα προτύπων και λειτουργίες επεξεργασίας
Το "all" αποτρέπει τις αλλαγές, το "contentOnly" κλειδώνει τη δομή επιτρέποντας επεξεργασία κειμένου και το "insert" επιτρέπει την επεξεργασία και αναδιάταξη χωρίς προσθήκη ή αφαίρεση.
Παρακάμψτε οποιοδήποτε στοιχείο με το blockEditingMode, για να κάνετε επιλεκτικά επεξεργάσιμη μια κλειδωμένη σελίδα ή να απενεργοποιήσετε ένα μεμονωμένο block.
<h1>Welcome to Our Product</h1>
<p>The best solution for your needs.</p>
<block name="core/cover" blockEditingMode="disabled" url="/static-banner.jpg">
<p>Promotional banner</p>
</block>
<block name="core/group" blockEditingMode="default">
<h2>Customizable Section</h2>
</block>{
"name": "landing",
"title": "Landing Page",
"slug": "landing",
"templateLock": "contentOnly",
"blockEditingMode": "contentOnly"
}Πρότυπα Site Editor από αρχεία
Προσθέστε το template.json και ένα πρότυπο στο templates/ ή το part.json στο parts/, και το θέμα block σας θα αποκτήσει πηγές wp_template και wp_template_part που βασίζονται σε αρχεία.
Χρησιμοποιούν την ίδια σύνταξη με τις σελίδες. Μια προσαρμογή στο Site Editor εξακολουθεί να υπερισχύει μέχρι να την επαναφέρει κάποιος· τότε επανέρχεται η πηγή του αρχείου.
<block name="core/template-part" slug="header" />
<div>
<h1>Welcome</h1>
<block name="core/post-content" />
</div>
<block name="core/template-part" slug="footer" />{
"slug": "front-page",
"title": "Front Page",
"description": "Homepage template"
}{
"slug": "header",
"title": "Header",
"area": "header"
}Επιλεγμένο περιεχόμενο βάσης δεδομένων στο git
Το wp bs content pull εξάγει επιτρεπόμενες αναρτήσεις, όρους, σχέσεις και δηλωμένα μεταδεδομένα σε φορητά αρχεία, ενώ το push τα εφαρμόζει σε άλλο περιβάλλον. Οι δηλωμένες αναφορές, οι γονικές σχέσεις και οι σχέσεις όρων μεταφέρονται ως σταθερά UID.
Οι αναρτήσεις που διαχειρίζεται ο συγχρονισμός σελίδων μπορούν να συνδυαστούν με το includePageSyncManaged. Τα αρχεία τους περιέχουν "bodyOwner": "page-sync", ώστε το Content Sync να μεταφέρει τα μεταδεδομένα, ενώ ο συγχρονισμός σελίδων διατηρεί το σώμα.
{
"content": {
"enabled": true,
"id": "default",
"path": "content",
"postTypes": ["team_member"],
"taxonomies": ["category"],
"meta": {
"include": ["_my_*"],
"references": {
"_thumbnail_id": { "kind": "attachment" },
"_related_posts": { "kind": "post", "path": "*" }
}
},
"media": "manifest"
}
}wp bs content pull --dry-run
wp bs content pull
wp bs content status
wp bs content push --dry-run
wp bs content push --prune --yesΜπλοκ με κλειδιά
Διατηρήστε το περιεχόμενο των χρηστών καθώς εξελίσσονται τα πρότυπα.
Λειτουργίες επεξεργασίας
Ορίστε προεπιλογές σελίδων και παρακάμψτε μεμονωμένα στοιχεία.
Συνδέσεις block
Συνδέστε block με τα μεταδεδομένα αναρτήσεων, ώστε το περιεχόμενο να διατηρείται στον συγχρονισμό.
Πρότυπα τύπων ανάρτησης
Το templateFor ορίζει μια σελίδα ως αρχική δομή block για κάθε νέα ανάρτηση ενός τύπου.
Καρφιτσωμένα ID αναρτήσεων
Το postId ανακτά το ίδιο ID όταν μια σελίδα διαγράφεται και συγχρονίζεται ξανά, ώστε τα μενού και οι σύνδεσμοι να εξακολουθούν να λειτουργούν.
Σκελετοί και κλειδώματα
Το sync: false μαζί με το Pages::force_sync() δημιουργεί μία φορά μια σελίδα που ανήκει στους editors. Τα Pages::lock() και unlock() εξαιρούν μία σελίδα από τον συγχρονισμό.
Προσαρμοσμένοι renderers parser
Τα φίλτρα builder και renderer μετατρέπουν μια ετικέτα block στον πίνακα block ενός block τρίτου μέρους ή αλλάζουν τον τρόπο εγγραφής ενός core block.
Αντιστοίχιση στοιχείων
Αντιστοιχίστε ένα στοιχείο HTML σε άλλο block, επιλέξτε το block από τα χαρακτηριστικά του στοιχείου και δρομολογήστε την παράγραφο HTML σε ένα πεδίο περιεχομένου.
Προσαρμοσμένες διαδρομές ανακάλυψης
Τα φίλτρα προσθέτουν ρίζες για σελίδες, μοτίβα και πρότυπα του Site Editor, για παράδειγμα από ένα plugin.
Λογικές πηγές ανακάλυψης
Οι προεπισκοπήσεις, οι επικαλύψεις και τα δημιουργημένα θέματα μπορούν να παρέχουν στο Blockstudio έναν συνδυασμένο κατάλογο αρχείων αντί για έναν φάκελο θέματος.
Σταθερές αναφορές
Οι δηλωμένες αναφορές σε αναρτήσεις, όρους και συνημμένα γίνονται φορητά UID κατά το pull και αντιστοιχίζονται σε τοπικά ID κατά το push.
Κατάσταση πριν από το push
Το wp bs content status αναφέρει για κάθε οντότητα αν είναι unchanged, would-update, missing-db, conflict, locked ή orphaned, και προειδοποιεί για meta keys που μοιάζουν με μυστικά.
Επικυρωμένα push με καθορισμένο πεδίο εφαρμογής
Το Push επικυρώνει ολόκληρο το πλάνο πριν γράψει και παραλείπει τις κλειδωμένες οντότητες. Το –dry-run εμφανίζει το πλάνο, ενώ το –prune –yes αφαιρεί μόνο τις οντότητες αυτού του συνόλου περιεχομένου.
Υπό έλεγχο εκδόσεων
Παρακολουθήστε τα αρχεία σελίδων στο Git και αναπτύξτε τα σε διαφορετικά περιβάλλοντα.
PHP API
Αποκτήστε προγραμματιστική πρόσβαση σε δέντρα, θυγατρικά στοιχεία, μεταδεδομένα, συγχρονισμό, κλείδωμα και ID.
Το επίσημο κιτ επεκτάσεων
Premium πρότυπα ιστοτόπων, οδηγίες συστήματος AI και ιδιωτική κοινότητα Discord. Εφάπαξ αγορά, ενημερώσεις εφ’ όρου ζωής.
- 500+ πρότυπα ιστοτόπων
- Οδηγίες συστήματος AI
- Ενημερώσεις εφ’ όρου ζωής
- Ιδιωτική κοινότητα Discord