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

Πρότυπα ιστοτόπου

Τα Πρότυπα ιστοτόπου επιτρέπουν στα θέματα μπλοκ να ορίζουν WordPress wp_template και πηγές wp_template_part με την ίδια σύνταξη με προτεραιότητα στα αρχεία που χρησιμοποιείται για τις σελίδες και τα μοτίβα του Blockstudio.

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

Σελίδες, μοτίβα ή πρότυπα ιστοτόπου;

Δυνατότητα Δημιουργεί Ιδανικό για
Σελίδες Αναρτήσεις ή καταχωρίσεις προσαρμοσμένων τύπων ανάρτησης Σελίδες περιεχομένου, σελίδες τεκμηρίωσης, σελίδες προορισμού και περιεχόμενο με δική του διαδρομή.
Μοτίβα Μοτίβα μπλοκ Επαναχρησιμοποιήσιμες ενότητες που εισάγουν οι συντάκτες.
Πρότυπα ιστοτόπου Πηγές αρχείων wp_template και wp_template_part Διάταξη θέματος που ελέγχεται από το Site Editor και την ιεραρχία προτύπων του WordPress.

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

Δομή φακέλων

Τοποθετήστε τα πλήρη πρότυπα στο templates/ και τα τμήματα προτύπων στο parts/:

Text
theme/
  templates/
    front-page/
      template.json
      index.php
    single/
      template.json
      index.twig
  parts/
    header/
      part.json
      index.php
    footer/
      part.json
      index.php

Κάθε φάκελος περιέχει ένα αρχείο δήλωσης και ένα αρχείο πηγής.

Αρχείο Μηχανή
index.php Σήμανση μπλοκ τύπου HTML, όπως είναι (ο κώδικας PHP δεν εκτελείται)
index.blade.php Blade
index.twig Twig
index.html Σήμανση μπλοκ τύπου HTML

Αν υπάρχουν πολλά αρχεία πηγής, το Blockstudio χρησιμοποιεί την εξής σειρά:

  1. index.php
  2. index.blade.php
  3. index.twig
  4. index.html

Το WordPress εντοπίζει επίσης αναδρομικά αρχεία .html και συνήθως εμφανίζει ένα ενσωματωμένο index.html κάτω από ένα αναγνωριστικό που προκύπτει από τη διαδρομή του, όπως το header/index. Όταν αυτό το αρχείο ανήκει σε αρχείο δήλωσης Blockstudio, το Blockstudio αφαιρεί το διπλότυπο που προκύπτει από τη διαδρομή και εμφανίζει μόνο το slug που δηλώνεται στο αρχείο δήλωσης. Τα ενσωματωμένα εγγενή πρότυπα .html χωρίς αρχείο δήλωσης Blockstudio παραμένουν αμετάβλητα.

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

template.json

Το template.json ορίζει ένα πλήρες πρότυπο του Site Editor.

JSON
{
  "slug": "front-page",
  "title": "Front Page",
  "description": "Homepage template",
  "postTypes": ["page"]
}

Ιδιότητες

Ιδιότητα Τύπος Προεπιλογή Περιγραφή
slug / name string Όνομα φακέλου Αναγνωριστικό προτύπου WordPress. Χρησιμοποιήστε ακριβή αναγνωριστικά ιεραρχίας, όπως front-page, single, archive-product ή 404.
title string Τίτλος από το αναγνωριστικό Τίτλος εμφάνισης στο Site Editor.
description string "" Περιγραφή εμφάνισης στο Site Editor.
postTypes string[] [] Τύποι αναρτήσεων για προσαρμοσμένα πρότυπα. Για τα πρότυπα της βασικής ιεραρχίας μπορείτε να το παραλείψετε.
source / template / file string Αυτόματος εντοπισμός αρχείου ευρετηρίου Προαιρετική διαδρομή αρχείου πηγής, σχετική με τον φάκελο προτύπου.
status string "publish" Κατάσταση προτύπου.
sync boolean false Διατηρείται για μελλοντική ενσωμάτωση στη βάση δεδομένων. Οι προσαρμογές των χρηστών δεν αντικαθίστανται ποτέ στο v1.
meta object {} Προσαρμοσμένα μεταδεδομένα για τα API βοηθητικών συναρτήσεων. Τα άγνωστα κλειδιά του αρχείου δήλωσης αποθηκεύονται επίσης εδώ.

Τα αναγνωριστικά προτύπων δεν έχουν πρόθεμα. Το WordPress χρειάζεται ακριβή ονόματα για την ιεραρχία προτύπων:

Text
index
home
front-page
single
single-post
single-product
archive
archive-product
page
page-about
404
search
taxonomy-product_cat

part.json

Το part.json ορίζει ένα τμήμα προτύπου του Site Editor.

JSON
{
  "slug": "header",
  "title": "Header",
  "description": "Main site header",
  "area": "header"
}

Ιδιότητες

Ιδιότητα Τύπος Προεπιλογή Περιγραφή
slug / name string Όνομα φακέλου Αναγνωριστικό τμήματος προτύπου WordPress.
title string Τίτλος από το αναγνωριστικό Τίτλος εμφάνισης στο Site Editor.
description string "" Περιγραφή εμφάνισης στο Site Editor.
area string "uncategorized" Περιοχή τμήματος προτύπου. Συνηθισμένες τιμές είναι οι header, footer και sidebar.
source / template / file string Αυτόματος εντοπισμός αρχείου ευρετηρίου Προαιρετική διαδρομή αρχείου πηγής, σχετική με τον φάκελο του τμήματος.
status string "publish" Κατάσταση τμήματος προτύπου.
meta object {} Προσαρμοσμένα μεταδεδομένα για τα API βοηθητικών συναρτήσεων. Τα άγνωστα κλειδιά του αρχείου δήλωσης αποθηκεύονται επίσης εδώ.

Σύνταξη σήμανσης

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

PHP
<div class="site-shell">
  <block name="core/template-part" slug="header" />

  <main>
    <h1>Welcome</h1>
    <p>This template is compiled from Blockstudio files.</p>
    <block name="core/post-content" />
  </main>

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

Το στοιχείο <main> γίνεται μπλοκ core/group που αποδίδεται ως <main>, και τα παιδιά του, συμπεριλαμβανομένης της ετικέτας μπλοκ core/post-content, γίνονται εσωτερικά μπλοκ. Μπορείτε να χρησιμοποιήσετε:

  • τυπικά στοιχεία HTML όπως τα <h1>, <p>, <ul>, <div> και τα στοιχεία τμηματοποίησης <main>, <header>, <footer>, <article> και <aside>
  • <block name="namespace/block">
  • <bs:namespace-block>
  • διαμορφωμένα προθέματα ετικετών μπλοκ
  • μπλοκ και στοιχεία Blockstudio

Τα μπλοκ τμημάτων προτύπου λαμβάνουν το χαρακτηριστικό ενεργού θέματος όταν το WordPress αποδίδει το μεταγλωττισμένο πρότυπο.

Προσαρμογές στο Site Editor

Το Blockstudio παρέχει την πηγή αρχείου. Το WordPress διαχειρίζεται τις προσαρμογές των χρηστών.

Η σειρά αναζήτησης είναι:

  1. Προσαρμογή από τη βάση δεδομένων του Site Editor
  2. Εγγενές αρχείο .html του ενεργού θέματος
  3. Πηγή αρχείου του Blockstudio
  4. Εναλλακτικές πηγές του γονικού θέματος ή των προσθέτων

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

Το Blockstudio δεν γράφει τις αλλαγές του Site Editor πίσω στα αρχεία του v1.

Απόδοση

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

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

PHP API

PHP
$templates = Blockstudio\Site_Templates::templates();
$parts = Blockstudio\Site_Templates::parts();

$template = Blockstudio\Site_Templates::get_template('front-page');
$header = Blockstudio\Site_Templates::get_part('header');

$paths = Blockstudio\Site_Templates::get_paths();

Περάστε μια ρητή λίστα για να διαβάσετε και να μεταγλωττίσετε μόνο ακριβή αναγνωριστικά, διαδρομές ή διαδρομές πηγής:

PHP
$templates = Blockstudio\Site_Templates::templates([
    'front-page',
]);

$parts = Blockstudio\Site_Templates::parts([
    'header',
]);

$errors = Blockstudio\Site_Templates::selection_errors('templates');

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

Διατίθενται επίσης βοηθητικές συναρτήσεις προτύπων:

PHP
blockstudio_site_templates();
blockstudio_site_template_parts();
blockstudio_site_template('front-page');
blockstudio_site_template_part('header');

Άγκιστρα

Όλο το σύνολο σημείων επέκτασης των Προτύπων ιστοτόπου είναι το εξής:

Άγκιστρο Τύπος Περιγραφή
blockstudio/site_templates/template_paths Φίλτρο Προσαρμογή των ριζών εντοπισμού πλήρων προτύπων.
blockstudio/site_templates/part_paths Φίλτρο Προσαρμογή των ριζών εντοπισμού τμημάτων προτύπων.
blockstudio/site_templates/paths Φίλτρο Προσαρμογή και των δύο λιστών διαδρομών ως templates και parts.
blockstudio/site_templates/template_candidates Φίλτρο Προσαρμογή των υποψήφιων αρχείων πηγής για ένα αρχείο δήλωσης.
blockstudio/site_templates/templates Φίλτρο Προσαρμογή των προτύπων που επιστρέφει το μητρώο API.
blockstudio/site_templates/parts Φίλτρο Προσαρμογή των τμημάτων προτύπων που επιστρέφει το μητρώο API.
blockstudio/site_templates/template_content Φίλτρο Προσαρμογή της πηγής πλήρους προτύπου μετά τη μεταγλώττιση και πριν από την ανάλυση.
blockstudio/site_templates/part_content Φίλτρο Προσαρμογή της πηγής τμήματος προτύπου μετά τη μεταγλώττιση και πριν από την ανάλυση.
blockstudio/site_templates/parser Φίλτρο Αντικατάσταση της παρουσίας Html_Parser για ένα στοιχείο.
blockstudio/site_templates/source_compiled Ενέργεια Εκτελείται αμέσως πριν από τη μεταγλώττιση μιας επιλεγμένης πηγής.
blockstudio/site_templates/discovered Ενέργεια Εκτελείται μετά από ψυχρή διέλευση εντοπισμού και μεταγλώττισης.
blockstudio/site_templates/registered Ενέργεια Εκτελείται μετά τη διατήρηση του αναδημιουργημένου μητρώου.

Προσθήκη ή αντικατάσταση διαδρομών εντοπισμού:

PHP
add_filter('blockstudio/site_templates/template_paths', function ($paths) {
    $paths[] = get_stylesheet_directory() . '/site-templates';
    return $paths;
});

add_filter('blockstudio/site_templates/part_paths', function ($paths) {
    $paths[] = get_stylesheet_directory() . '/site-parts';
    return $paths;
});

add_filter('blockstudio/site_templates/paths', function ($paths) {
    return $paths;
});

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

PHP
add_filter('blockstudio/site_templates/templates', function ($templates) {
    return $templates;
});

add_filter('blockstudio/site_templates/parts', function ($parts) {
    return $parts;
});

Φιλτράρισμα της πηγής πριν από την ανάλυση:

PHP
add_filter('blockstudio/site_templates/template_content', function ($content, $template) {
    return $content;
}, 10, 2);

add_filter('blockstudio/site_templates/part_content', function ($content, $part) {
    return $content;
}, 10, 2);

Αλλαγή υποψήφιων πηγών ή του αναλυτή:

PHP
add_filter(
    'blockstudio/site_templates/template_candidates',
    function ($candidates, $directory, $manifest) {
        $candidates[] = $directory . '/template.custom.php';
        return $candidates;
    },
    10,
    3
);

add_filter(
    'blockstudio/site_templates/parser',
    function ($parser, $item) {
        return $parser;
    },
    10,
    2
);

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