Άγκιστρα PHP
Παρακάτω θα βρείτε τη λίστα με όλα τα διαθέσιμα άγκιστρα PHP που μπορείτε να χρησιμοποιήσετε για να επεκτείνετε ή να προσαρμόσετε τη λειτουργικότητα του πρόσθετου.
Διαδρομή
Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε τη διαδρομή του φακέλου μπλοκ. Από προεπιλογή, βρίσκεται blockstudio μέσα στο ενεργό θέμα. Εναλλακτικά, μπορείτε να δημιουργήσετε μια νέα παρουσία για πολλούς καταλόγους πηγαίου κώδικα.
add_filter('blockstudio/path', function() {
$path = get_stylesheet_directory() . '/blocks';
return $path;
});
Αρχικοποίηση
καθολικό
Αυτή η ενέργεια εκτελείται αφού το πρόσθετο καταχωρίσει όλα τα μπλοκ.
add_action('blockstudio/init', function($blocks) {
// All blocks have been registered
});
παρουσία
Αυτή η ενέργεια εκτελείται αφού το πρόσθετο καταχωρίσει όλα τα μπλοκ μιας συγκεκριμένης παρουσίας.
Το τμήμα $instance είναι η διαδρομή της παρουσίας σε σχέση με το wp-content.
$instance = 'themes/my-theme/client-blocks';
add_action("blockstudio/init/$instance", function() {
// All blocks of this instance have been registered
});
global/before
Αυτή η ενέργεια εκτελείται πριν το πρόσθετο καταχωρίσει όλα τα μπλοκ.
add_action('blockstudio/init/before', function() {
// Before blocks are registered
});
global/before/$instance
Αυτή η ενέργεια εκτελείται πριν το πρόσθετο καταχωρίσει όλα τα μπλοκ μιας συγκεκριμένης παρουσίας.
$instance = 'themes/my-theme/client-blocks';
add_action("blockstudio/init/before/$instance", function() {
// Before blocks of this instance are registered
});
Μπλοκ
Απόδοση
Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε την έξοδο ενός μπλοκ πριν αποδοθεί.
add_filter('blockstudio/blocks/render', function($content, $block, $attributes) {
// Modify the block content
return $content;
}, 10, 3);
Μεταδεδομένα
Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε τα δεδομένα του αρχείου block.json πριν αυτό καταχωριστεί.
add_filter('blockstudio/blocks/meta', function($meta, $block) {
if (str_starts_with($block['name'], 'marketing')) {
$meta['icon'] = 'megaphone';
}
return $meta;
}, 10, 2);
Ο παραπάνω κώδικας θα άλλαζε το εικονίδιο όλων των μπλοκ που αρχίζουν με marketing.
Συνθήκες
Αυτό το φίλτρο σάς επιτρέπει να προσθέτετε προσαρμοσμένες συνθήκες που μπορούν να χρησιμοποιηθούν μέσα σε blocks. Κάθε τύπος συνθήκης αντιστοιχεί σε μια τιμή με την οποία ο επεξεργαστής συγκρίνει το value της συνθήκης. Δείτε τις Προσαρμοσμένες συνθήκες.
add_filter('blockstudio/blocks/conditions', function($conditions) {
$conditions['myCustomCondition'] = 'expected';
return $conditions;
});
Χαρακτηριστικά
Αυτό το φίλτρο προσαρμόζει έναν ορισμό πεδίου πριν καταχωριστεί το μπλοκ. Ο φιλτραρισμένος ορισμός καθορίζει το στοιχείο ελέγχου στον επεξεργαστή και την επικύρωση της τιμής κατά την απόδοση. Δείτε την ενότητα Φιλτράρισμα για περισσότερες πληροφορίες.
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
// Modify this field definition before registration.
return $attribute;
}, 10, 2);
attributes/render
Αυτό το φίλτρο προσαρμόζει την τιμή ενός πεδίου πριν αυτή περάσει στο πρότυπο του block. Εκτελείται μία φορά ανά πεδίο και λαμβάνει τρία ορίσματα: το $value (την επιλυμένη τιμή), το $key (το κλειδί του πεδίου, όπως χρησιμοποιείται στο $a) και το $block (τον πίνακα δεδομένων του block που λαμβάνουν τα πρότυπα ως $block ή $b). Καταχωρίστε το με τρία αποδεκτά ορίσματα. Για περισσότερες πληροφορίες, δείτε το θέμα Φιλτράρισμα.
add_filter('blockstudio/blocks/attributes/render', function($value, $key, $block) {
// Modify the value of one field before rendering.
return $value;
}, 10, 3);
attributes/files/sizes
Ένα πεδίο files επιστρέφει κάθε εικόνα μαζί με έναν πίνακα sizes που περιέχει το URL, το πλάτος και το ύψος του full και κάθε καταχωρισμένου μεγέθους εικόνας, για παράδειγμα τα $image['sizes']['thumbnail'] και $image['sizes']['thumbnail-width']. Κάθε μέγεθος προκαλεί μία κλήση wp_get_attachment_image_src() ανά εικόνα, επομένως τα φίλτρα του εξακολουθούν να εφαρμόζονται. Τα πρότυπα που δεν διαβάζουν ποτέ το sizes μπορούν να αφαιρέσουν τη λίστα ή να τη συντομεύσουν.
add_filter('blockstudio/blocks/attributes/files/sizes', function($sizes, $id, $size) {
// Keep only two sizes. Return an empty array to skip them, `sizes` is then null.
return ['full', 'large'];
}, 10, 3);
Το $sizes είναι η λίστα ονομάτων μεγεθών, με πρώτο το full (κενό αν δεν έχουν καταχωριστεί ενδιάμεσα μεγέθη). Το $id είναι το ID συνημμένου και το $size το μέγεθος που ζητήθηκε για το url της τιμής. Το φίλτρο αλλάζει τον πίνακα sizes κάθε τιμής αρχείου στο αίτημα. Χωρίς αυτό, ο πίνακας παραμένει αμετάβλητος.
Επιστρέψτε τα ονόματα των μεγεθών ως συμβολοσειρές. Οι μη έγκυρες εγγραφές αγνοούνται, ενώ τα διπλότυπα ονόματα επιλύονται μία φορά. Αν η επιστρεφόμενη τιμή δεν είναι πίνακας, τα μεγέθη παραλείπονται. Το ζητούμενο url και οι υπόλοιπες ιδιότητες συνημμένου παραμένουν αμετάβλητα. Αυτό το hook δεν εκτελείται για πεδίο files με returnFormat: "url", το οποίο δεν δημιουργεί χάρτη μεγεθών.
attributes/validate
Προσαρμόστε τα ευρήματα από ρητές κλήσεις bs_validate_block(), για παράδειγμα όταν ένα προσαρμοσμένο φίλτρο απόδοσης επιλύει αποθηκευμένες αναφορές. Αυτό δεν ενεργοποιεί την αυτόματη επικύρωση κατά την αποθήκευση ή την απόδοση.
add_filter('blockstudio/blocks/attributes/validate', function($findings, $name, $attrs) {
return $findings;
}, 10, 3);
Επιστρέψτε μια λίστα ευρημάτων. Το φίλτρο δεν καλείται όταν το μπλοκ δεν έχει πεδία Blockstudio ή αντίστοιχες επεκτάσεις (null).
attributes/schema
Προσαρμόστε το Schema JSON που επιστρέφεται από το bs_block_schema(), για παράδειγμα όταν ένα προσαρμοσμένο φίλτρο απόδοσης επιλύει αποθηκευμένες αναφορές.
add_filter('blockstudio/blocks/attributes/schema', function($schema, $name) {
return $schema;
}, 10, 2);
Επιστρέψτε τον πίνακα schema. Το φίλτρο δεν καλείται όταν το μπλοκ δεν έχει πεδία Blockstudio ή αντίστοιχες επεκτάσεις (null).
attributes/populate
Αυτό το φίλτρο σάς επιτρέπει να προσθέσετε προσαρμοσμένα δεδομένα στις επιλογές ενός πεδίου checkbox, select ή radio. Δείτε την ενότητα Συμπλήρωση επιλογών για περισσότερες πληροφορίες.
Το φίλτρο λαμβάνει ένα όρισμα: έναν πίνακα με όλα τα προσαρμοσμένα σύνολα δεδομένων, ταξινομημένα βάσει του ονόματος που χρησιμοποιείται στο "populate": {"type": "custom", "custom": "myCustomOptions"}.
add_filter('blockstudio/blocks/attributes/populate', function($options) {
$options['myCustomOptions'] = [
['value' => '1', 'label' => 'Option 1'],
['value' => '2', 'label' => 'Option 2'],
];
return $options;
});
components/use_block_props/render
Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε την έξοδο του περιεχομένου useBlockProps.
Όλα τα φίλτρα στοιχείων (use_block_props, inner_blocks και rich_text) λαμβάνουν το μπλοκ ως τελευταίο όρισμα. Το $block είναι το WP_Block_Type που έχει καταχωριστεί για το μπλοκ που αποδίδεται, επομένως το $block->name είναι το όνομα του μπλοκ, για παράδειγμα acme/hero.
Το $props είναι συμβολοσειρά χαρακτηριστικών HTML, όχι πίνακας. Στο frontend είναι το αποτέλεσμα του get_block_wrapper_attributes(), για παράδειγμα class="wp-block-acme-hero my-class". Στον επεξεργαστή είναι το χαρακτηριστικό class του στοιχείου. Επιστρέψτε μια συμβολοσειρά. Στον επεξεργαστή εφαρμόζεται μόνο το χαρακτηριστικό class της συμβολοσειράς που επιστρέφεται.
add_filter('blockstudio/blocks/components/use_block_props/render', function($props, $block) {
if ($block->name !== 'acme/hero') {
return $props;
}
return str_replace('class="', 'class="my-custom-class ', $props);
}, 10, 2);
components/inner_blocks/render
Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε την έξοδο του περιεχομένου <InnerBlocks />.
add_filter('blockstudio/blocks/components/inner_blocks/render', function($content, $block) {
return '<div class="inner-wrapper">' . $content . '</div>';
}, 10, 2);
components/inner_blocks/frontend/wrap
Αυτό το φίλτρο σάς επιτρέπει να αφαιρέσετε το περιτύλιγμα <InnerBlocks /> από το frontend.
add_filter('blockstudio/blocks/components/inner_blocks/frontend/wrap', function($wrap, $block) {
return false; // Remove wrapper
}, 10, 2);
components/rich_text/render
Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε την έξοδο του περιεχομένου <RichText />. Λαμβάνει την τιμή του χαρακτηριστικού και το μπλοκ.
add_filter('blockstudio/blocks/components/rich_text/render', function($content, $block) {
return wp_kses_post($content);
}, 10, 2);
Ετικέτες μπλοκ
blockstudio/block_tags/builders
Αυτό το φίλτρο καταχωρίζει builders πίνακα μπλοκ που χρησιμοποιούνται από τις ετικέτες μπλοκ και από προσαρμοσμένα μπλοκ που επιλέγονται μέσω του blockstudio/parser/element_mapping. Κάθε builder λαμβάνει αναλυμένα χαρακτηριστικά και το ακατέργαστο εσωτερικό περιεχόμενο.
add_filter('blockstudio/block_tags/builders', function($builders, $parser) {
$builders['theme/paragraph'] = function(array $attributes, string $inner) {
$attributes['content'] = trim($inner);
return [
'blockName' => 'theme/paragraph',
'attrs' => [
'blockstudio' => [
'attributes' => $attributes,
],
],
'innerBlocks' => [],
'innerHTML' => '',
'innerContent' => [],
];
};
return $builders;
}, 10, 2);
Τα συμβατά φίλτρα blockstudio/block_tags/renderers και blockstudio/parser/renderers εκτελούνται μετά από αυτό το hook και μπορούν να παρακάμψουν το ίδιο όνομα μπλοκ.
blockstudio/block_tags/tag_aliases
Αυτό το φίλτρο σάς επιτρέπει να καταχωρίζετε προσαρμοσμένες ετικέτες συγγραφής με παύλες, οι οποίες αντιστοιχίζονται σε πραγματικά ονόματα μπλοκ πριν από την εφεδρική χρήση ακατέργαστου HTML. Είναι χρήσιμο όταν ένα θέμα χρειάζεται ένα συνοπτικό σύνολο ετικετών ειδικό για το έργο, διατηρώντας παράλληλα τη δυνατότητα απόδοσης τυπικών Blockstudio ή βασικών μπλοκ.
add_filter('blockstudio/block_tags/tag_aliases', function($aliases) {
$aliases['theme-button'] = 'bsui/button';
$aliases['theme-card'] = 'theme/card';
return $aliases;
});
<theme-button href="/download" label="Download" />
<theme-card title="Fast authoring">
<p>Children are parsed as nested blocks.</p>
</theme-card>
blockstudio/block_tags/prefixes
Αυτό το φίλτρο σάς επιτρέπει να αντιστοιχίζετε συντομογραφίες προθεμάτων σε έναν ή περισσότερους χώρους ονομάτων μπλοκ. Κάθε κλειδί είναι ένα πεζό πρόθεμα χωρίς παύλες. Κάθε τιμή μπορεί να είναι μια συμβολοσειρά χώρου ονομάτων ή μια ταξινομημένη λίστα χώρων ονομάτων.
add_filter('blockstudio/block_tags/prefixes', function($prefixes) {
$prefixes['theme'] = ['theme-components', 'bsui'];
return $prefixes;
});
<theme-card title="Homepage" />
<theme-button label="Get started" />
<theme-ui-feature-matrix />
Το <theme-card> επιλύεται σε theme-components/card. Το <theme-button> δοκιμάζει πρώτα το theme-components/button και, αν αποτύχει, χρησιμοποιεί το bsui/button. Οι ρητές καταχωρίσεις blockstudio/block_tags/tag_aliases έχουν προτεραιότητα για την ίδια ετικέτα και οι ετικέτες με πρόθεμα που δεν επιλύονται παραμένουν αμετάβλητες.
Τα προθέματα συνδυάζονται: αν μια ετικέτα με πρόθεμα δεν επιλυθεί απευθείας και το slug της είναι από μόνο του καταχωρισμένη ετικέτα προθέματος, η επίλυση γίνεται αναδρομικά. Με τα theme => ['theme-components'] και ui => ['bsui'], το <theme-ui-input> περνά στο πρόθεμα ui και επιλύεται σε bsui/input. Οι καταχωρισμένες ετικέτες προθεμάτων και ψευδωνύμων αποδίδονται επίσης στην έξοδο προτύπων μπλοκ, όχι μόνο στο περιεχόμενο σελίδων.
Ρυθμίσεις
διαδρομή
Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε τη διαδρομή του αρχείου blockstudio.json. Από προεπιλογή, βρίσκεται στη θέση blockstudio.json μέσα στο ενεργό θέμα.
add_filter('blockstudio/settings/path', function() {
return get_stylesheet_directory() . '/config/blockstudio.json';
});
users/ids
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε τον επεξεργαστή για συγκεκριμένα αναγνωριστικά χρηστών.
add_filter('blockstudio/settings/users/ids', function() {
return [1];
});
users/roles
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε τον επεξεργαστή για συγκεκριμένους ρόλους χρηστών.
add_filter('blockstudio/settings/users/roles', function() {
return ['administrator', 'editor'];
});
assets/enqueue
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε τη φόρτωση πόρων στο frontend και στον επεξεργαστή.
add_filter('blockstudio/settings/assets/enqueue', function() {
return false;
});
assets/reset/enabled
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε την αφαίρεση των βασικών στυλ μπλοκ του WordPress και την επαναφορά διάταξης βοηθητικών στοιχείων του επεξεργαστή.
add_filter('blockstudio/settings/assets/reset/enabled', function() {
return true;
});
assets/reset/full_width
Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε ποιοι τύποι αναρτήσεων χρησιμοποιούν επεξεργασία πλήρους πλάτους.
add_filter('blockstudio/settings/assets/reset/full_width', function() {
return ['page'];
});
assets/minify/css
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε την ελαχιστοποίηση του CSS.
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
assets/minify/js
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε την ελαχιστοποίηση του JS.
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
assets/process/scss
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε την επεξεργασία του SCSS σε αρχεία .css.
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
assets/process/scss_files
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε την επεξεργασία αρχείων .scss σε CSS.
add_filter('blockstudio/settings/assets/process/scss_files', function() {
return true;
});
assets/output
Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε πού αποθηκεύονται τα μεταγλωττισμένα στοιχεία μπλοκ.
add_filter('blockstudio/settings/assets/output', function() {
return 'cache';
});
assets/inline_limit
Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε πόσα byte εξωτερικού μπλοκ CSS ενσωματώνονται ανά σελίδα.
add_filter('blockstudio/settings/assets/inline_limit', function() {
return 40000;
});
cache/enabled
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε όλες τις προσωρινές μνήμες πόρων εκτέλεσης και επεξεργαστή που βασίζονται σε αρχεία Blockstudio.
add_filter('blockstudio/settings/cache/enabled', function() {
return false;
});
cache/path
Αυτό το φίλτρο σάς επιτρέπει να αλλάξετε τον κατάλογο προσωρινής μνήμης του Blockstudio που βασίζεται σε αρχεία.
add_filter('blockstudio/settings/cache/path', function() {
return 'cache/blockstudio';
});
cache/namespace_grace
Αυτό το φίλτρο σάς επιτρέπει να αλλάξετε για πόσο διατηρείται ένας παλιός χώρος ονομάτων προσωρινής μνήμης πριν από τη συλλογή του.
add_filter('blockstudio/settings/cache/namespace_grace', function() {
return 777600;
});
githooks/commit
Αυτό το φίλτρο δείχνει αν είναι ενεργό το hook commit του Blockstudio με ιδιοκτησία PHPStan.
add_filter('blockstudio/settings/githooks/commit', function() {
return true;
});
content/enabled
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε τον Συγχρονισμό περιεχομένου.
add_filter('blockstudio/settings/content/enabled', function() {
return true;
});
content/id
Αυτό το φίλτρο σάς επιτρέπει να ορίσετε τον χώρο ονομάτων ιδιοκτησίας του Συγχρονισμού περιεχομένου.
add_filter('blockstudio/settings/content/id', function() {
return 'docs';
});
content/path
Αυτό το φίλτρο σάς επιτρέπει να ορίσετε τον κατάλογο αρχείων του Συγχρονισμού περιεχομένου.
add_filter('blockstudio/settings/content/path', function() {
return 'content';
});
content/include_page_sync_managed
Αυτό το φίλτρο σάς επιτρέπει να συμπεριλάβετε ή να εξαιρέσετε αναρτήσεις που διαχειρίζεται ο Συγχρονισμός σελίδων.
add_filter('blockstudio/settings/content/include_page_sync_managed', function() {
return false;
});
content/authors
Αυτό το φίλτρο σάς επιτρέπει να διαμορφώσετε τον χειρισμό συντακτών από τον Συγχρονισμό περιεχομένου.
add_filter('blockstudio/settings/content/authors', function() {
return 'ignore';
});
content/post_types
Αυτό το φίλτρο σάς επιτρέπει να διαμορφώσετε τις λίστες επιτρεπόμενων τύπων αναρτήσεων του Συγχρονισμού περιεχομένου.
add_filter('blockstudio/settings/content/post_types', function() {
return ['team_member'];
});
content/taxonomies
Αυτό το φίλτρο σάς επιτρέπει να διαμορφώσετε τις λίστες επιτρεπόμενων ταξινομιών του Συγχρονισμού περιεχομένου.
add_filter('blockstudio/settings/content/taxonomies', function() {
return ['category', 'post_tag'];
});
content/media
Αυτό το φίλτρο σάς επιτρέπει να διαμορφώσετε τον χειρισμό πολυμέσων από τον Συγχρονισμό περιεχομένου.
add_filter('blockstudio/settings/content/media', function() {
return 'manifest';
});
tailwind/enabled
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε το Tailwind.
add_filter('blockstudio/settings/tailwind/enabled', function() {
return true;
});
tailwind/config
Αυτό το φίλτρο σάς επιτρέπει να προσθέσετε μια προσαρμοσμένη διαμόρφωση Tailwind CSS.
add_filter('blockstudio/settings/tailwind/config', function() {
return '@theme { --color-primary: pink; }';
});
tailwind/output
Αυτό το φίλτρο σάς επιτρέπει να επιλέξετε έξοδο Tailwind CSS ενσωματωμένη ή μέσω συνδέσμου.
add_filter('blockstudio/settings/tailwind/output', function() {
return 'link';
});
ui/enabled
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε τα ενσωματωμένα στοιχεία UI.
add_filter('blockstudio/settings/ui/enabled', function() {
return true;
});
editor/format_on_save
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε τη μορφοποίηση κώδικα κατά την αποθήκευση.
add_filter('blockstudio/settings/editor/format_on_save', function() {
return true;
});
editor/assets
Αυτό το φίλτρο σάς επιτρέπει να φορτώσετε πρόσθετους πόρους στον επεξεργαστή.
add_filter('blockstudio/settings/editor/assets', function() {
return ['my-stylesheet', 'another-stylesheet'];
});
editor/markup
Αυτό το φίλτρο σάς επιτρέπει να προσθέσετε επιπλέον σήμανση στο τέλος του επεξεργαστή.
add_filter('blockstudio/settings/editor/markup', function() {
return '<style>body { background: black; }</style>';
});
block_editor/disable_loading
Αυτό το φίλτρο σάς επιτρέπει να απενεργοποιήσετε τη φόρτωση μπλοκ μέσα στον Επεξεργαστή μπλοκ.
add_filter('blockstudio/settings/block_editor/disable_loading', function() {
return true;
});
block_editor/enhance
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε τις διευκολύνσεις επεξεργασίας του Blockstudio, όπως καθαρότερα στυλ εστίασης και περιγράμματα κατά την αιώρηση ή την επιλογή.
add_filter('blockstudio/settings/block_editor/enhance', function() {
return true;
});
block_editor/css_classes
Αυτό το φίλτρο σάς επιτρέπει να προσθέσετε φύλλα στυλ των οποίων οι κλάσεις θα είναι διαθέσιμες για επιλογή στο πεδίο κλάσης.
add_filter('blockstudio/settings/block_editor/css_classes', function() {
return ['my-stylesheet', 'another-stylesheet'];
});
block_editor/css_variables
Αυτό το φίλτρο σάς επιτρέπει να προσθέσετε φύλλα στυλ των οποίων οι μεταβλητές CSS θα είναι διαθέσιμες για αυτόματη συμπλήρωση στο πεδίο κώδικα.
add_filter('blockstudio/settings/block_editor/css_variables', function() {
return ['my-stylesheet', 'another-stylesheet'];
});
block_editor/blocks/allow
Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε ποια ονόματα μπλοκ επιτρέπονται στο εργαλείο εισαγωγής.
add_filter('blockstudio/settings/block_editor/blocks/allow', function() {
return ['core/*', 'acf/*', 'my-theme/*'];
});
block_editor/blocks/deny
Αυτό το φίλτρο σάς επιτρέπει να αφαιρείτε ονόματα μπλοκ από το εργαλείο εισαγωγής.
add_filter('blockstudio/settings/block_editor/blocks/deny', function() {
return ['core/embed', 'core/freeform'];
});
block_editor/blocks/directory
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε τους πόρους καταλόγου μπλοκ του WordPress στον επεξεργαστή.
add_filter('blockstudio/settings/block_editor/blocks/directory', function() {
return false;
});
block_editor/blocks/categories/allow
Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε ποια slug κατηγοριών μπλοκ παραμένουν διαθέσιμα.
add_filter('blockstudio/settings/block_editor/blocks/categories/allow', function() {
return ['text', 'media', 'design'];
});
block_editor/blocks/categories/deny
Αυτό το φίλτρο σάς επιτρέπει να αφαιρείτε slug κατηγοριών μπλοκ από το εργαλείο εισαγωγής.
add_filter('blockstudio/settings/block_editor/blocks/categories/deny', function() {
return ['embed'];
});
block_editor/blocks/categories/rename
Αυτό το φίλτρο σάς επιτρέπει να μετονομάζετε τις ετικέτες κατηγοριών μπλοκ βάσει slug.
add_filter('blockstudio/settings/block_editor/blocks/categories/rename', function() {
return [
'text' => 'Writing',
'design' => 'Layout'
];
});
block_editor/blocks/categories/order
Αυτό το φίλτρο σάς επιτρέπει να ορίζετε τη σειρά των slug κατηγοριών μπλοκ στο εργαλείο εισαγωγής.
add_filter('blockstudio/settings/block_editor/blocks/categories/order', function() {
return ['my-theme', 'text', 'media'];
});
block_editor/blocks/styles/deny
Αυτό το φίλτρο σάς επιτρέπει να καταργείτε την καταχώριση στυλ μπλοκ που καταχωρίστηκαν από το PHP, βάσει ονόματος μπλοκ.
add_filter('blockstudio/settings/block_editor/blocks/styles/deny', function() {
return [
'my-theme/card' => ['outline'],
'my-theme/media' => ['framed']
];
});
block_editor/blocks/legacy_widgets/hide
Αυτό το φίλτρο σάς επιτρέπει να αποκρύπτετε επιπλέον παλιά widget από το μπλοκ παλιών widget.
add_filter('blockstudio/settings/block_editor/blocks/legacy_widgets/hide', function() {
return ['archives', 'calendar'];
});
block_editor/patterns/core
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε τα βασικά μοτίβα μπλοκ του WordPress.
add_filter('blockstudio/settings/block_editor/patterns/core', function() {
return false;
});
block_editor/patterns/remote
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε απομακρυσμένα μοτίβα από τον κατάλογο μοτίβων του WordPress.
add_filter('blockstudio/settings/block_editor/patterns/remote', function() {
return false;
});
block_editor/patterns/theme
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε μοτίβα μπλοκ που παρέχονται από το θέμα.
add_filter('blockstudio/settings/block_editor/patterns/theme', function() {
return false;
});
block_editor/patterns/blockstudio
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε μοτίβα του Blockstudio που βασίζονται σε αρχεία.
add_filter('blockstudio/settings/block_editor/patterns/blockstudio', function() {
return false;
});
block_editor/patterns/categories/allow
Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε ποια slug κατηγοριών μοτίβων παραμένουν διαθέσιμα.
add_filter('blockstudio/settings/block_editor/patterns/categories/allow', function() {
return ['featured', 'buttons', 'columns'];
});
block_editor/patterns/categories/deny
Αυτό το φίλτρο σάς επιτρέπει να αφαιρείτε slug κατηγοριών μοτίβων από το εργαλείο εισαγωγής μοτίβων.
add_filter('blockstudio/settings/block_editor/patterns/categories/deny', function() {
return ['gallery'];
});
block_editor/patterns/categories/rename
Αυτό το φίλτρο σάς επιτρέπει να μετονομάζετε τις ετικέτες κατηγοριών μοτίβων βάσει slug.
add_filter('blockstudio/settings/block_editor/patterns/categories/rename', function() {
return [
'featured' => 'Featured Layouts'
];
});
block_editor/patterns/categories/order
Αυτό το φίλτρο σάς επιτρέπει να ορίζετε τη σειρά των slug κατηγοριών μοτίβων στο εργαλείο εισαγωγής.
add_filter('blockstudio/settings/block_editor/patterns/categories/order', function() {
return ['featured', 'buttons'];
});
block_editor/media/openverse
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε την κατηγορία πολυμέσων Openverse στο εργαλείο εισαγωγής πολυμέσων του επεξεργαστή μπλοκ.
add_filter('blockstudio/settings/block_editor/media/openverse', function() {
return false;
});
block_editor/media/image_sizes/allow
Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε ποια ονόματα μεγεθών εικόνας παραμένουν διαθέσιμα στα στοιχεία ελέγχου πολυμέσων του επεξεργαστή.
add_filter('blockstudio/settings/block_editor/media/image_sizes/allow', function() {
return ['thumbnail', 'large'];
});
block_editor/media/image_sizes/deny
Αυτό το φίλτρο σάς επιτρέπει να αφαιρείτε ονόματα μεγεθών εικόνας από τα στοιχεία ελέγχου πολυμέσων του επεξεργαστή.
add_filter('blockstudio/settings/block_editor/media/image_sizes/deny', function() {
return ['medium_large'];
});
ai/enable_context_generation
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε τη δημιουργία αρχείου περιβάλλοντος για την ενσωμάτωση εργαλείων LLM. Όταν είναι ενεργό, το αρχείο περιβάλλοντος συγκεντρώνει ενημερωμένα δεδομένα μπλοκ, ρυθμίσεις Blockstudio της τρέχουσας εγκατάστασης, όλα τα σχετικά σχήματα και την τεκμηρίωση Blockstudio σε μία πηγή για χρήση με εργαλεία ανάπτυξης ΤΝ.
add_filter('blockstudio/settings/ai/enable_context_generation', function() {
return true;
});
block_tags/enabled
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε την απόδοση ετικετών μπλοκ σε επίπεδο σελίδας.
add_filter('blockstudio/settings/block_tags/enabled', function() {
return true;
});
block_tags/prefixes
Αυτό το φίλτρο σάς επιτρέπει να καταχωρίζετε συντομογραφίες προθεμάτων για χώρους ονομάτων στις ετικέτες μπλοκ.
add_filter('blockstudio/settings/block_tags/prefixes', function() {
return [
'theme' => ['theme-components', 'bsui']
];
});
dev/grab/enabled
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε το εργαλείο επιλογής στοιχείων.
add_filter('blockstudio/settings/dev/grab/enabled', function() {
return false;
});
dev/perf
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε το εργαλείο ανάλυσης επιδόσεων.
add_filter('blockstudio/settings/dev/perf', function() {
return false;
});
dev/canvas/enabled
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε τον καμβά.
add_filter('blockstudio/settings/dev/canvas/enabled', function() {
return false;
});
dev/canvas/admin_bar
Αυτό το φίλτρο σάς επιτρέπει να εμφανίζετε ή να αποκρύπτετε τη γραμμή διαχείρισης του WordPress στον καμβά.
add_filter('blockstudio/settings/dev/canvas/admin_bar', function() {
return true;
});
WPML
blockstudio/wpml/config/label
Φιλτράρει την ετικέτα κάθε κλειδιού που γράφει το wp bs wpml config. Για τον πίνακα περιβάλλοντος, δείτε Αλλαγή των ετικετών.
add_filter('blockstudio/wpml/config/label', function($label, $context) {
return str_replace(' (optional)', '', $label);
}, 10, 2);
Καμβάς
blockstudio/canvas/inventory
Αυτό το φίλτρο προσαρμόζει τα δεδομένα απογραφής που αναφέρει ο καμβάς για μια επιλογή. Η συνάρτηση επανάκλησης λαμβάνει το DTO απογραφής, την αρχική επιλογή και τις επιλογές με τις οποίες κλήθηκε.
add_filter('blockstudio/canvas/inventory', function(array $result, array $selection, array $options) {
return $result;
}, 10, 3);
blockstudio/canvas/documents
Αυτό το φίλτρο προσαρμόζει τα αποδιδόμενα έγγραφα που επιστρέφει ο καμβάς, με τα ίδια τρία ορίσματα όπως το φίλτρο απογραφής.
blockstudio/canvas/item_loaded
Αυτή η ενέργεια εκτελείται μία φορά για κάθε εγγραφή απογραφής κατά τη φόρτωσή της και λαμβάνει τον τύπο απογραφής, το κανονικό αναγνωριστικό εγγραφής και την κανονικοποιημένη εγγραφή.
blockstudio/canvas/source_compiled
Αυτή η ενέργεια εκτελείται μετά τη μεταγλώττιση ενός αρχείου πηγαίου κώδικα για τον καμβά και λαμβάνει την επιλεγμένη διαδρομή πηγαίου κώδικα και την κανονική εγγραφή πηγής.
Ενσωματωμένα UI
blockstudio/ui/directories
Αυτό το φίλτρο προσαρμόζει τους καταλόγους που σαρώνονται για ενσωματωμένα στοιχεία UI.
blockstudio/ui/inventory
Αυτό το φίλτρο προσαρμόζει τη δημόσια απογραφή οικογενειών UI.
blockstudio/ui/examples
Αυτό το φίλτρο προσαρμόζει τις εγγραφές παραδειγμάτων UI και λαμβάνει τα παραδείγματα μαζί με τη δημόσια απογραφή UI από την οποία προέκυψαν.
Τοπολογία
blockstudio/blocks/topology_refreshed
Αυτή η ενέργεια εκτελείται μετά την αναδημιουργία της τοπολογίας μπλοκ.
blockstudio/pages/topology_refreshed
Αυτή η ενέργεια εκτελείται μετά την αναδημιουργία της τοπολογίας σελίδων.
blockstudio/pages/layout_error
Αυτή η ενέργεια εκτελείται όταν αποτυγχάνει η απόδοση μιας διάταξης σελίδας, αντί να αποτύχει σιωπηρά.
Περιβάλλον εκτέλεσης
blockstudio/runtime/initialized
Αυτή η ενέργεια εκτελείται μόλις το περιβάλλον εκτέλεσης επιλύσει τις ρυθμίσεις του.
blockstudio/runtime/changed
Αυτή η ενέργεια εκτελείται όταν αλλάζει η επιλυμένη ταυτότητα του περιβάλλοντος εκτέλεσης, κάτι που μετακινεί τους χώρους ονομάτων της προσωρινής μνήμης και την κατάσταση στατικής προαπόδοσης.
blockstudio/performance/default_config
Αυτό το φίλτρο προσαρμόζει τις προεπιλεγμένες ρυθμίσεις επιδόσεων πριν προστεθούν οι τιμές blockstudio.json του ίδιου του έργου.
Περιεχόμενο
blockstudio/content/orphan_action
Αυτό το φίλτρο καθορίζει τι κάνει ο Συγχρονισμός περιεχομένου με μια εγγραφή που δεν έχει πλέον πηγή.
Bootstrap
blockstudio/url
Αυτό το φίλτρο αλλάζει το δημόσιο URL που χρησιμοποιείται για τα στοιχεία επεξεργαστή και διαχείρισης του Blockstudio. Οι ενσωματώσεις του Composer πρέπει να το καταχωρίσουν πριν φορτώσουν το αρχείο αυτόματης φόρτωσης του Blockstudio. Το δεύτερο όρισμα είναι ο φυσικός κατάλογος του πακέτου.
add_filter(
'blockstudio/url',
function(string $url, string $directory) {
return get_stylesheet_directory_uri() . '/vendor/blockstudio/blockstudio/';
},
10,
2
);
Προσωρινή μνήμη περιβάλλοντος εκτέλεσης
blockstudio/cache/dir
Αυτό το φίλτρο λαμβάνει τον επιλυμένο βασικό κατάλογο της προσωρινής μνήμης πριν προστεθεί οποιοδήποτε εύρος προσωρινής μνήμης περιβάλλοντος εκτέλεσης, πόρων επεξεργαστή ή άλλου τύπου.
add_filter('blockstudio/cache/dir', function(string $directory) {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
blockstudio/cache/context
Αυτό το φίλτρο προσθέτει μια σειριοποιήσιμη παραλλαγή περιβάλλοντος εκτέλεσης στις ταυτότητες της προσωρινής μνήμης. Χρησιμοποιήστε το όταν η ίδια πηγή εντοπισμού μπορεί να επιλέγει διαφορετικές λογικές απογραφές.
add_filter('blockstudio/cache/context', function($context, string $scope) {
return [
'preview' => get_query_var('preview_id'),
'site' => get_current_blog_id(),
];
}, 10, 2);
blockstudio/cache/site_key
Αυτό το φίλτρο αλλάζει την ταυτότητα καταλόγου δικτύου/blog για κεντρικούς υπολογιστές με δικό τους όριο μισθωτή. Η τιμή που επιστρέφεται καθαρίζεται πριν από τη χρήση.
add_filter(
'blockstudio/cache/site_key',
function(string $key, int $networkId, int $blogId) {
return sprintf('tenant-%d-%d', $networkId, $blogId);
},
10,
3
);
blockstudio/runtime/identity
Αυτό το φίλτρο προσθέτει δεδομένα κεντρικού υπολογιστή που επηρεάζουν κάθε αντικείμενο σε ένα εύρος περιβάλλοντος εκτέλεσης. Τα αποτυπώματα πηγών για συγκεκριμένα στοιχεία πρέπει να περνούν ως ρητές εξαρτήσεις από το αντίστοιχο API.
add_filter(
'blockstudio/runtime/identity',
function(array $identity, string $scope) {
$identity['deployment'] = getenv('RELEASE_SHA') ?: 'local';
return $identity;
},
10,
2
);
blockstudio/cache/watch_debounce
Φιλτράρει τον αριθμό των δευτερολέπτων για τα οποία μπορεί να επαναχρησιμοποιηθεί ένα επικυρωμένο στιγμιότυπο παρακολούθησης αρχείων χωρίς νέα σάρωση στατιστικών του συστήματος αρχείων. Η προεπιλογή είναι 0 σε τοπικά περιβάλλοντα και περιβάλλοντα ανάπτυξης και 20 αλλού.
add_filter('blockstudio/cache/watch_debounce', function() {
return 30;
});
blockstudio/cache/build_wait_budget
Φιλτράρει για πόσο χρόνο, σε χιλιοστά του δευτερολέπτου, περιμένει ένα αίτημα να δημοσιεύσει ένας παράλληλος builder την προσωρινή μνήμη περιβάλλοντος εκτέλεσης ή να ανανεωθούν οι συμπληρωμένες επιλογές, πριν υποβαθμιστεί. Η προεπιλογή είναι 5000 για δομικές αναδημιουργίες και 4000 για ανανεώσεις επιλογών.
add_filter('blockstudio/cache/build_wait_budget', function() {
return 2000;
});
blockstudio/cache/populate_debounce
Φιλτράρει για πόσα δευτερόλεπτα συνενώνονται σε μία ανανέωση συμπληρωμένων επιλογών οι διαδοχικές εγγραφές περιεχομένου, όρου, χρήστη ή μεταδεδομένων. Η πρώτη εγγραφή μετά από περίοδο αδράνειας προκαλεί άμεση ανανέωση· η τελευταία εγγραφή μιας ακολουθίας εμφανίζεται μετά την παρέλευση του χρονικού διαστήματος. Η προεπιλογή είναι 30. Επιστρέψτε 0 για ανανέωση σε κάθε εγγραφή.
add_filter('blockstudio/cache/populate_debounce', function() {
return 120;
});
blockstudio/cache/populate_ignored_meta_keys
Φιλτράρει τα κλειδιά meta των οποίων οι εγγραφές δεν ανανεώνουν ποτέ τις συμπληρωμένες επιλογές. Από προεπιλογή, αυτά είναι τα κλειδιά που το WordPress γράφει για την παρακολούθηση επεξεργασίας και σύνδεσης: _edit_lock, που ανανεώνεται από τον επεξεργαστή και το Heartbeat όσο μια δημοσίευση είναι ανοιχτή, _edit_last, που γράφεται μαζί με μια αποθήκευση δημοσίευσης η οποία ούτως ή άλλως προκαλεί ανανέωση, και session_tokens, που γράφεται κατά τη σύνδεση και την αποσύνδεση. Προσθέστε κλειδιά που αλλάζουν συχνά, αλλά δεν επηρεάζουν ποτέ ένα ερώτημα συμπλήρωσης.
add_filter('blockstudio/cache/populate_ignored_meta_keys', function(array $keys) {
$keys[] = '_my_view_counter';
return $keys;
});
blockstudio/cache/max_files_per_scope
Φιλτράρει πόσα δημοσιευμένα ωφέλιμα φορτία διατηρεί κάθε εύρος προσωρινής μνήμης περιβάλλοντος εκτέλεσης.
add_filter('blockstudio/cache/max_files_per_scope', function($maximum, $scope) {
return $scope === 'runtime' ? 50 : $maximum;
}, 10, 2);
blockstudio/cache/compress
Φιλτράρει αν ένα ωφέλιμο φορτίο cache χρησιμοποιεί συμπιεσμένα σειριοποιημένα δεδομένα αντί για έναν απλό πίνακα PHP. Από προεπιλογή, μόνο τα ωφέλιμα φορτία έως 1 MiB χρησιμοποιούν την απλή μορφή, και μόνο όταν η ενεργή κοινόχρηστη μνήμη OPcache μπορεί να αποθηκεύσει στην cache τον προορισμό. Άλλες διεργασίες, αρχεία που εξαιρούνται και μεγαλύτερα ωφέλιμα φορτία χρησιμοποιούν συμπίεση.
add_filter('blockstudio/cache/compress', function($compress, $scope) {
return $scope === 'runtime' ? false : $compress;
}, 10, 2);
Η επιστροφή του false παρακάμπτει και τον περιορισμό μεγέθους. Αυτό μπορεί να βοηθήσει όταν το WP-CLI προθερμαίνει αρχεία για web workers με ενεργό OPcache χωρίς opcache.enable_cli, αλλά κάθε αναγνώστης χωρίς OPcache θα αναλύσει τον παραγόμενο πίνακα. Διατηρήστε τη συμπίεση για μεγάλα κοινόχρηστα ωφέλιμα φορτία, εκτός αν είναι αποδεκτό το πρόσθετο κόστος μνήμης. Για τις προεπιλεγμένες δικλίδες ασφαλείας, δείτε τις μορφές ωφέλιμων φορτίων cache.
blockstudio/cache/protected_paths
Η εκκαθάριση παλιών εγγραφών διατήρησης δεν πρέπει ποτέ να διαγράφει διαδρομές προσωρινής μνήμης. Το Blockstudio τις αρχικοποιεί με κάθε αρχείο στο οποίο αναφέρεται ο εγκατεστημένος χάρτης πρόωρης εξυπηρέτησης.
add_filter('blockstudio/cache/protected_paths', function(array $paths, string $scope, string $directory) {
if ('static-prerender' === $scope) {
$paths[] = $directory . '/pinned.html';
}
return $paths;
}, 10, 3);
blockstudio/cache/outcome
Αυτή η ενέργεια αναφέρει ένα κοινό εύρος προσωρινής μνήμης και ένα αποτέλεσμα, όπως hit, build, miss-stale, stale-last-good ή write-failure.
add_action('blockstudio/cache/outcome', function(string $scope, string $reason) {
my_metrics()->increment("blockstudio.cache.{$scope}.{$reason}");
}, 10, 2);
blockstudio/static_prerender/request_bypass
Αυτό το φίλτρο λαμβάνει την τελική απόφαση για την ανωνυμία και την ασφάλεια μαζί με τα δεδομένα διακομιστή και cookie. Η επιστροφή του true παρακάμπτει πάντα τη στατική εξυπηρέτηση και δημιουργία.
add_filter(
'blockstudio/static_prerender/request_bypass',
function(bool $bypass, array $server, array $cookies) {
return $bypass || isset($cookies['commerce_session']);
},
10,
3
);
blockstudio/static_prerender/public_urls
Αυτό το φίλτρο παρέχει ή προσαρμόζει την πλήρη δημόσια απογραφή URL που χρησιμοποιείται από τον προγραμματισμένο μηχανισμό προθέρμανσης και τα ρητά εργαλεία γραφήματος.
add_filter('blockstudio/static_prerender/public_urls', function(array $urls) {
$urls[] = home_url('/custom-route/');
return array_values(array_unique($urls));
});
Ό,τι επιστρέφει το φίλτρο δεν αποτελεί την τελική απογραφή. Το αποτέλεσμα περνά από έλεγχο δυνατότητας προσωρινής αποθήκευσης, ο οποίος απορρίπτει οτιδήποτε ταιριάζει με διαμορφωμένη δυναμική διαδρομή και οτιδήποτε παρακάμπτεται από προεπιλογή: /wp-admin, /wp-json, /wp-login.php, /xmlrpc.php, κάθε διαδρομή που περιέχει /feed/ και αποτελέσματα αναζήτησης κάτω από τη βασική διαδρομή αναζήτησης στη διαδρομή αρχικής σελίδας του ιστότοπου (/search/ από προεπιλογή). Επομένως, ένα URL που προσθέτετε μπορεί να απορριφθεί χωρίς προειδοποίηση. Αν μια διαδρομή που περιμένετε λείπει από την ενσωματωμένη απογραφή, ελέγξτε την με βάση αυτούς τους κανόνες πριν υποθέσετε ότι το φίλτρο δεν εκτελέστηκε.
blockstudio/static_prerender/render_internal
Αυτό το φίλτρο υλοποιεί την προαιρετική μεταφορά δέσμης εντός διεργασίας. Επιστρέψτε έναν κανονικοποιημένο πίνακα αποτελέσματος ή αφήστε την τιμή αμετάβλητη, ώστε ο renderer να χρησιμοποιήσει την εφεδρική επιλογή HTTP που έχει ρυθμιστεί. Το αποτέλεσμα περιέχει html και προαιρετικά status, dependencies, virtualHashes και headers· οι κεφαλίδες που αναφέρονται στο performance.staticPrerender.replayHeaders αποθηκεύονται μαζί με το έγγραφο.
add_filter(
'blockstudio/static_prerender/render_internal',
function($result, string $url, array $options) {
return my_static_renderer()->render($url, $options);
},
10,
3
);
blockstudio/static_prerender/cacheable_html
Αυτό το φίλτρο λαμβάνει την τελική απόφαση αφού το Blockstudio επαληθεύσει ότι η έξοδος είναι ένα πλήρες έγγραφο HTML χωρίς δείκτη μη προσωρινής αποθήκευσης και ότι η παρατηρούμενη κατάσταση απόκρισης είναι επιτυχής. Το τρίτο όρισμα είναι η παρατηρούμενη κατάσταση ή το null αν δεν έχει δηλωθεί κατάσταση.
add_filter('blockstudio/static_prerender/cacheable_html', function(bool $cacheable, string $html, ?int $status) {
return $cacheable && !str_contains($html, 'data-personalized');
}, 10, 3);
blockstudio/static_prerender/outcome
Αυτή η ενέργεια αναφέρει αποτελέσματα στατικής προαπόδοσης, όπως επιτυχίες, αστοχίες, εγγραφές, εγγραφές γραφημάτων, παλιές εγγραφές και αποτυχίες.
add_action('blockstudio/static_prerender/outcome', function(string $reason) {
my_metrics()->increment("blockstudio.prerender.{$reason}");
});
blockstudio/tailwind/cache_max_files
Φιλτράρει τον μέγιστο αριθμό μεταγλωττισμένων εγγραφών Tailwind CSS. Η προεπιλογή είναι 1000.
add_filter('blockstudio/tailwind/cache_max_files', function() {
return 1500;
});
blockstudio/tailwind/cache_max_age
Φιλτράρει τη μέγιστη ηλικία των μεταγλωττισμένων εγγραφών Tailwind CSS σε δευτερόλεπτα. Η προεπιλογή είναι 30 ημέρες και το ελάχιστο μία ώρα.
add_filter('blockstudio/tailwind/cache_max_age', function() {
return 14 * DAY_IN_SECONDS;
});
Διαχείριση
ενεργό
Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε τη σελίδα διαχείρισης Blockstudio στην ενότητα Εργαλεία > Blockstudio.
add_filter('blockstudio/admin/enabled', function() {
return false;
});
Πόροι
editor/canvas/body_class
Όταν είναι ενεργή η επαναφορά πόρων, αυτό το φίλτρο προσαρμόζει τις καθαρισμένες κλάσεις σώματος του frontend που αντιγράφονται στον καμβά του επεξεργαστή μπλοκ.
add_filter('blockstudio/editor/canvas/body_class', function(array $classes) {
return array_values(array_diff($classes, ['logged-in']));
});
ενεργοποίηση
Αυτό το φίλτρο σάς επιτρέπει να απενεργοποιήσετε την επεξεργασία και τη φόρτωση ενός συγκεκριμένου τύπου πόρου.
add_filter('blockstudio/assets/enable', function($enable, $type, $block) {
if ($type === 'css' && $block['name'] === 'my/block') {
return false;
}
return $enable;
}, 10, 3);
απενεργοποίηση
Αυτό το φίλτρο σάς επιτρέπει να απενεργοποιήσετε συγκεκριμένους πόρους βάσει του αναγνωριστικού τους. Οι πόροι των οποίων το αναγνωριστικό περιλαμβάνεται στον πίνακα που επιστρέφεται δεν θα αποδίδονται στο frontend.
add_filter('blockstudio/assets/disable', function($disabled) {
$disabled[] = 'my-block-style';
return $disabled;
});
process/scss/import_paths
Αυτό το φίλτρο σάς επιτρέπει να προσθέσετε επιπλέον διαδρομές στη δήλωση @import του μεταγλωττιστή SCSS.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_stylesheet_directory() . '/scss';
return $paths;
});
process/scss/prelude
Αυτό το φίλτρο σάς επιτρέπει να προσθέσετε κοινό κώδικα Sass πριν από τη μεταγλώττιση κάθε αρχείου SCSS.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
process/css/content
Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε το περιεχόμενο του αρχείου CSS πριν από τη μεταγλώττισή του.
add_filter('blockstudio/assets/process/css/content', function($content, $block) {
return str_replace('old-class', 'new-class', $content);
}, 10, 2);
process/js/content
Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε το περιεχόμενο του αρχείου JS πριν από τη μεταγλώττισή του.
add_filter('blockstudio/assets/process/js/content', function($content, $block) {
return $content;
}, 10, 2);
Προσωρινή αποθήκευση
ενεργό
Το Blockstudio αποθηκεύει προσωρινά την απόκριση του frontend, ώστε οι ετικέτες στυλ και script μπλοκ που αποδίδονται μέσα στο σώμα να μεταφερθούν στην κεφαλίδα και το υποσέλιδο και το Tailwind να μπορεί να σαρώσει ολόκληρο το έγγραφο. Η προσωρινή αποθήκευση σημαίνει ότι διατηρείται και σαρώνεται ολόκληρο το έγγραφο σε κάθε αίτημα frontend· ένας ιστότοπος που δεν αποδίδει πόρους μπλοκ Blockstudio και δεν χρησιμοποιεί το Tailwind μπορεί να επιστρέψει το false για να παραλείψει και τα δύο.
add_filter('blockstudio/buffer/enabled', '__return_false');
Η προσωρινή αποθήκευση σε buffer είναι επίσης απενεργοποιημένη στον πίνακα διαχείρισης και στην προεπισκόπηση του Customizer. Καλέστε το bs_is_buffering() από το wp_enqueue_scripts ή αργότερα για να διαπιστώσετε αν η τρέχουσα απόκριση αποθηκεύεται σε buffer. Επιστρέφει false πριν ληφθεί η απόφαση στο template_redirect.
έξοδος
Αυτό το φίλτρο λαμβάνει το πλήρες έγγραφο HTML που έχει αποθηκευτεί προσωρινά πριν από την αποστολή του. Η μεταφορά πόρων του Blockstudio εκτελείται με προτεραιότητα 1000000 και η μεταγλώττιση Tailwind με προτεραιότητα 999999, επομένως εκτελέστε το νωρίτερα για να δείτε το έγγραφο πριν από αυτές ή αργότερα για να δείτε την τελική έξοδο.
add_filter('blockstudio/buffer/output', function(string $html) {
return $html;
}, 2000000);
Απόδοση
εξαρτήσεις
Αυτό το φίλτρο αναφέρει το επιλεγμένο πρότυπο και τις εξαρτήσεις πόρων κάθε φορά που το Blockstudio αποδίδει ένα μπλοκ. Είναι χρήσιμο για στατικούς εξαγωγείς και άλλους συλλέκτες εξαρτήσεων εντός της ίδιας διεργασίας.
add_filter(
'blockstudio/render/dependencies',
function($paths, $name, $block, $isEditor, $isPreview) {
my_dependency_graph()->add($name, $paths);
return $paths;
},
10,
5
);
καθολικό
Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε την έξοδο της σελίδας πριν από την απόδοσή της.
add_filter('blockstudio/render', function($content) {
return $content;
});
κεφαλίδα
Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε την έξοδο της ετικέτας <head> πριν αποδοθεί. Εκτελείται μόνο όταν το Blockstudio αποθηκεύει την απόκριση σε buffer· δείτε το bs_is_buffering().
add_filter('blockstudio/render/head', function($content) {
return $content . '<meta name="custom" content="value">';
});
υποσέλιδο
Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε την έξοδο του </body> πριν από την απόδοσή του.
add_filter('blockstudio/render/footer', function($content) {
return $content . '<script>console.log("loaded")</script>';
});
Διαχείριση σφαλμάτων
error/logged
Η ενέργεια εκτελείται μετά την καταγραφή ενός σφάλματος. Χρησιμοποιήστε την για να στέλνετε σφάλματα σε εξωτερικές υπηρεσίες καταγραφής.
add_action('blockstudio/error/logged', function($message, $level, $context) {
if ($level === 'error') {
my_external_logger($message, $context);
}
}, 10, 3);
error/exception
Η ενέργεια εκτελείται μετά τον χειρισμό μιας εξαίρεσης.
add_action('blockstudio/error/exception', function($exception, $context) {
my_error_tracker($exception);
}, 10, 2);
Βάση δεδομένων
Όλα τα hook βάσης δεδομένων λαμβάνουν έναν μόνο πίνακα $params.
db/before_create
Η ενέργεια εκτελείται πριν από τη δημιουργία μιας εγγραφής.
add_action('blockstudio/db/before_create', function($params) {
// $params: block, schema, data, storage
});
db/after_create
Η ενέργεια εκτελείται μετά τη δημιουργία μιας εγγραφής.
add_action('blockstudio/db/after_create', function($params) {
// $params: block, schema, record, storage
wp_mail($params['record']['email'], 'Welcome!', 'Thanks for subscribing.');
});
db/before_update
Η ενέργεια εκτελείται πριν από την ενημέρωση μιας εγγραφής.
add_action('blockstudio/db/before_update', function($params) {
// $params: block, schema, id, data, storage
});
db/after_update
Η ενέργεια εκτελείται μετά την ενημέρωση μιας εγγραφής.
add_action('blockstudio/db/after_update', function($params) {
// $params: block, schema, id, record, storage
});
db/before_delete
Η ενέργεια εκτελείται πριν από τη διαγραφή μιας εγγραφής.
add_action('blockstudio/db/before_delete', function($params) {
// $params: block, schema, id, storage
});
db/after_delete
Η ενέργεια εκτελείται μετά τη διαγραφή μιας εγγραφής.
add_action('blockstudio/db/after_delete', function($params) {
// $params: block, schema, id, storage
});
RPC
Όλα τα hook RPC λαμβάνουν έναν μόνο πίνακα $params.
rpc/before_call
Η ενέργεια εκτελείται πριν από την κλήση μιας συνάρτησης RPC.
add_action('blockstudio/rpc/before_call', function($params) {
// $params: block, function, params
});
rpc/after_call
Η ενέργεια εκτελείται μετά την κλήση μιας συνάρτησης RPC.
add_action('blockstudio/rpc/after_call', function($params) {
// $params: block, function, params, result
});