Μοτίβα
Τα μοτίβα είναι πρότυπα βάσει αρχείων που καταχωρίζονται ως μοτίβα μπλοκ του WordPress. Εμφανίζονται στο εργαλείο εισαγωγής μπλοκ και οι χρήστες μπορούν να τα τοποθετήσουν οπουδήποτε.
Σε αντίθεση με τις σελίδες, τα μοτίβα καταχωρίζονται στη μνήμη και δεν δημιουργούν εγγραφές στη βάση δεδομένων.
pattern.json
Κάθε φάκελος μοτίβου χρειάζεται ένα αρχείο διαμόρφωσης pattern.json:
{
"name": "hero-section",
"title": "Hero Section",
"description": "A hero section with heading and CTA",
"categories": ["featured", "header"],
"keywords": ["hero", "banner", "cta"]
}
Ιδιότητες
| Ιδιότητα | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
name |
string |
απαιτείται | Μοναδικό αναγνωριστικό (με πρόθεμα blockstudio/) |
title |
string |
απαιτείται | Τίτλος εμφάνισης στο εργαλείο εισαγωγής μπλοκ |
description |
string |
"" |
Περιγραφή που εμφανίζεται στο εργαλείο εισαγωγής |
categories |
string[] |
[] |
Κατηγορίες μοτίβων (e.g., featured, header, footer) |
keywords |
string[] |
[] |
Λέξεις-κλειδιά αναζήτησης για το εργαλείο εισαγωγής |
viewportWidth |
number |
– | Πλάτος προεπισκόπησης σε pixel |
blockTypes |
string[] |
[] |
Συσχετισμένοι τύποι μπλοκ |
postTypes |
string[] |
[] |
Περιορισμός σε συγκεκριμένους τύπους αναρτήσεων |
inserter |
boolean |
true |
Αν θα εμφανίζεται στο εργαλείο εισαγωγής |
Παράδειγμα
pattern.json:
{
"name": "hero-with-cta",
"title": "Hero with CTA",
"description": "A full-width hero section with heading and call-to-action buttons",
"categories": ["featured", "header"],
"keywords": ["hero", "banner", "cta", "landing"],
"viewportWidth": 1200
}
index.php:
<block name="core/cover" url="https://example.com/hero-bg.jpg" dimRatio="60">
<h1>Build Something Amazing</h1>
<p>Create beautiful websites with the power of blocks.</p>
<block name="core/buttons">
<block name="core/button" url="/get-started">Get Started</block>
<block name="core/button" url="/learn-more" className="is-style-outline">Learn More</block>
</block>
</block>
Προσαρμοσμένες διαδρομές
Από προεπιλογή, το Blockstudio σαρώνει το get_template_directory() . '/patterns'. Προσθέστε επιπλέον διαδρομές με το φίλτρο:
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
Οι ενσωματώσεις χρόνου εκτέλεσης που συνθέτουν αρχεία από πολλές ρίζες μπορούν να αντικαταστήσουν τη σάρωση του συστήματος αρχείων με μια λογική πηγή εντοπισμού. Τα αρχεία δήλωσης μοτίβων και τα πρότυπα πηγής εντοπίζονται από το τελικό ορατό λογικό ευρετήριο.
PHP API
// Get all registered patterns
$patterns = Blockstudio\Patterns::patterns();
// Get a specific pattern
$pattern = Blockstudio\Patterns::get_pattern('hero-section');
// Get registered paths
$paths = Blockstudio\Patterns::get_registered_paths();
Σύγκριση με τις σελίδες
| Πτυχή | Σελίδες | Μοτίβα |
|---|---|---|
| Αποθήκευση | Συγχρονίζονται στη βάση δεδομένων ως αναρτήσεις | Καταχωρίζονται στη μνήμη |
| Διαμόρφωση | page.json |
pattern.json |
| Συγχρονισμός | Ρητός, με wp bs pages sync |
Δεν απαιτείται συγχρονισμός |
| Κλείδωμα προτύπου | Ναι | Όχι |
| Περίπτωση χρήσης | Προκαθορισμένο περιεχόμενο σελίδων | Επαναχρησιμοποιήσιμα πρότυπα μπλοκ |