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

Dennis · 21 Ιουνίου 2026

Blockstudio 7.4

Η έκδοση Blockstudio 7.4 εστιάζει στο να κάνει τα έργα που βασίζονται σε αρχεία πιο φορητά. Η 7.2 διευκόλυνε την επιθεώρηση και τη διανομή μεγαλύτερων έργων, ενώ η 7.3 πρόσθεσε ένα επίπεδο UI από πάνω. Η 7.4 εστιάζει στη μεταφορά περισσότερων στοιχείων ενός έργου —των σελίδων και του επιμελημένου περιεχομένου του— από τη βάση δεδομένων σε αρχεία που ελέγχονται με version control.

Η σημαντικότερη δυνατότητα είναι οι συλλογές σελίδων: ένας τρόπος να υποδείξετε στο Blockstudio έναν φάκελο με πηγές σελίδων και να δημιουργήσετε από αυτόν μια πλήρη ένθετη δομή σελίδων WordPress. Η πηγή μπορεί να είναι PHP, Twig, Blade, HTML, Markdown ή ένας έμπιστος loader που επιστρέφει σελίδες από άλλη τοπική πηγή.

Εν συντομία:

  • Συλλογές σελίδων: το pages.json μπορεί να ορίσει ένα πλήρες σύνολο ένθετων σελίδων, προεπιλογές, συμπεριφορά τύπου ανάρτησης, διατάξεις, loaders και μεταδεδομένα συλλογής.
  • Σελίδες Markdown: το index.md λειτουργεί ως περιεχόμενο σελίδας, είτε με page.json είτε μόνο του με frontmatter.
  • Διατάξεις σελίδων διεπαφής: το layout.php μπορεί να περιβάλλει συγχρονισμένο περιεχόμενο σελίδας και να χρησιμοποιεί βοηθητικά στοιχεία όπως τα blockstudio_page_tree() και blockstudio_page_content().
  • Εξωτερικές πηγές τεκμηρίωσης: οι loaders συλλογών μπορούν να δημιουργούν σελίδες από τοπικά αρχεία ή από επιστρεφόμενα Markdown/HTML.
  • Ακατέργαστη έξοδος Markdown: οι πηγές σελίδων Markdown μπορούν να σερβιριστούν ως .md ή μέσω του Accept: text/markdown.
  • Προσαρμοσμένοι τύποι αναρτήσεων συλλογών: οι συλλογές μπορούν να έχουν καθαρά URL, αυτόματη εκκαθάριση κανόνων επανεγγραφής, ακατέργαστες διαδρομές Markdown και μετατροπές σελίδων σε CPT χωρίς παρακάμψεις στο θέμα.
  • Content Sync: τα wp bs content pull, wp bs content push και wp bs content status μεταφέρουν επιτρεπόμενες αναρτήσεις, όρους, σχέσεις και δηλωμένες αναφορές μεταδεδομένων του έργου σε φορητά αρχεία.
  • Προθέματα ετικετών μπλοκ: τα προθέματα έργου όπως το <theme-card> μπορούν να επιλύονται σε ταξινομημένα namespaces χωρίς ψευδώνυμα ανά μπλοκ.
  • Αξιοπιστία συγχρονισμού: οι αλλαγές σελίδων εντοπίζονται σε manifests, loaders, διατάξεις, μεταδεδομένα και αρχεία πηγής.
  • Διορθώσεις χρόνου εκτέλεσης και επεξεργαστή: οι δυναμικές επιλογές παραμένουν ενημερωμένες, οι κλάσεις query block διατηρούνται στην προγραμματική απόδοση, το bsui/select λειτουργεί καλύτερα σε πυκνές φόρμες, οι ιδιότητες RichText φτάνουν στον επεξεργαστή και η διαγραφή γραμμών repeater με RichText διατηρείται μετά την αποθήκευση.

Σελίδες που βασίζονται σε αρχεία

Το μεγαλύτερο μέρος της έκδοσης 7.4 βασίζεται σε σελίδες που βασίζονται σε αρχεία.

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

Πριν από την 7.4, οι σελίδες που βασίζονταν σε αρχεία ήταν κυρίως μια δυνατότητα σε επίπεδο φακέλου: δημιουργούσατε ένα page.json, προσθέτατε ένα index.php ή index.twig και το Blockstudio συγχρόνιζε αυτή τη μοναδική σελίδα στο WordPress.

Αυτό εξακολουθεί να λειτουργεί. Η 7.4 προσθέτει μια δεύτερη λειτουργία για μεγαλύτερες δομές.

Προσθέστε ένα manifest pages.json σε έναν φάκελο και αυτός μετατρέπεται σε συλλογή:

Text
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
JSON
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "postTypeArgs": {
    "label": "Docs",
    "rewrite": {
      "slug": "docs"
    },
    "supports": ["title", "editor", "page-attributes"]
  },
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}

Κάθε πηγή σελίδας μέσα στη συλλογή εντοπίζεται, κανονικοποιείται, συγχρονίζεται και συνδέεται βάσει διαδρομής. Μια σελίδα στο guide/install γίνεται θυγατρική του guide· αν λείπει η σελίδα guide, το Blockstudio δημιουργεί μια σελίδα container, ώστε η ιεραρχία του WordPress να εξακολουθεί να αντιστοιχεί στη δομή του συστήματος αρχείων.

Οι συλλογές μπορούν να χρησιμοποιούν τον εγγενή τύπο ανάρτησης page ή τον δικό τους. Όταν μια συλλογή δηλώνει έναν τύπο ανάρτησης που δεν υπάρχει ακόμη, το Blockstudio τον καταχωρίζει από το postTypeArgs. Το manifest postType γίνεται επίσης η προεπιλογή για κάθε σελίδα της συλλογής, ώστε τα έργα να μην χρειάζεται να το επαναλαμβάνουν στο defaults.

Οι τύποι αναρτήσεων συλλογών χρησιμοποιούν το slug της συλλογής ως δημόσια βάση URL. Μια συλλογή docs επιλύει τη ριζική σελίδα της στο /docs/, μια σελίδα με path: "getting-started" στο /docs/getting-started/ και τις ένθετες διαδρομές κάτω από την ίδια βάση. Διπλά URL όπως το /docs/docs/ ανακατευθύνονται στην κανονική τοποθεσία. Οι κανόνες επανεγγραφής εκκαθαρίζονται αυτόματα όταν αλλάζει η δρομολόγηση τύπων αναρτήσεων συλλογών, οπότε μια νέα συλλογή δεν απαιτεί χειροκίνητη αποθήκευση των μόνιμων συνδέσμων.

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

Το Markdown ως περιεχόμενο σελίδας

Το Markdown είναι πλέον πλήρης πηγή σελίδων.

Οι αυτόνομες σελίδες Markdown χρησιμοποιούν frontmatter:

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

# About

This Markdown content is synced as native WordPress blocks.

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

Το Markdown μετατρέπεται σε HTML και έπειτα περνά από τον ίδιο parser σελίδων με τα πρότυπα PHP, Twig και Blade, ώστε το τελικό περιεχόμενο να είναι εγγενές markup μπλοκ.

Διατάξεις και βοηθητικά στοιχεία σελίδων

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

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

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

Τα νέα βοηθητικά στοιχεία εκθέτουν τη συλλογή ως δομημένα δεδομένα:

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

Έτσι έχετε τα απαραίτητα στοιχεία για να δημιουργήσετε ένα πλήρες πλαίσιο τεκμηρίωσης: πλοήγηση από το δέντρο σελίδων, μεταδεδομένα σελίδων από το frontmatter και το συγχρονισμένο περιεχόμενο μπλοκ WordPress ως κύρια περιοχή περιεχομένου.

Loaders και ακατέργαστο Markdown

Οι συλλογές μπορούν να περιλαμβάνουν ένα έμπιστο τοπικό αρχείο loader.php. Μπορεί να επιστρέφει απευθείας σελίδες ή να υποδεικνύει στο Blockstudio πρόσθετους τοπικούς καταλόγους για εντοπισμό.

PHP
<?php

return [
  'pages' => [
    [
      'name' => 'docs-api',
      'title' => 'API',
      'path' => 'api',
      'content' => "# API\n\nGenerated markdown content.",
      'contentType' => 'markdown',
    ],
  ],
];

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

Οι πηγές σελίδων Markdown μπορούν επίσης να σερβίρουν την ακατέργαστη πηγή Markdown. Ζητήστε τη σελίδα με κατάληξη .md ή στείλτε Accept: text/markdown. Το frontmatter αφαιρείται από την απόκριση, ώστε τα εργαλεία να λαμβάνουν το ευανάγνωστο σώμα του εγγράφου. Αυτό λειτουργεί και για τύπους αναρτήσεων συλλογών, συμπεριλαμβανομένων URL όπως τα /docs.md και /docs/getting-started.md.

Διαβάστε την τεκμηρίωση Pages

Συγχρονισμός περιεχομένου

Η 7.4 εισάγει επίσης το Content Sync, μια ροή εργασίας WP-CLI για ομάδες που θέλουν να αναπαρίσταται περισσότερο μέρος του έργου τους WordPress ως αρχεία.

Κέλυφος
wp bs content pull
wp bs content push --dry-run
wp bs content status

Το Blockstudio διατηρεί ήδη στο έργο σας μπλοκ, πεδία, πρότυπα, μοτίβα και σελίδες που βασίζονται σε αρχεία. Το Content Sync προσθέτει επιλεγμένο περιεχόμενο βάσης δεδομένων σε αυτή τη ροή εργασίας με προτεραιότητα στα αρχεία: επιτρεπόμενες αναρτήσεις, όροι, σχέσεις και δηλωμένα μεταδεδομένα μπορούν να εξαχθούν σε αρχεία, να ελεγχθούν στο git και να προωθηθούν σε άλλο περιβάλλον.

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

Κατά την εξαγωγή, το Blockstudio γράφει φορητές αναρτήσεις, όρους, σχέσεις και επιτρεπόμενα μεταδεδομένα σε αρχεία του θέματος. Κατά την εισαγωγή, επικυρώνει το σχέδιο πριν από την εγγραφή και επιλύει τις δηλωμένες αναφορές post, term και attachment σε τοπικά ID βάσης δεδομένων. Δεν υποθέτει ότι αυθαίρετοι ακέραιοι είναι ID.

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

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

Διαβάστε την τεκμηρίωση Content Sync

Πιο αξιόπιστος συγχρονισμός

Το Blockstudio εντοπίζει πλέον αλλαγές στις πηγές σελίδων, στα manifests συλλογών, στα αρχεία loader και διάταξης, στα μεταδεδομένα και στις σχετικές διαδρομές. Αν αλλάξει κάποιο από αυτά, ενημερώνεται η συγχρονισμένη σελίδα WordPress.

Η ροή σελίδων χειρίζεται επίσης τις λεπτομέρειες που κάνουν πρακτική την τεκμηρίωση βάσει αρχείων σε πραγματικά έργα:

  • Οι πηγές σελίδων Markdown συγχρονίζονται ως εγγενές περιεχόμενο μπλοκ, μαζί με τα χαρακτηριστικά των μπλοκ
  • Τα μεταδεδομένα frontmatter είναι διαθέσιμα στα βοηθητικά στοιχεία και στις διατάξεις της διεπαφής
  • Οι σελίδες συλλογών διατηρούν σταθερή ταυτότητα μεταξύ συγχρονισμών
  • Οι ένθετες σελίδες εκτός συλλογών συνδέονται με τη γονική τους σελίδα
  • Οι ένθετες σελίδες εκτός συλλογών μπορούν να κληρονομούν το πλησιέστερο layout.php προγόνου
  • Οι πηγές συλλογών που αφαιρούνται καθαρίζουν τις σελίδες WordPress που δημιουργήθηκαν
  • Η αλλαγή μιας συλλογής από page σε προσαρμοσμένο τύπο ανάρτησης μεταφέρει τις υπάρχουσες συγχρονισμένες αναρτήσεις αντί να δημιουργεί διπλότυπα
  • Η σειρά των σελίδων διατηρείται μέσω του menu_order

Προθέματα ετικετών μπλοκ

Οι ετικέτες μπλοκ υποστηρίζουν πλέον διαμορφώσιμα προθέματα namespace. Ένα έργο μπορεί να καταχωρίσει ένα σύντομο πρόθεμα και να αφήσει το Blockstudio να επιλύσει το μπλοκ σε ένα ή περισσότερα namespaces:

PHP
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
  $prefixes['theme'] = ['theme-components', 'bsui'];

  return $prefixes;
});

Με αυτή τη ρύθμιση, το <theme-card> μπορεί να επιλυθεί σε theme-components/card, το <theme-button> μπορεί να καταφύγει στο bsui/button και το <theme-ui-feature-matrix> μπορεί να επιλυθεί σε theme-components/ui-feature-matrix.

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

Διαβάστε την τεκμηρίωση Block Tags

Διορθώσεις χρόνου εκτέλεσης και επεξεργαστή

Η 7.4 περιλαμβάνει επίσης διορθώσεις που προέκυψαν από τη χρήση σε πραγματικά έργα.

  • Οι επιλογές που συμπληρώνονται δυναμικά από ερωτήματα παραμένουν ενημερωμένες όταν αλλάζουν αναρτήσεις, όροι, χρήστες ή σχετικά μεταδεδομένα, ενώ οι επιλογείς ερωτημάτων populate.fetch: true ανακτούν ζωντανές επιλογές για κενές αναζητήσεις στον επεξεργαστή.
  • Οι ετικέτες μπλοκ core/query και core/comments που δημιουργούνται προγραμματιστικά διατηρούν το className στο παραγόμενο markup περιτυλίγματος.
  • Τα ψευδοστοιχεία προτύπων διατηρούν τις ιδιότητες camelCase, ώστε ιδιότητες όπως τα allowedFormats και withoutInteractiveFormatting να φτάνουν στο στοιχείο του επεξεργαστή αντί να απορρίπτονται νωρίτερα.
  • Το bsui/select χειρίζεται πιο αξιόπιστα τα δεδομένα επιλογών και τα μενού που ξεπερνούν τα όριά τους, ιδίως μέσα σε πιο πυκνά στοιχεία ελέγχου του επεξεργαστή.
  • Το blockstudio/phpstan αναγνωρίζει πεδία που δηλώνονται μέσα σε container tabs, ώστε η επικύρωση προτύπων, Twig/Blade και ετικετών μπλοκ να κατανοεί την ίδια μορφή πεδίων που χρησιμοποιεί το Blockstudio στα έργα.
  • Η διαγραφή γραμμής repeater με RichText διατηρείται μετά την αποθήκευση. Οι παλιές τιμές RichText δεν μπορούν πλέον να επαναφέρουν τη διαγραμμένη γραμμή.

Γιατί έχει σημασία αυτή η έκδοση

Το θέμα της έκδοσης 7.4 είναι η φορητότητα.

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

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