Καταχώριση
Η σύνθεση δικών σας μπλοκ με το Blockstudio είναι εξαιρετικά εύκολη. Το πρόσθετο
αναζητά έναν φάκελο blockstudio στο ενεργό θέμα σας. Θα καταχωριστούν όλοι οι υποφάκελοι
που περιέχουν ένα αρχείο block.json με κλειδί blockstudio.
block.json
{
"name": "blockstudio/native",
"title": "Native Block",
"category": "text",
"icon": "star-filled",
"description": "Native Blockstudio block.",
"blockstudio": true
}
Πρότυπο
Το προσαρμοσμένο μπλοκ δεν θα καταχωριστεί ακόμη, επειδή του λείπει ένα πρότυπο. Για να το διορθώσετε, δημιουργήστε ένα index.php στον ίδιο φάκελο με το αρχείο block.json. Τα περιεχόμενά του θα αποδίδονται αυτόματα όταν χρησιμοποιείται το μπλοκ σας.
<h1>My first native block.</h1>
Λογική υπό συνθήκη
Τα μπλοκ μπορούν να καταχωρίζονται υπό συνθήκη με το κλειδί conditions. Υποστηρίζει όλες τις καθολικές μεταβλητές που είναι διαθέσιμες και για τα γνωρίσματα.
Το παρακάτω παράδειγμα καταχωρίζει το μπλοκ μόνο αν ο τύπος της τρέχουσας ανάρτησης είναι σελίδα:
{
"blockstudio": {
"conditions": [
[
{
"type": "postType",
"operator": "==",
"value": "page"
}
]
]
}
}
Εξαρτήσεις από πρόσθετα
Τα μπλοκ μπορούν να εξαρτώνται από ενεργά πρόσθετα WordPress μέσω του κλειδιού pluginDependencies. Αν κάποιο από τα πρόσθετα που αναφέρονται δεν είναι ενεργό, το μπλοκ παραλείπεται κατά την καταχώριση.
Οι εξαρτήσεις χρησιμοποιούν αναγνωριστικά πρόσθετων WordPress:
{
"blockstudio": {
"pluginDependencies": [
"woocommerce",
"advanced-custom-fields"
]
}
}
Χρησιμοποιήστε τη μορφή αντικειμένου για να απαιτήσετε συγκεκριμένη έκδοση πρόσθετου. Οι περιορισμοί έκδοσης χρησιμοποιούν τους ίδιους τελεστές με το PHP version_compare() του· μια έκδοση χωρίς τελεστή θεωρείται >=.
{
"blockstudio": {
"pluginDependencies": {
"woocommerce": {
"version": ">6"
}
}
}
}
Προσαρμοσμένο εικονίδιο
Τα προσαρμοσμένα εικονίδια SVG για μπλοκ μπορούν να καταχωριστούν ως εξής:
{
"blockstudio": {
"icon": "<svg></svg>"
}
}
Το WordPress δεν επιτρέπει προσαρμοσμένα εικονίδια SVG στο δικό του κλειδί block.json icon· εδώ επιτρέπονται μόνο αναγνωριστικά Dashicons.
Τυπικά μπλοκ WordPress
Το Blockstudio καταχωρίζει αυτόματα και τα τυπικά μπλοκ WordPress που βρίσκονται στους καταλόγους Blockstudio σας. Κάθε block.json χωρίς κλειδί blockstudio αλλά με έγκυρη ιδιότητα name καταχωρίζεται μέσω του εγγενούς register_block_type() του WordPress.
Αυτό σημαίνει ότι μπορείτε να τοποθετήσετε μπλοκ που δημιουργήθηκαν με το @wordpress/create-block απευθείας στον φάκελο blockstudio/ σας και θα καταχωριστούν αυτόματα μαζί με τα μπλοκ Blockstudio σας. Δεν απαιτείται ξεχωριστός κώδικας καταχώρισης πρόσθετου.
blockstudio/
├── hero/
│ ├── block.json ← Blockstudio block (has "blockstudio" key)
│ └── index.twig
├── my-js-block/
│ ├── block.json ← Standard WP block (no "blockstudio" key)
│ ├── index.js ← Compiled editor script
│ ├── index.css
│ ├── style-index.css
│ └── render.php
Δημιουργήστε το μπλοκ σας με το npx wp-scripts build και, στη συνέχεια, τοποθετήστε τον φάκελο εξόδου στον κατάλογο Blockstudio σας. Θα καταχωριστεί αυτόματα.
Το ίδιο ισχύει και για τα μπλοκ μόνο PHP της έκδοσης WordPress 7.0:
ένα block.json με υποστήριξη autoRegister και ένα render.php δεν χρειάζονται script ούτε build και καταχωρίζονται εδώ όπως κάθε άλλο τυπικό μπλοκ. Το Core περιορίζει αυτή την επιλογή σε απλά μπλοκ με γνωρίσματα τύπου string, integer, boolean και enum· μόλις χρειαστούν εσωτερικά μπλοκ, εμπλουτισμένο κείμενο, πολυμέσα ή προσαρμοσμένα χειριστήρια, είτε δημιουργήστε ένα μπλοκ στην πλευρά του client είτε δώστε του κλειδί blockstudio και παραμείνετε στο PHP.
HTML
Το Blockstudio χρησιμοποιεί αναλυτή στοιχείων React για να αποδώσει το στοιχείο εικονιδίου, επομένως μπορείτε να χρησιμοποιήσετε το HTML μέσα στη συμβολοσειρά του εικονιδίου.
{
"blockstudio": {
"icon": "<div>:-)</div>"
}
}
Προσαρμοσμένες διαδρομές
Από προεπιλογή, το Blockstudio αναζητά αναδρομικά μπλοκ στον φάκελο blockstudio του τρέχοντος θέματος ή του θυγατρικού θέματος. Μπορείτε να αλλάξετε αυτή τη συμπεριφορά με δύο τρόπους.
Φίλτρο
// Custom path within your theme.
add_filter('blockstudio/path', function () {
return get_template_directory() . '/blocks';
});
// Custom path within a plugin.
add_filter('blockstudio/path', function () {
return WP_PLUGIN_DIR . '/my-custom-plugin/blocks';
});
Για σύνθετα ή εικονικά συστήματα αρχείων, χρησιμοποιήστε μια λογική πηγή εντοπισμού αντί να προσθέσετε ξεχωριστές διαδρομές γονικού και υπερκείμενου επιπέδου. Οι λογικές πηγές υποστηρίζουν την απόκρυψη ανά διαδρομή, τα κληρονομημένα αδελφά αρχεία, τις διαγραφές, την ταυτότητα της κρυφής μνήμης και την προέλευση. Δείτε τις Λογικές πηγές εντοπισμού.
Στιγμιότυπα
Αν οι παραπάνω επιλογές δεν επαρκούν, μπορείτε να αρχικοποιήσετε την κλάση Blockstudio\Build σε διάφορους φακέλους της επιλογής σας:
add_action('init', function () {
Blockstudio\Build::init([
'dir' => get_template_directory() . '/client-blocks'
]);
});
Φιλτράρισμα μεταδεδομένων
Μπορείτε να φιλτράρετε τα μεταδεδομένα πριν από την καταχώριση του μπλοκ με το φίλτρο blockstudio/blocks/meta:
add_filter('blockstudio/blocks/meta', function ($meta, $block) {
if (str_starts_with($block['name'], 'marketing')) {
$meta['icon'] = 'megaphone';
}
return $meta;
}, 10, 2);
Το παραπάνω παράδειγμα χρησιμοποιείται εσωτερικά, ώστε όλα τα στοιχεία της βιβλιοθήκης Blockstudio να έχουν το ίδιο εικονίδιο.