Πρότυπα ιστοτόπου
Τα Πρότυπα ιστοτόπου επιτρέπουν στα θέματα μπλοκ να ορίζουν 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/:
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 χρησιμοποιεί την εξής σειρά:
index.phpindex.blade.phpindex.twigindex.html
Το WordPress εντοπίζει επίσης αναδρομικά αρχεία .html και συνήθως εμφανίζει ένα
ενσωματωμένο index.html κάτω από ένα αναγνωριστικό που προκύπτει από τη διαδρομή του, όπως το header/index.
Όταν αυτό το αρχείο ανήκει σε αρχείο δήλωσης Blockstudio, το Blockstudio αφαιρεί το
διπλότυπο που προκύπτει από τη διαδρομή και εμφανίζει μόνο το slug που δηλώνεται στο αρχείο δήλωσης.
Τα ενσωματωμένα εγγενή πρότυπα .html χωρίς αρχείο δήλωσης Blockstudio παραμένουν αμετάβλητα.
Η πηγή μεταγλωττίζεται μία φορά σε εγγενή σήμανση μπλοκ WordPress. Δεν πρέπει να εξαρτάται από το τρέχον αίτημα ή την τρέχουσα ανάρτηση. Τοποθετήστε τη συμπεριφορά χρόνου εκτέλεσης μέσα σε δυναμικά μπλοκ.
template.json
Το template.json ορίζει ένα πλήρες πρότυπο του Site Editor.
{
"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 χρειάζεται ακριβή ονόματα για την ιεραρχία προτύπων:
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.
{
"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 βοηθητικών συναρτήσεων. Τα άγνωστα κλειδιά του αρχείου δήλωσης αποθηκεύονται επίσης εδώ. |
Σύνταξη σήμανσης
Οι πηγές Προτύπων ιστοτόπου χρησιμοποιούν τον ίδιο αναλυτή με τις σελίδες και τα μοτίβα:
<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 διαχειρίζεται τις προσαρμογές των χρηστών.
Η σειρά αναζήτησης είναι:
- Προσαρμογή από τη βάση δεδομένων του Site Editor
- Εγγενές αρχείο
.htmlτου ενεργού θέματος - Πηγή αρχείου του Blockstudio
- Εναλλακτικές πηγές του γονικού θέματος ή των προσθέτων
Όταν ένας χρήστης αποθηκεύει στο Site Editor ένα πρότυπο βάσει αρχείου του Blockstudio,
το WordPress δημιουργεί μια κανονική εγγραφή wp_template ή wp_template_part στη βάση δεδομένων.
Αυτή η αποθηκευμένη εγγραφή υπερισχύει των μελλοντικών αλλαγών στα αρχεία. Με την επαναφορά ή διαγραφή της
προσαρμογής, εμφανίζεται ξανά η πιο πρόσφατη πηγή βάσει αρχείου.
Το Blockstudio δεν γράφει τις αλλαγές του Site Editor πίσω στα αρχεία του v1.
Απόδοση
Ο εντοπισμός προτύπων αποθηκεύεται προσωρινά ανά αίτημα και διατηρείται μαζί με μεταδεδομένα παρακολούθησης αρχείων. Αν αλλάξει ένα αρχείο δήλωσης ή πηγής, η προσωρινά αποθηκευμένη μεταγλωττισμένη έκδοση ακυρώνεται. Οι προσαρμογές της βάσης δεδομένων δεν αποθηκεύονται προσωρινά πάνω από τις υπάρχουσες: το WordPress εξακολουθεί να τις ελέγχει πρώτα.
Οι ενσωματώσεις χρόνου εκτέλεσης που συνθέτουν αρχεία από πολλές ρίζες μπορούν να παρέχουν μια λογική πηγή εντοπισμού για πρότυπα και τμήματα προτύπων. Τα αρχεία δήλωσης και τα επιλεγμένα πρότυπα πηγής μπορεί να βρίσκονται σε διαφορετικές φυσικές ρίζες, διατηρώντας παράλληλα ένα ενιαίο λογικό δέντρο θέματος.
PHP API
$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();
Περάστε μια ρητή λίστα για να διαβάσετε και να μεταγλωττίσετε μόνο ακριβή αναγνωριστικά, διαδρομές ή διαδρομές πηγής:
$templates = Blockstudio\Site_Templates::templates([
'front-page',
]);
$parts = Blockstudio\Site_Templates::parts([
'header',
]);
$errors = Blockstudio\Site_Templates::selection_errors('templates');
Αν παραλείψετε το όρισμα, διατηρείται η πλήρης συμπεριφορά του μητρώου. Αν περάσετε κενή λίστα, δεν επιστρέφονται στοιχεία. Τα συμβατικά αιτήματα αναγνωριστικών και διαδρομών περιορίζουν τον εντοπισμό στους αντίστοιχους καταλόγους τους. Για προσαρμοσμένα αναγνωριστικά αρχείων δήλωσης μπορεί να απαιτείται σάρωση μεταδεδομένων, αλλά οι άσχετες πηγές δεν μεταγλωττίζονται ούτε επιστρέφονται.
Διατίθενται επίσης βοηθητικές συναρτήσεις προτύπων:
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 |
Ενέργεια | Εκτελείται μετά τη διατήρηση του αναδημιουργημένου μητρώου. |
Προσθήκη ή αντικατάσταση διαδρομών εντοπισμού:
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;
});
Φιλτράρισμα των δεδομένων που εντοπίστηκαν:
add_filter('blockstudio/site_templates/templates', function ($templates) {
return $templates;
});
add_filter('blockstudio/site_templates/parts', function ($parts) {
return $parts;
});
Φιλτράρισμα της πηγής πριν από την ανάλυση:
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);
Αλλαγή υποψήφιων πηγών ή του αναλυτή:
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 είναι ενέργειες κύκλου ζωής για την αναδημιουργία της προσωρινής μνήμης. Δεν
εκτελούνται όταν υπάρχει εύστοχη πρόσβαση στη ζεστή προσωρινή μνήμη του μητρώου.