Σελίδες & μοτίβα
Το Blockstudio σάς επιτρέπει να ορίζετε σελίδες WordPress, μοτίβα μπλοκ και πρότυπα Site Editor ως αρχεία στο θέμα σας. Γράψτε πρότυπα τύπου HTML και ο αναλυτής του Blockstudio τα μετατρέπει σε εγγενή μπλοκ WordPress.
- Σελίδες συγχρονίζονται με τη βάση δεδομένων ως αναρτήσεις WordPress, ώστε τα πρότυπα αρχείων και το περιεχόμενο των σελίδων να παραμένουν συγχρονισμένα.
- Μοτίβα καταχωρίζονται στη μνήμη μέσω του
register_block_pattern()και είναι διαθέσιμα στην εισαγωγή μπλοκ για να τα τοποθετούν οι χρήστες όπου θέλουν. - Πρότυπα ιστοτόπου παρέχουν πηγές
wp_templateκαιwp_template_partπου βασίζονται σε αρχεία για το Site Editor του WordPress.
Και οι τρεις λειτουργίες χρησιμοποιούν τον ίδιο αναλυτή HTML και την ίδια σύνταξη μπλοκ.
Πρακτικός οδηγός για πρότυπα σελίδων που βασίζονται σε αρχεία, συγχρονισμό και κλείδωμα.
Δομή φακέλων
theme/
├── pages/
│ ├── about/
│ │ ├── page.json
│ │ └── index.php
│ └── contact/
│ ├── page.json
│ └── index.twig
├── patterns/
├── hero/
│ ├── pattern.json
│ └── index.php
└── cta/
├── pattern.json
└── index.blade.php
├── templates/
└── front-page/
├── template.json
└── index.php
└── parts/
└── header/
├── part.json
└── index.php
Κάθε υποφάκελος περιέχει ένα αρχείο ρυθμίσεων JSON (page.json, pattern.json, template.json ή part.json) και ένα αρχείο προτύπου.
Μηχανές προτύπων
Τα πρότυπα μπορούν να γραφτούν ως απλή σήμανση σε index.php ή σε Twig ή Blade:
| Αρχείο | Μηχανή | Απαίτηση |
|---|---|---|
index.php |
Καμία (διαβάζεται ως έχει, ο κώδικας PHP δεν εκτελείται) | Καμία |
index.twig |
Twig | Timber |
index.blade.php |
Blade | illuminate/view |
Αν υπάρχουν πολλά αρχεία προτύπων, η σειρά προτεραιότητας είναι: index.php > index.blade.php > index.twig.
Επειδή τα πρότυπα μεταγλωττίζονται κατά την αρχικοποίηση (πριν από οποιοδήποτε πλαίσιο αιτήματος), τα πρότυπα Twig και Blade δεν έχουν πρόσβαση σε δυναμικές μεταβλητές. Είναι χρήσιμα για ενσωματωμένες συναρτήσεις και φίλτρα, όπως τα {{ "text"|upper }} ή {{ strtoupper("text") }}.
Αντιστοίχιση HTML σε μπλοκ
Τα τυπικά στοιχεία HTML μετατρέπονται αυτόματα στα αντίστοιχα μπλοκ WordPress.
Κείμενο
| HTML | Μπλοκ |
|---|---|
<p> |
core/paragraph |
<h1> – <h6> |
core/heading |
<ul> |
core/list (χωρίς αρίθμηση) |
<ol> |
core/list (με αρίθμηση) |
<li> |
core/list-item |
<blockquote> |
core/quote |
<code> |
core/code |
<pre> |
core/preformatted |
Οι λίστες διατηρούν τη δομή τους. Ένα <ul> ή ένα <ol> μέσα σε ένα <li> γίνεται εσωτερικό μπλοκ core/list αυτού του core/list-item, όπως ακριβώς το αποθηκεύει ο επεξεργαστής, ώστε οι λίστες να μπορούν να έχουν οποιοδήποτε βάθος. Ένα class σε μια λίστα ή σε ένα στοιχείο της γίνεται το className του, ο τρόπος με τον οποίο ορίζεται ένα στυλ μπλοκ όπως το is-style-checks από ένα αρχείο σελίδας· το <block name="core/list" className="..."> κάνει το ίδιο.
Πολυμέσα
| HTML | Μπλοκ |
|---|---|
<img> |
core/image |
<figure> |
core/image (με λεζάντα) |
<audio> |
core/audio |
<video> |
core/video |
Διάταξη
| HTML | Μπλοκ |
|---|---|
<div>, <section> |
core/group |
<main>, <header>, <footer>, <article>, <aside> |
core/group που διατηρεί το στοιχείο ως tagName |
<hr> |
core/separator |
<details> |
core/details |
<table> |
core/table |
Σύνταξη μπλοκ
Για μπλοκ χωρίς άμεσο αντίστοιχο HTML, χρησιμοποιήστε το στοιχείο <block>:
<block name="core/cover" url="https://example.com/hero.jpg">
<h1>Welcome</h1>
<p>Content inside the cover block.</p>
</block>
Βασικά μπλοκ
<!-- Pullquote -->
<block name="core/pullquote">
<p>An important quote.</p>
</block>
<!-- Verse -->
<block name="core/verse">Roses are red,
Violets are blue.</block>
<!-- Cover -->
<block name="core/cover" url="https://example.com/image.jpg">
<h2>Cover Title</h2>
</block>
<!-- Embed -->
<block name="core/embed" url="https://youtube.com/watch?v=..." providerNameSlug="youtube" />
<!-- Spacer -->
<block name="core/spacer" height="50px" />
<!-- Gallery -->
<block name="core/gallery">
<img src="https://example.com/1.jpg" alt="Image 1" />
<img src="https://example.com/2.jpg" alt="Image 2" />
</block>
<!-- Columns -->
<block name="core/columns">
<block name="core/column">
<h3>Column 1</h3>
</block>
<block name="core/column">
<h3>Column 2</h3>
</block>
</block>
<!-- Buttons -->
<block name="core/buttons">
<block name="core/button" url="/get-started">Get Started</block>
</block>
<!-- Row (flex layout) -->
<block name="core/group" layout='{"type":"flex","flexWrap":"nowrap"}'>
<p>Item 1</p>
<p>Item 2</p>
</block>
Προσαρμοσμένα μπλοκ
Η ίδια σύνταξη λειτουργεί για κάθε καταχωρισμένο μπλοκ:
<block name="blockstudio/section">
<h1>Welcome</h1>
</block>
<block name="acf/hero" title="Hero Title" background="dark">
<p>Inner content becomes InnerBlocks.</p>
</block>
Χαρακτηριστικά
Τα γνωρίσματα HTML σε στοιχεία <block> περνούν ως γνωρίσματα μπλοκ. Υποστηρίζονται τιμές JSON:
<block name="core/heading" level="3">Custom Heading</block>
<block name="core/group" layout='{"type":"flex","orientation":"vertical"}'>
<p>Stacked content.</p>
</block>
<img src="https://example.com/photo.jpg" alt="Photo" width="800" height="400" />
Οι τιμές γνωρισμάτων αποκωδικοποιούνται μία φορά, όπως τις διαβάζει ένα πρόγραμμα περιήγησης, ώστε τα data-animate="[&>span]:fade" και data-animate="[&>span]:fade" να αποθηκεύουν την ίδια τιμή.
Σε ένα στοιχείο που αντιστοιχίζεται σε μπλοκ Blockstudio, κάθε γνώρισμα αποθηκεύεται μαζί με το μπλοκ. Τα δηλωμένα πεδία είναι διαθέσιμα στο πρότυπο· τα καθολικά γνωρίσματα που δεν δηλώνει το μπλοκ (id, style, role, title, lang, dir, hidden, tabindex, aria-* και data-*) τοποθετούνται στο ριζικό στοιχείο του μπλοκ κατά την απόδοσή του, όπως ακριβώς συμβαίνει με τις ετικέτες μπλοκ. Στις πηγές σελίδων και μοτίβων, το πρόθεμα html- απλώς προσδιορίζει ένα από αυτά τα καθολικά γνωρίσματα, οπότε το html-role="note" προωθείται ως role, ενώ οι χειριστές συμβάντων όπως το html-onclick δεν αποδίδονται ποτέ. Όλα τα υπόλοιπα, συμπεριλαμβανομένου ενός μη δηλωμένου class, παραμένουν στο περιεχόμενο της ανάρτησης χωρίς να εμφανίζονται στη σελίδα, και το wp bs pages sync τα αναφέρει για κάθε σελίδα που αναλύει.
Προσαρμοσμένοι αποδοτές μπλοκ
Ο αναλυτής HTML χρησιμοποιεί αρχιτεκτονική βασισμένη σε μητρώο. Προσθέστε ένα builder για προσαρμοσμένο μπλοκ με το blockstudio/block_tags/builders:
add_filter( 'blockstudio/block_tags/builders', function( $builders, $parser ) {
$builders['acf/hero'] = function( array $attrs, string $inner_content ) {
$inner_blocks = Blockstudio\Block_Tags::parse_inner_blocks( $inner_content );
return array(
'blockName' => 'acf/hero',
'attrs' => $attrs,
'innerBlocks' => $inner_blocks,
'innerHTML' => '',
'innerContent' => array_fill( 0, count( $inner_blocks ), null ),
);
};
return $builders;
}, 10, 2 );
Στη συνέχεια, χρησιμοποιήστε το σε οποιοδήποτε πρότυπο:
<block name="acf/hero" background="dark">
<h1>Welcome</h1>
</block>
Μπορείτε επίσης να παρακάμψετε τον τρόπο απόδοσης των βασικών μπλοκ:
add_filter( 'blockstudio/parser/renderers', function( $renderers, $parser ) {
$renderers['core/paragraph'] = function( array $attrs, string $inner_content ) {
$content = trim( $inner_content );
$attrs['align'] = $attrs['align'] ?? 'center';
return array(
'blockName' => 'core/paragraph',
'attrs' => $attrs,
'innerBlocks' => array(),
'innerHTML' => '<p class="has-text-align-center">' . $content . '</p>',
'innerContent' => array( '<p class="has-text-align-center">' . $content . '</p>' ),
);
};
return $renderers;
}, 10, 2 );
Οι συναρτήσεις επανάκλησης των builders λαμβάνουν τα αναλυμένα γνωρίσματα και το ακατέργαστο εσωτερικό περιεχόμενο. Πρέπει να επιστρέφουν πίνακα μπλοκ WordPress. Για την πλήρη σειρά φίλτρων και παράδειγμα κοντέινερ, δείτε την ενότητα Προσαρμοσμένοι αποδοτές.
Υπογραφή συνάρτησης builder
/**
* @param array $attrs Parsed element or block-tag attributes.
* @param string $inner_content Raw inner content.
* @return array WordPress block array.
*/
function my_builder( array $attrs, string $inner_content ): array {}
Αντιστοίχιση στοιχείων
Από προεπιλογή, τα τυπικά στοιχεία HTML όπως τα <h1>, <p> και <img> αντιστοιχίζονται σε βασικά μπλοκ WordPress. Μπορείτε να παρακάμψετε αυτή την αντιστοίχιση και να κατευθύνετε οποιοδήποτε στοιχείο HTML σε διαφορετικό μπλοκ χρησιμοποιώντας το φίλτρο blockstudio/parser/element_mapping:
add_filter( 'blockstudio/parser/element_mapping', function( $mapping ) {
$mapping['h1'] = 'custom/heading';
$mapping['h2'] = 'custom/heading';
$mapping['p'] = 'custom/paragraph';
$mapping['img'] = 'custom/image';
return $mapping;
}, 10, 2 );
Με ενεργό αυτό το φίλτρο, κάθε <h1> στα πρότυπά σας θα δημιουργεί ένα μπλοκ custom/heading αντί για core/heading. Τα γνωρίσματα του στοιχείου μεταβιβάζονται στο μπλοκ-στόχο. Αν έχει καταχωριστεί αποδοτής για το όνομα του μπλοκ-στόχου, θα χρησιμοποιηθεί. Διαφορετικά, δημιουργείται μια γενική δομή μπλοκ.
Αυτό είναι χρήσιμο όταν το θέμα ή το πρόσθετό σας παρέχει προσαρμοσμένους τύπους μπλοκ που πρέπει να αντικαταστήσουν τις προεπιλογές σε όλα τα πρότυπα σελίδων και μοτίβων.
Για απλές αντιστοιχίσεις <p>, το Blockstudio μπορεί να κατευθύνει απευθείας εσωτερικό HTML στο γνώρισμα richtext content ενός καταχωρισμένου μπλοκ Blockstudio που δεν είναι βασικό. Το μπλοκ-στόχος πρέπει να δηλώνει ένα γνώρισμα με τα id: "content" και type: "richtext". Η μορφοποίηση εντός γραμμής (a, b, br, code, del, em, i, img, ins, mark, s, small, span, strong, sub, sup, u) διατηρείται στην προωθούμενη τιμή ακόμη κι όταν η ίδια ετικέτα αντιστοιχίζεται ως στοιχείο, όπως συμβαίνει από προεπιλογή με τα code και img. Μια παράγραφος με μοναδικό θυγατρικό στοιχείο μια εικόνα γίνεται το μπλοκ στο οποίο αντιστοιχίζεται το <img>, όπως ακριβώς παράγει το Markdown για μια αυτόνομη εικόνα. Οι ένθετες ετικέτες μπλοκ και τα μπλοκ επιπέδου HTML εξακολουθούν να αναλύονται ως εσωτερικά μπλοκ.
Οι τιμές αντιστοίχισης μπορούν επίσης να είναι συναρτήσεις, όταν το μπλοκ-στόχος εξαρτάται από τα γνωρίσματα του στοιχείου:
add_filter( 'blockstudio/parser/element_mapping', function( $mapping ) {
$mapping['div'] = function( array $attrs ) {
if ( isset( $attrs['width'] ) ) {
return 'theme/row';
}
if ( isset( $attrs['gap'] ) ) {
return 'theme/flow';
}
return 'theme/div';
};
return $mapping;
} );
Τα προσαρμοσμένα μπλοκ που αντιστοιχίζονται από στοιχεία κοντέινερ, όπως τα <section> και <div>, αναλύουν αναδρομικά τα ένθετα θυγατρικά HTML, ώστε οι εσωτερικές επικεφαλίδες, εικόνες, ετικέτες μπλοκ και παράγραφοι να γίνονται εγγενή θυγατρικά μπλοκ.
Πλήρες παράδειγμα
Ένα πλήρες πρότυπο σελίδας που συνδυάζει πολλούς τύπους μπλοκ:
<div>
<h1>Welcome to Our Site</h1>
<p>This is an <strong>introduction</strong> with <em>formatting</em>.</p>
<block name="core/columns">
<block name="core/column">
<h3>Feature One</h3>
<p>First feature description.</p>
</block>
<block name="core/column">
<h3>Feature Two</h3>
<p>Second feature description.</p>
</block>
</block>
<block name="core/cover" url="https://example.com/hero.jpg">
<h2>Our Mission</h2>
<p>Building amazing things together.</p>
</block>
<details>
<summary>FAQ</summary>
<p>Answers to common questions.</p>
</details>
<block name="core/buttons">
<block name="core/button" url="/contact">Contact Us</block>
<block name="core/button" url="/learn-more">Learn More</block>
</block>
</div>