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

Άγκιστρα PHP

Παρακάτω θα βρείτε τη λίστα με όλα τα διαθέσιμα άγκιστρα PHP που μπορείτε να χρησιμοποιήσετε για να επεκτείνετε ή να προσαρμόσετε τη λειτουργικότητα του πρόσθετου.

Διαδρομή

Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε τη διαδρομή του φακέλου μπλοκ. Από προεπιλογή, βρίσκεται blockstudio μέσα στο ενεργό θέμα. Εναλλακτικά, μπορείτε να δημιουργήσετε μια νέα παρουσία για πολλούς καταλόγους πηγαίου κώδικα.

PHP
add_filter('blockstudio/path', function() {
  $path = get_stylesheet_directory() . '/blocks';
  return $path;
});

Αρχικοποίηση

καθολικό

Αυτή η ενέργεια εκτελείται αφού το πρόσθετο καταχωρίσει όλα τα μπλοκ.

PHP
add_action('blockstudio/init', function($blocks) {
  // All blocks have been registered
});

παρουσία

Αυτή η ενέργεια εκτελείται αφού το πρόσθετο καταχωρίσει όλα τα μπλοκ μιας συγκεκριμένης παρουσίας. Το τμήμα $instance είναι η διαδρομή της παρουσίας σε σχέση με το wp-content.

PHP
$instance = 'themes/my-theme/client-blocks';
add_action("blockstudio/init/$instance", function() {
  // All blocks of this instance have been registered
});

global/before

Αυτή η ενέργεια εκτελείται πριν το πρόσθετο καταχωρίσει όλα τα μπλοκ.

PHP
add_action('blockstudio/init/before', function() {
  // Before blocks are registered
});

global/before/$instance

Αυτή η ενέργεια εκτελείται πριν το πρόσθετο καταχωρίσει όλα τα μπλοκ μιας συγκεκριμένης παρουσίας.

PHP
$instance = 'themes/my-theme/client-blocks';
add_action("blockstudio/init/before/$instance", function() {
  // Before blocks of this instance are registered
});

Μπλοκ

Απόδοση

Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε την έξοδο ενός μπλοκ πριν αποδοθεί.

PHP
add_filter('blockstudio/blocks/render', function($content, $block, $attributes) {
  // Modify the block content
  return $content;
}, 10, 3);

Μεταδεδομένα

Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε τα δεδομένα του αρχείου block.json πριν αυτό καταχωριστεί.

PHP
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 της συνθήκης. Δείτε τις Προσαρμοσμένες συνθήκες.

PHP
add_filter('blockstudio/blocks/conditions', function($conditions) {
  $conditions['myCustomCondition'] = 'expected';
  return $conditions;
});

Χαρακτηριστικά

Αυτό το φίλτρο προσαρμόζει έναν ορισμό πεδίου πριν καταχωριστεί το μπλοκ. Ο φιλτραρισμένος ορισμός καθορίζει το στοιχείο ελέγχου στον επεξεργαστή και την επικύρωση της τιμής κατά την απόδοση. Δείτε την ενότητα Φιλτράρισμα για περισσότερες πληροφορίες.

PHP
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). Καταχωρίστε το με τρία αποδεκτά ορίσματα. Για περισσότερες πληροφορίες, δείτε το θέμα Φιλτράρισμα.

PHP
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 μπορούν να αφαιρέσουν τη λίστα ή να τη συντομεύσουν.

PHP
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(), για παράδειγμα όταν ένα προσαρμοσμένο φίλτρο απόδοσης επιλύει αποθηκευμένες αναφορές. Αυτό δεν ενεργοποιεί την αυτόματη επικύρωση κατά την αποθήκευση ή την απόδοση.

PHP
add_filter('blockstudio/blocks/attributes/validate', function($findings, $name, $attrs) {
  return $findings;
}, 10, 3);

Επιστρέψτε μια λίστα ευρημάτων. Το φίλτρο δεν καλείται όταν το μπλοκ δεν έχει πεδία Blockstudio ή αντίστοιχες επεκτάσεις (null).

attributes/schema

Προσαρμόστε το Schema JSON που επιστρέφεται από το bs_block_schema(), για παράδειγμα όταν ένα προσαρμοσμένο φίλτρο απόδοσης επιλύει αποθηκευμένες αναφορές.

PHP
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"}.

PHP
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 της συμβολοσειράς που επιστρέφεται.

PHP
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 />.

PHP
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.

PHP
add_filter('blockstudio/blocks/components/inner_blocks/frontend/wrap', function($wrap, $block) {
  return false; // Remove wrapper
}, 10, 2);

components/rich_text/render

Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε την έξοδο του περιεχομένου <RichText />. Λαμβάνει την τιμή του χαρακτηριστικού και το μπλοκ.

PHP
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 λαμβάνει αναλυμένα χαρακτηριστικά και το ακατέργαστο εσωτερικό περιεχόμενο.

PHP
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 ή βασικών μπλοκ.

PHP
add_filter('blockstudio/block_tags/tag_aliases', function($aliases) {
  $aliases['theme-button'] = 'bsui/button';
  $aliases['theme-card'] = 'theme/card';

  return $aliases;
});
HTML
<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

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

PHP
add_filter('blockstudio/block_tags/prefixes', function($prefixes) {
  $prefixes['theme'] = ['theme-components', 'bsui'];

  return $prefixes;
});
HTML
<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 μέσα στο ενεργό θέμα.

PHP
add_filter('blockstudio/settings/path', function() {
  return get_stylesheet_directory() . '/config/blockstudio.json';
});

users/ids

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε τον επεξεργαστή για συγκεκριμένα αναγνωριστικά χρηστών.

PHP
add_filter('blockstudio/settings/users/ids', function() {
  return [1];
});

users/roles

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε τον επεξεργαστή για συγκεκριμένους ρόλους χρηστών.

PHP
add_filter('blockstudio/settings/users/roles', function() {
  return ['administrator', 'editor'];
});

assets/enqueue

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε τη φόρτωση πόρων στο frontend και στον επεξεργαστή.

PHP
add_filter('blockstudio/settings/assets/enqueue', function() {
  return false;
});

assets/reset/enabled

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε την αφαίρεση των βασικών στυλ μπλοκ του WordPress και την επαναφορά διάταξης βοηθητικών στοιχείων του επεξεργαστή.

PHP
add_filter('blockstudio/settings/assets/reset/enabled', function() {
  return true;
});

assets/reset/full_width

Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε ποιοι τύποι αναρτήσεων χρησιμοποιούν επεξεργασία πλήρους πλάτους.

PHP
add_filter('blockstudio/settings/assets/reset/full_width', function() {
  return ['page'];
});

assets/minify/css

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε την ελαχιστοποίηση του CSS.

PHP
add_filter('blockstudio/settings/assets/minify/css', function() {
  return true;
});

assets/minify/js

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε την ελαχιστοποίηση του JS.

PHP
add_filter('blockstudio/settings/assets/minify/js', function() {
  return true;
});

assets/process/scss

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε την επεξεργασία του SCSS σε αρχεία .css.

PHP
add_filter('blockstudio/settings/assets/process/scss', function() {
  return true;
});

assets/process/scss_files

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε την επεξεργασία αρχείων .scss σε CSS.

PHP
add_filter('blockstudio/settings/assets/process/scss_files', function() {
  return true;
});

assets/output

Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε πού αποθηκεύονται τα μεταγλωττισμένα στοιχεία μπλοκ.

PHP
add_filter('blockstudio/settings/assets/output', function() {
  return 'cache';
});

assets/inline_limit

Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε πόσα byte εξωτερικού μπλοκ CSS ενσωματώνονται ανά σελίδα.

PHP
add_filter('blockstudio/settings/assets/inline_limit', function() {
  return 40000;
});

cache/enabled

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε όλες τις προσωρινές μνήμες πόρων εκτέλεσης και επεξεργαστή που βασίζονται σε αρχεία Blockstudio.

PHP
add_filter('blockstudio/settings/cache/enabled', function() {
  return false;
});

cache/path

Αυτό το φίλτρο σάς επιτρέπει να αλλάξετε τον κατάλογο προσωρινής μνήμης του Blockstudio που βασίζεται σε αρχεία.

PHP
add_filter('blockstudio/settings/cache/path', function() {
  return 'cache/blockstudio';
});

cache/namespace_grace

Αυτό το φίλτρο σάς επιτρέπει να αλλάξετε για πόσο διατηρείται ένας παλιός χώρος ονομάτων προσωρινής μνήμης πριν από τη συλλογή του.

PHP
add_filter('blockstudio/settings/cache/namespace_grace', function() {
  return 777600;
});

githooks/commit

Αυτό το φίλτρο δείχνει αν είναι ενεργό το hook commit του Blockstudio με ιδιοκτησία PHPStan.

PHP
add_filter('blockstudio/settings/githooks/commit', function() {
  return true;
});

content/enabled

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε τον Συγχρονισμό περιεχομένου.

PHP
add_filter('blockstudio/settings/content/enabled', function() {
  return true;
});

content/id

Αυτό το φίλτρο σάς επιτρέπει να ορίσετε τον χώρο ονομάτων ιδιοκτησίας του Συγχρονισμού περιεχομένου.

PHP
add_filter('blockstudio/settings/content/id', function() {
  return 'docs';
});

content/path

Αυτό το φίλτρο σάς επιτρέπει να ορίσετε τον κατάλογο αρχείων του Συγχρονισμού περιεχομένου.

PHP
add_filter('blockstudio/settings/content/path', function() {
  return 'content';
});

content/include_page_sync_managed

Αυτό το φίλτρο σάς επιτρέπει να συμπεριλάβετε ή να εξαιρέσετε αναρτήσεις που διαχειρίζεται ο Συγχρονισμός σελίδων.

PHP
add_filter('blockstudio/settings/content/include_page_sync_managed', function() {
  return false;
});

content/authors

Αυτό το φίλτρο σάς επιτρέπει να διαμορφώσετε τον χειρισμό συντακτών από τον Συγχρονισμό περιεχομένου.

PHP
add_filter('blockstudio/settings/content/authors', function() {
  return 'ignore';
});

content/post_types

Αυτό το φίλτρο σάς επιτρέπει να διαμορφώσετε τις λίστες επιτρεπόμενων τύπων αναρτήσεων του Συγχρονισμού περιεχομένου.

PHP
add_filter('blockstudio/settings/content/post_types', function() {
  return ['team_member'];
});

content/taxonomies

Αυτό το φίλτρο σάς επιτρέπει να διαμορφώσετε τις λίστες επιτρεπόμενων ταξινομιών του Συγχρονισμού περιεχομένου.

PHP
add_filter('blockstudio/settings/content/taxonomies', function() {
  return ['category', 'post_tag'];
});

content/media

Αυτό το φίλτρο σάς επιτρέπει να διαμορφώσετε τον χειρισμό πολυμέσων από τον Συγχρονισμό περιεχομένου.

PHP
add_filter('blockstudio/settings/content/media', function() {
  return 'manifest';
});

tailwind/enabled

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε το Tailwind.

PHP
add_filter('blockstudio/settings/tailwind/enabled', function() {
  return true;
});

tailwind/config

Αυτό το φίλτρο σάς επιτρέπει να προσθέσετε μια προσαρμοσμένη διαμόρφωση Tailwind CSS.

PHP
add_filter('blockstudio/settings/tailwind/config', function() {
  return '@theme { --color-primary: pink; }';
});

tailwind/output

Αυτό το φίλτρο σάς επιτρέπει να επιλέξετε έξοδο Tailwind CSS ενσωματωμένη ή μέσω συνδέσμου.

PHP
add_filter('blockstudio/settings/tailwind/output', function() {
  return 'link';
});

ui/enabled

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε τα ενσωματωμένα στοιχεία UI.

PHP
add_filter('blockstudio/settings/ui/enabled', function() {
  return true;
});

editor/format_on_save

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε τη μορφοποίηση κώδικα κατά την αποθήκευση.

PHP
add_filter('blockstudio/settings/editor/format_on_save', function() {
  return true;
});

editor/assets

Αυτό το φίλτρο σάς επιτρέπει να φορτώσετε πρόσθετους πόρους στον επεξεργαστή.

PHP
add_filter('blockstudio/settings/editor/assets', function() {
  return ['my-stylesheet', 'another-stylesheet'];
});

editor/markup

Αυτό το φίλτρο σάς επιτρέπει να προσθέσετε επιπλέον σήμανση στο τέλος του επεξεργαστή.

PHP
add_filter('blockstudio/settings/editor/markup', function() {
  return '<style>body { background: black; }</style>';
});

block_editor/disable_loading

Αυτό το φίλτρο σάς επιτρέπει να απενεργοποιήσετε τη φόρτωση μπλοκ μέσα στον Επεξεργαστή μπλοκ.

PHP
add_filter('blockstudio/settings/block_editor/disable_loading', function() {
  return true;
});

block_editor/enhance

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε τις διευκολύνσεις επεξεργασίας του Blockstudio, όπως καθαρότερα στυλ εστίασης και περιγράμματα κατά την αιώρηση ή την επιλογή.

PHP
add_filter('blockstudio/settings/block_editor/enhance', function() {
  return true;
});

block_editor/css_classes

Αυτό το φίλτρο σάς επιτρέπει να προσθέσετε φύλλα στυλ των οποίων οι κλάσεις θα είναι διαθέσιμες για επιλογή στο πεδίο κλάσης.

PHP
add_filter('blockstudio/settings/block_editor/css_classes', function() {
  return ['my-stylesheet', 'another-stylesheet'];
});

block_editor/css_variables

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

PHP
add_filter('blockstudio/settings/block_editor/css_variables', function() {
  return ['my-stylesheet', 'another-stylesheet'];
});

block_editor/blocks/allow

Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε ποια ονόματα μπλοκ επιτρέπονται στο εργαλείο εισαγωγής.

PHP
add_filter('blockstudio/settings/block_editor/blocks/allow', function() {
  return ['core/*', 'acf/*', 'my-theme/*'];
});

block_editor/blocks/deny

Αυτό το φίλτρο σάς επιτρέπει να αφαιρείτε ονόματα μπλοκ από το εργαλείο εισαγωγής.

PHP
add_filter('blockstudio/settings/block_editor/blocks/deny', function() {
  return ['core/embed', 'core/freeform'];
});

block_editor/blocks/directory

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε τους πόρους καταλόγου μπλοκ του WordPress στον επεξεργαστή.

PHP
add_filter('blockstudio/settings/block_editor/blocks/directory', function() {
  return false;
});

block_editor/blocks/categories/allow

Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε ποια slug κατηγοριών μπλοκ παραμένουν διαθέσιμα.

PHP
add_filter('blockstudio/settings/block_editor/blocks/categories/allow', function() {
  return ['text', 'media', 'design'];
});

block_editor/blocks/categories/deny

Αυτό το φίλτρο σάς επιτρέπει να αφαιρείτε slug κατηγοριών μπλοκ από το εργαλείο εισαγωγής.

PHP
add_filter('blockstudio/settings/block_editor/blocks/categories/deny', function() {
  return ['embed'];
});

block_editor/blocks/categories/rename

Αυτό το φίλτρο σάς επιτρέπει να μετονομάζετε τις ετικέτες κατηγοριών μπλοκ βάσει slug.

PHP
add_filter('blockstudio/settings/block_editor/blocks/categories/rename', function() {
  return [
    'text' => 'Writing',
    'design' => 'Layout'
  ];
});

block_editor/blocks/categories/order

Αυτό το φίλτρο σάς επιτρέπει να ορίζετε τη σειρά των slug κατηγοριών μπλοκ στο εργαλείο εισαγωγής.

PHP
add_filter('blockstudio/settings/block_editor/blocks/categories/order', function() {
  return ['my-theme', 'text', 'media'];
});

block_editor/blocks/styles/deny

Αυτό το φίλτρο σάς επιτρέπει να καταργείτε την καταχώριση στυλ μπλοκ που καταχωρίστηκαν από το PHP, βάσει ονόματος μπλοκ.

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.

PHP
add_filter('blockstudio/settings/block_editor/blocks/legacy_widgets/hide', function() {
  return ['archives', 'calendar'];
});

block_editor/patterns/core

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε τα βασικά μοτίβα μπλοκ του WordPress.

PHP
add_filter('blockstudio/settings/block_editor/patterns/core', function() {
  return false;
});

block_editor/patterns/remote

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε απομακρυσμένα μοτίβα από τον κατάλογο μοτίβων του WordPress.

PHP
add_filter('blockstudio/settings/block_editor/patterns/remote', function() {
  return false;
});

block_editor/patterns/theme

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε μοτίβα μπλοκ που παρέχονται από το θέμα.

PHP
add_filter('blockstudio/settings/block_editor/patterns/theme', function() {
  return false;
});

block_editor/patterns/blockstudio

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε μοτίβα του Blockstudio που βασίζονται σε αρχεία.

PHP
add_filter('blockstudio/settings/block_editor/patterns/blockstudio', function() {
  return false;
});

block_editor/patterns/categories/allow

Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε ποια slug κατηγοριών μοτίβων παραμένουν διαθέσιμα.

PHP
add_filter('blockstudio/settings/block_editor/patterns/categories/allow', function() {
  return ['featured', 'buttons', 'columns'];
});

block_editor/patterns/categories/deny

Αυτό το φίλτρο σάς επιτρέπει να αφαιρείτε slug κατηγοριών μοτίβων από το εργαλείο εισαγωγής μοτίβων.

PHP
add_filter('blockstudio/settings/block_editor/patterns/categories/deny', function() {
  return ['gallery'];
});

block_editor/patterns/categories/rename

Αυτό το φίλτρο σάς επιτρέπει να μετονομάζετε τις ετικέτες κατηγοριών μοτίβων βάσει slug.

PHP
add_filter('blockstudio/settings/block_editor/patterns/categories/rename', function() {
  return [
    'featured' => 'Featured Layouts'
  ];
});

block_editor/patterns/categories/order

Αυτό το φίλτρο σάς επιτρέπει να ορίζετε τη σειρά των slug κατηγοριών μοτίβων στο εργαλείο εισαγωγής.

PHP
add_filter('blockstudio/settings/block_editor/patterns/categories/order', function() {
  return ['featured', 'buttons'];
});

block_editor/media/openverse

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε την κατηγορία πολυμέσων Openverse στο εργαλείο εισαγωγής πολυμέσων του επεξεργαστή μπλοκ.

PHP
add_filter('blockstudio/settings/block_editor/media/openverse', function() {
  return false;
});

block_editor/media/image_sizes/allow

Αυτό το φίλτρο σάς επιτρέπει να ελέγχετε ποια ονόματα μεγεθών εικόνας παραμένουν διαθέσιμα στα στοιχεία ελέγχου πολυμέσων του επεξεργαστή.

PHP
add_filter('blockstudio/settings/block_editor/media/image_sizes/allow', function() {
  return ['thumbnail', 'large'];
});

block_editor/media/image_sizes/deny

Αυτό το φίλτρο σάς επιτρέπει να αφαιρείτε ονόματα μεγεθών εικόνας από τα στοιχεία ελέγχου πολυμέσων του επεξεργαστή.

PHP
add_filter('blockstudio/settings/block_editor/media/image_sizes/deny', function() {
  return ['medium_large'];
});

ai/enable_context_generation

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε τη δημιουργία αρχείου περιβάλλοντος για την ενσωμάτωση εργαλείων LLM. Όταν είναι ενεργό, το αρχείο περιβάλλοντος συγκεντρώνει ενημερωμένα δεδομένα μπλοκ, ρυθμίσεις Blockstudio της τρέχουσας εγκατάστασης, όλα τα σχετικά σχήματα και την τεκμηρίωση Blockstudio σε μία πηγή για χρήση με εργαλεία ανάπτυξης ΤΝ.

PHP
add_filter('blockstudio/settings/ai/enable_context_generation', function() {
  return true;
});

block_tags/enabled

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε την απόδοση ετικετών μπλοκ σε επίπεδο σελίδας.

PHP
add_filter('blockstudio/settings/block_tags/enabled', function() {
  return true;
});

block_tags/prefixes

Αυτό το φίλτρο σάς επιτρέπει να καταχωρίζετε συντομογραφίες προθεμάτων για χώρους ονομάτων στις ετικέτες μπλοκ.

PHP
add_filter('blockstudio/settings/block_tags/prefixes', function() {
  return [
    'theme' => ['theme-components', 'bsui']
  ];
});

dev/grab/enabled

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε το εργαλείο επιλογής στοιχείων.

PHP
add_filter('blockstudio/settings/dev/grab/enabled', function() {
  return false;
});

dev/perf

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε το εργαλείο ανάλυσης επιδόσεων.

PHP
add_filter('blockstudio/settings/dev/perf', function() {
  return false;
});

dev/canvas/enabled

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιείτε ή να απενεργοποιείτε τον καμβά.

PHP
add_filter('blockstudio/settings/dev/canvas/enabled', function() {
  return false;
});

dev/canvas/admin_bar

Αυτό το φίλτρο σάς επιτρέπει να εμφανίζετε ή να αποκρύπτετε τη γραμμή διαχείρισης του WordPress στον καμβά.

PHP
add_filter('blockstudio/settings/dev/canvas/admin_bar', function() {
  return true;
});

WPML

blockstudio/wpml/config/label

Φιλτράρει την ετικέτα κάθε κλειδιού που γράφει το wp bs wpml config. Για τον πίνακα περιβάλλοντος, δείτε Αλλαγή των ετικετών.

PHP
add_filter('blockstudio/wpml/config/label', function($label, $context) {
  return str_replace(' (optional)', '', $label);
}, 10, 2);

Καμβάς

blockstudio/canvas/inventory

Αυτό το φίλτρο προσαρμόζει τα δεδομένα απογραφής που αναφέρει ο καμβάς για μια επιλογή. Η συνάρτηση επανάκλησης λαμβάνει το DTO απογραφής, την αρχική επιλογή και τις επιλογές με τις οποίες κλήθηκε.

PHP
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. Το δεύτερο όρισμα είναι ο φυσικός κατάλογος του πακέτου.

PHP
add_filter(
  'blockstudio/url',
  function(string $url, string $directory) {
    return get_stylesheet_directory_uri() . '/vendor/blockstudio/blockstudio/';
  },
  10,
  2
);

Προσωρινή μνήμη περιβάλλοντος εκτέλεσης

blockstudio/cache/dir

Αυτό το φίλτρο λαμβάνει τον επιλυμένο βασικό κατάλογο της προσωρινής μνήμης πριν προστεθεί οποιοδήποτε εύρος προσωρινής μνήμης περιβάλλοντος εκτέλεσης, πόρων επεξεργαστή ή άλλου τύπου.

PHP
add_filter('blockstudio/cache/dir', function(string $directory) {
  return WP_CONTENT_DIR . '/cache/blockstudio';
});

blockstudio/cache/context

Αυτό το φίλτρο προσθέτει μια σειριοποιήσιμη παραλλαγή περιβάλλοντος εκτέλεσης στις ταυτότητες της προσωρινής μνήμης. Χρησιμοποιήστε το όταν η ίδια πηγή εντοπισμού μπορεί να επιλέγει διαφορετικές λογικές απογραφές.

PHP
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 για κεντρικούς υπολογιστές με δικό τους όριο μισθωτή. Η τιμή που επιστρέφεται καθαρίζεται πριν από τη χρήση.

PHP
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.

PHP
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 αλλού.

PHP
add_filter('blockstudio/cache/watch_debounce', function() {
  return 30;
});

blockstudio/cache/build_wait_budget

Φιλτράρει για πόσο χρόνο, σε χιλιοστά του δευτερολέπτου, περιμένει ένα αίτημα να δημοσιεύσει ένας παράλληλος builder την προσωρινή μνήμη περιβάλλοντος εκτέλεσης ή να ανανεωθούν οι συμπληρωμένες επιλογές, πριν υποβαθμιστεί. Η προεπιλογή είναι 5000 για δομικές αναδημιουργίες και 4000 για ανανεώσεις επιλογών.

PHP
add_filter('blockstudio/cache/build_wait_budget', function() {
  return 2000;
});

blockstudio/cache/populate_debounce

Φιλτράρει για πόσα δευτερόλεπτα συνενώνονται σε μία ανανέωση συμπληρωμένων επιλογών οι διαδοχικές εγγραφές περιεχομένου, όρου, χρήστη ή μεταδεδομένων. Η πρώτη εγγραφή μετά από περίοδο αδράνειας προκαλεί άμεση ανανέωση· η τελευταία εγγραφή μιας ακολουθίας εμφανίζεται μετά την παρέλευση του χρονικού διαστήματος. Η προεπιλογή είναι 30. Επιστρέψτε 0 για ανανέωση σε κάθε εγγραφή.

PHP
add_filter('blockstudio/cache/populate_debounce', function() {
  return 120;
});

blockstudio/cache/populate_ignored_meta_keys

Φιλτράρει τα κλειδιά meta των οποίων οι εγγραφές δεν ανανεώνουν ποτέ τις συμπληρωμένες επιλογές. Από προεπιλογή, αυτά είναι τα κλειδιά που το WordPress γράφει για την παρακολούθηση επεξεργασίας και σύνδεσης: _edit_lock, που ανανεώνεται από τον επεξεργαστή και το Heartbeat όσο μια δημοσίευση είναι ανοιχτή, _edit_last, που γράφεται μαζί με μια αποθήκευση δημοσίευσης η οποία ούτως ή άλλως προκαλεί ανανέωση, και session_tokens, που γράφεται κατά τη σύνδεση και την αποσύνδεση. Προσθέστε κλειδιά που αλλάζουν συχνά, αλλά δεν επηρεάζουν ποτέ ένα ερώτημα συμπλήρωσης.

PHP
add_filter('blockstudio/cache/populate_ignored_meta_keys', function(array $keys) {
  $keys[] = '_my_view_counter';
  return $keys;
});

blockstudio/cache/max_files_per_scope

Φιλτράρει πόσα δημοσιευμένα ωφέλιμα φορτία διατηρεί κάθε εύρος προσωρινής μνήμης περιβάλλοντος εκτέλεσης.

PHP
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 τον προορισμό. Άλλες διεργασίες, αρχεία που εξαιρούνται και μεγαλύτερα ωφέλιμα φορτία χρησιμοποιούν συμπίεση.

PHP
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 τις αρχικοποιεί με κάθε αρχείο στο οποίο αναφέρεται ο εγκατεστημένος χάρτης πρόωρης εξυπηρέτησης.

PHP
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.

PHP
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 παρακάμπτει πάντα τη στατική εξυπηρέτηση και δημιουργία.

PHP
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 που χρησιμοποιείται από τον προγραμματισμένο μηχανισμό προθέρμανσης και τα ρητά εργαλεία γραφήματος.

PHP
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 αποθηκεύονται μαζί με το έγγραφο.

PHP
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 αν δεν έχει δηλωθεί κατάσταση.

PHP
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

Αυτή η ενέργεια αναφέρει αποτελέσματα στατικής προαπόδοσης, όπως επιτυχίες, αστοχίες, εγγραφές, εγγραφές γραφημάτων, παλιές εγγραφές και αποτυχίες.

PHP
add_action('blockstudio/static_prerender/outcome', function(string $reason) {
  my_metrics()->increment("blockstudio.prerender.{$reason}");
});

blockstudio/tailwind/cache_max_files

Φιλτράρει τον μέγιστο αριθμό μεταγλωττισμένων εγγραφών Tailwind CSS. Η προεπιλογή είναι 1000.

PHP
add_filter('blockstudio/tailwind/cache_max_files', function() {
  return 1500;
});

blockstudio/tailwind/cache_max_age

Φιλτράρει τη μέγιστη ηλικία των μεταγλωττισμένων εγγραφών Tailwind CSS σε δευτερόλεπτα. Η προεπιλογή είναι 30 ημέρες και το ελάχιστο μία ώρα.

PHP
add_filter('blockstudio/tailwind/cache_max_age', function() {
  return 14 * DAY_IN_SECONDS;
});

Διαχείριση

ενεργό

Αυτό το φίλτρο σάς επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε τη σελίδα διαχείρισης Blockstudio στην ενότητα Εργαλεία > Blockstudio.

PHP
add_filter('blockstudio/admin/enabled', function() {
  return false;
});

Πόροι

editor/canvas/body_class

Όταν είναι ενεργή η επαναφορά πόρων, αυτό το φίλτρο προσαρμόζει τις καθαρισμένες κλάσεις σώματος του frontend που αντιγράφονται στον καμβά του επεξεργαστή μπλοκ.

PHP
add_filter('blockstudio/editor/canvas/body_class', function(array $classes) {
  return array_values(array_diff($classes, ['logged-in']));
});

ενεργοποίηση

Αυτό το φίλτρο σάς επιτρέπει να απενεργοποιήσετε την επεξεργασία και τη φόρτωση ενός συγκεκριμένου τύπου πόρου.

PHP
add_filter('blockstudio/assets/enable', function($enable, $type, $block) {
  if ($type === 'css' && $block['name'] === 'my/block') {
    return false;
  }
  return $enable;
}, 10, 3);

απενεργοποίηση

Αυτό το φίλτρο σάς επιτρέπει να απενεργοποιήσετε συγκεκριμένους πόρους βάσει του αναγνωριστικού τους. Οι πόροι των οποίων το αναγνωριστικό περιλαμβάνεται στον πίνακα που επιστρέφεται δεν θα αποδίδονται στο frontend.

PHP
add_filter('blockstudio/assets/disable', function($disabled) {
  $disabled[] = 'my-block-style';
  return $disabled;
});

process/scss/import_paths

Αυτό το φίλτρο σάς επιτρέπει να προσθέσετε επιπλέον διαδρομές στη δήλωση @import του μεταγλωττιστή SCSS.

PHP
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
  $paths[] = get_stylesheet_directory() . '/scss';
  return $paths;
});

process/scss/prelude

Αυτό το φίλτρο σάς επιτρέπει να προσθέσετε κοινό κώδικα Sass πριν από τη μεταγλώττιση κάθε αρχείου SCSS.

PHP
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 πριν από τη μεταγλώττισή του.

PHP
add_filter('blockstudio/assets/process/css/content', function($content, $block) {
  return str_replace('old-class', 'new-class', $content);
}, 10, 2);

process/js/content

Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε το περιεχόμενο του αρχείου JS πριν από τη μεταγλώττισή του.

PHP
add_filter('blockstudio/assets/process/js/content', function($content, $block) {
  return $content;
}, 10, 2);

Προσωρινή αποθήκευση

ενεργό

Το Blockstudio αποθηκεύει προσωρινά την απόκριση του frontend, ώστε οι ετικέτες στυλ και script μπλοκ που αποδίδονται μέσα στο σώμα να μεταφερθούν στην κεφαλίδα και το υποσέλιδο και το Tailwind να μπορεί να σαρώσει ολόκληρο το έγγραφο. Η προσωρινή αποθήκευση σημαίνει ότι διατηρείται και σαρώνεται ολόκληρο το έγγραφο σε κάθε αίτημα frontend· ένας ιστότοπος που δεν αποδίδει πόρους μπλοκ Blockstudio και δεν χρησιμοποιεί το Tailwind μπορεί να επιστρέψει το false για να παραλείψει και τα δύο.

PHP
add_filter('blockstudio/buffer/enabled', '__return_false');

Η προσωρινή αποθήκευση σε buffer είναι επίσης απενεργοποιημένη στον πίνακα διαχείρισης και στην προεπισκόπηση του Customizer. Καλέστε το bs_is_buffering() από το wp_enqueue_scripts ή αργότερα για να διαπιστώσετε αν η τρέχουσα απόκριση αποθηκεύεται σε buffer. Επιστρέφει false πριν ληφθεί η απόφαση στο template_redirect.

έξοδος

Αυτό το φίλτρο λαμβάνει το πλήρες έγγραφο HTML που έχει αποθηκευτεί προσωρινά πριν από την αποστολή του. Η μεταφορά πόρων του Blockstudio εκτελείται με προτεραιότητα 1000000 και η μεταγλώττιση Tailwind με προτεραιότητα 999999, επομένως εκτελέστε το νωρίτερα για να δείτε το έγγραφο πριν από αυτές ή αργότερα για να δείτε την τελική έξοδο.

PHP
add_filter('blockstudio/buffer/output', function(string $html) {
  return $html;
}, 2000000);

Απόδοση

εξαρτήσεις

Αυτό το φίλτρο αναφέρει το επιλεγμένο πρότυπο και τις εξαρτήσεις πόρων κάθε φορά που το Blockstudio αποδίδει ένα μπλοκ. Είναι χρήσιμο για στατικούς εξαγωγείς και άλλους συλλέκτες εξαρτήσεων εντός της ίδιας διεργασίας.

PHP
add_filter(
  'blockstudio/render/dependencies',
  function($paths, $name, $block, $isEditor, $isPreview) {
    my_dependency_graph()->add($name, $paths);
    return $paths;
  },
  10,
  5
);

καθολικό

Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε την έξοδο της σελίδας πριν από την απόδοσή της.

PHP
add_filter('blockstudio/render', function($content) {
  return $content;
});

Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε την έξοδο της ετικέτας <head> πριν αποδοθεί. Εκτελείται μόνο όταν το Blockstudio αποθηκεύει την απόκριση σε buffer· δείτε το bs_is_buffering().

PHP
add_filter('blockstudio/render/head', function($content) {
  return $content . '<meta name="custom" content="value">';
});

Αυτό το φίλτρο σάς επιτρέπει να προσαρμόσετε την έξοδο του </body> πριν από την απόδοσή του.

PHP
add_filter('blockstudio/render/footer', function($content) {
  return $content . '<script>console.log("loaded")</script>';
});

Διαχείριση σφαλμάτων

error/logged

Η ενέργεια εκτελείται μετά την καταγραφή ενός σφάλματος. Χρησιμοποιήστε την για να στέλνετε σφάλματα σε εξωτερικές υπηρεσίες καταγραφής.

PHP
add_action('blockstudio/error/logged', function($message, $level, $context) {
  if ($level === 'error') {
    my_external_logger($message, $context);
  }
}, 10, 3);

error/exception

Η ενέργεια εκτελείται μετά τον χειρισμό μιας εξαίρεσης.

PHP
add_action('blockstudio/error/exception', function($exception, $context) {
  my_error_tracker($exception);
}, 10, 2);

Βάση δεδομένων

Όλα τα hook βάσης δεδομένων λαμβάνουν έναν μόνο πίνακα $params.

db/before_create

Η ενέργεια εκτελείται πριν από τη δημιουργία μιας εγγραφής.

PHP
add_action('blockstudio/db/before_create', function($params) {
  // $params: block, schema, data, storage
});

db/after_create

Η ενέργεια εκτελείται μετά τη δημιουργία μιας εγγραφής.

PHP
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

Η ενέργεια εκτελείται πριν από την ενημέρωση μιας εγγραφής.

PHP
add_action('blockstudio/db/before_update', function($params) {
  // $params: block, schema, id, data, storage
});

db/after_update

Η ενέργεια εκτελείται μετά την ενημέρωση μιας εγγραφής.

PHP
add_action('blockstudio/db/after_update', function($params) {
  // $params: block, schema, id, record, storage
});

db/before_delete

Η ενέργεια εκτελείται πριν από τη διαγραφή μιας εγγραφής.

PHP
add_action('blockstudio/db/before_delete', function($params) {
  // $params: block, schema, id, storage
});

db/after_delete

Η ενέργεια εκτελείται μετά τη διαγραφή μιας εγγραφής.

PHP
add_action('blockstudio/db/after_delete', function($params) {
  // $params: block, schema, id, storage
});

RPC

Όλα τα hook RPC λαμβάνουν έναν μόνο πίνακα $params.

rpc/before_call

Η ενέργεια εκτελείται πριν από την κλήση μιας συνάρτησης RPC.

PHP
add_action('blockstudio/rpc/before_call', function($params) {
  // $params: block, function, params
});

rpc/after_call

Η ενέργεια εκτελείται μετά την κλήση μιας συνάρτησης RPC.

PHP
add_action('blockstudio/rpc/after_call', function($params) {
  // $params: block, function, params, result
});