# Πλήρεις σελίδες, ορισμένες στον κώδικα

Πρότυπα και Markdown, συγχρονισμένα με το WordPress με μία εντολή.

## Συλλογές από αρχεία

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

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

Τοποθετήστε ένα `layout.php` ή μια διάταξη renderer, όπως το `layout.tsx`, δίπλα στο `pages.json` για να τυλίξετε κάθε σελίδα της συλλογής σε ένα ενιαίο πλαίσιο, με το `blockstudio_page_tree()` για την πλαϊνή γραμμή.

[Συλλογές σελίδων](https://blockstudio.dev/el/docs/pages-and-patterns/pages/#page-collections)

pages/docs/pages.json

```
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}
```

## Ρητός συγχρονισμός

Η εντολή 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.

[Αναφορά σύνταξης σελίδων](https://blockstudio.dev/el/docs/pages-and-patterns/pages/)

index.php

```
<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.

[Σελίδες components](https://blockstudio.dev/el/docs/pages-and-patterns/pages/#component-pages)

pages/legal-notice/page.json

```
{
  "name": "legal-notice",
  "title": "Legal Notice",
  "slug": "legal-notice",
  "postStatus": "publish",
  "render": { "entry": "page.tsx", "data": "data.php" }
}
```

## Διαδρομές χωρίς ανάρτηση

Το `Blockstudio\Virtual_Routes::register()` εξυπηρετεί ένα έγγραφο χωρίς αντίστοιχη ανάρτηση, όπως μια αναφορά component ή έναν κατάλογο. Με τα `prefix` και `match`, μία καταχώριση καλύπτει μια ολόκληρη οικογένεια URL, ενώ επιστρέφοντας `null` αφήνετε το URL στο WordPress.

Η διαδρομή αποδίδεται στο buffer εξόδου του Blockstudio, ώστε τα block της να αποκτούν τα assets τους και έξοδο Tailwind. Οι διαδρομές στο `urls` συμμετέχουν σε builds στατικής prerendering, ενώ το `Virtual_Routes::urls()` τις επιστρέφει για sitemap.

[Εικονικές διαδρομές](https://blockstudio.dev/el/docs/pages-and-patterns/pages/#virtual-routes)

functions.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(),
        ]
    );
} );
```

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

Τα αρχεία σελίδων αλλάζουν WordPress μόνο όταν το ζητήσετε. Το `wp bs pages sync` εφαρμόζει κάθε αλλαγμένη πηγή, διατηρεί το περιεχόμενο του επεξεργαστή με κλειδί και διαγράφει σελίδες των οποίων τα αρχεία δεν υπάρχουν πια.

Τα αποτυπώματα καλύπτουν δηλωτικά αρχεία, φορτωτές, διατάξεις και πηγές, οπότε οι αμετάβλητες σελίδες δεν απαιτούν καμία εγγραφή. Οι αναπτύξεις καλούν το `Pages::reconcile()` και λαμβάνουν μια αναφορά αναγνώσιμη από μηχανές.

[Συμπεριφορά συγχρονισμού](https://blockstudio.dev/el/docs/pages-and-patterns/pages/#sync-behavior)

Τερματικό

```
# 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
```

## Τα block με κλειδί διατηρούν το περιεχόμενο

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

Εξελίξτε τη δομή στις αναπτύξεις, διατηρώντας ανέπαφο το περιεχόμενο των πελατών.

[Μπλοκ με κλειδιά](https://blockstudio.dev/el/docs/pages-and-patterns/pages/#keyed-block-merging)

index.php

```
<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>
```

## Κλείδωμα προτύπων και λειτουργίες επεξεργασίας

Το `"all"` αποτρέπει τις αλλαγές, το `"contentOnly"` κλειδώνει τη δομή επιτρέποντας επεξεργασία κειμένου και το `"insert"` επιτρέπει την επεξεργασία και αναδιάταξη χωρίς προσθήκη ή αφαίρεση.

Παρακάμψτε οποιοδήποτε στοιχείο με το `blockEditingMode`, για να κάνετε επιλεκτικά επεξεργάσιμη μια κλειδωμένη σελίδα ή να απενεργοποιήσετε ένα μεμονωμένο block.

[Κλείδωμα προτύπου](https://blockstudio.dev/el/docs/pages-and-patterns/pages/#template-lock)

index.php

```
<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>
```

## Πρότυπα Site Editor από αρχεία

Προσθέστε το `template.json` και ένα πρότυπο στο `templates/` ή το `part.json` στο `parts/`, και το θέμα block σας θα αποκτήσει πηγές `wp_template` και `wp_template_part` που βασίζονται σε αρχεία.

Χρησιμοποιούν την ίδια σύνταξη με τις σελίδες. Μια προσαρμογή στο Site Editor εξακολουθεί να υπερισχύει μέχρι να την επαναφέρει κάποιος· τότε επανέρχεται η πηγή του αρχείου.

[Πρότυπα ιστότοπου](https://blockstudio.dev/el/docs/pages-and-patterns/site-templates/)

templates/front-page/index.php

```
<block name="core/template-part" slug="header" />

<div>
  <h1>Welcome</h1>
  <block name="core/post-content" />
</div>

<block name="core/template-part" slug="footer" />
```

## Επιλεγμένο περιεχόμενο βάσης δεδομένων στο git

Το `wp bs content pull` εξάγει επιτρεπόμενες αναρτήσεις, όρους, σχέσεις και δηλωμένα μεταδεδομένα σε φορητά αρχεία, ενώ το `push` τα εφαρμόζει σε άλλο περιβάλλον. Οι δηλωμένες αναφορές, οι γονικές σχέσεις και οι σχέσεις όρων μεταφέρονται ως σταθερά UID.

Οι αναρτήσεις που διαχειρίζεται ο συγχρονισμός σελίδων μπορούν να συνδυαστούν με το `includePageSyncManaged`. Τα αρχεία τους περιέχουν `"bodyOwner": "page-sync"`, ώστε το Content Sync να μεταφέρει τα μεταδεδομένα, ενώ ο συγχρονισμός σελίδων διατηρεί το σώμα.

[Συγχρονισμός περιεχομένου](https://blockstudio.dev/el/docs/content-sync/)

blockstudio.json

```
{
  "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"
  }
}
```

## Μπλοκ με κλειδιά

Διατηρήστε το περιεχόμενο των χρηστών καθώς εξελίσσονται τα πρότυπα.

## Λειτουργίες επεξεργασίας

Ορίστε προεπιλογές σελίδων και παρακάμψτε μεμονωμένα στοιχεία.

## Συνδέσεις 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.

Plus

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

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

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

[Αποκτήστε το Plus](https://blockstudio.dev/el/plus/)
