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

Μοτίβα

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

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

pattern.json

Κάθε φάκελος μοτίβου χρειάζεται ένα αρχείο διαμόρφωσης pattern.json:

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:

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:

HTML
<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'. Προσθέστε επιπλέον διαδρομές με το φίλτρο:

PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/custom-patterns';
    $paths[] = MY_PLUGIN_PATH . '/patterns';
    return $paths;
} );

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

PHP API

PHP
// 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 Δεν απαιτείται συγχρονισμός
Κλείδωμα προτύπου Ναι Όχι
Περίπτωση χρήσης Προκαθορισμένο περιεχόμενο σελίδων Επαναχρησιμοποιήσιμα πρότυπα μπλοκ