Άγκιστρα
Φίλτρα και ενέργειες για την προσαρμογή σελίδων, μοτίβων, Προτύπων ιστοτόπου και του αναλυτή HTML.
Αναλυτής
blockstudio/block_tags/builders
Καταχωρίζει builders block-array που χρησιμοποιούνται από block tags και προσαρμοσμένα blocks με αντιστοίχιση στοιχείων. Η callback για κάθε block λαμβάνει έναν πίνακα attributes και το ακατέργαστο εσωτερικό περιεχόμενο.
add_filter( 'blockstudio/block_tags/builders', function( $builders, $parser ) {
$builders['acf/hero'] = function( array $attrs, string $inner_content ) {
$inner_blocks = Blockstudio\Block_Tags::parse_inner_blocks( $inner_content );
return array(
'blockName' => 'acf/hero',
'attrs' => $attrs,
'innerBlocks' => $inner_blocks,
'innerHTML' => '',
'innerContent' => array_fill( 0, count( $inner_blocks ), null ),
);
};
return $builders;
}, 10, 2 );
Τα blockstudio/block_tags/renderers και blockstudio/parser/renderers λαμβάνουν το ίδιο registry. Εκτελούνται μετά το blockstudio/block_tags/builders, με αυτή τη σειρά, και μπορούν να αντικαταστήσουν προηγούμενο builder για το ίδιο block.
blockstudio/parser/element_mapping
Παρακάμψτε την προεπιλεγμένη αντιστοίχιση στοιχείων HTML σε blocks. Από προεπιλογή, τα τυπικά στοιχεία HTML όπως τα <h1>, <p> και <img> αντιστοιχίζονται σε βασικά blocks WordPress. Χρησιμοποιήστε αυτό το φίλτρο για να αντιστοιχίσετε οποιοδήποτε στοιχείο σε διαφορετικό block.
add_filter( 'blockstudio/parser/element_mapping', function( $mapping ) {
$mapping['h1'] = 'custom/heading';
$mapping['h2'] = 'custom/heading';
$mapping['p'] = 'custom/paragraph';
$mapping['img'] = 'custom/image';
return $mapping;
}, 10, 2 );
Αν το <p> αντιστοιχίζεται σε καταχωρισμένο μη βασικό block Blockstudio με attribute richtext content, το εσωτερικό HTML του αντιγράφεται σε αυτό το attribute, μαζί με inline tags όπως τα code και img που αντιστοιχίζονται επίσης σε στοιχεία. Μια παράγραφος της οποίας το μοναδικό παιδί είναι εικόνα γίνεται το block στο οποίο αντιστοιχίζεται το <img>. Τα εμφωλευμένα block tags ή το block-level HTML διατηρούν την κανονική συμπεριφορά ανάλυσης εσωτερικών blocks.
Σελίδες
blockstudio/pages/paths
Φιλτράρει τους καταλόγους που σαρώνονται για πρότυπα σελίδων.
add_filter( 'blockstudio/pages/paths', function( $paths ) {
$paths[] = get_template_directory() . '/custom-pages';
$paths[] = MY_PLUGIN_DIR . '/pages';
return $paths;
} );
blockstudio/pages/manifest_scan_interval
Φιλτράρει τη μέγιστη ηλικία μιας παλιάς προσωρινής μνήμης manifest πριν από το 7.6.2, η οποία μπορεί να αρχικοποιήσει το persisted collection runtime κατά την αναβάθμιση. Τα κανονικά αιτήματα χρησιμοποιούν την persisted διαμόρφωση collection και δεν σαρώνονται περιοδικά ξανά οι ρίζες σελίδων. Εκτελέστε το wp bs pages sync ή καλέστε το Blockstudio\Pages::reconcile() μετά από αλλαγή σε manifest collection.
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
return 10;
} );
blockstudio/pages/create_post_data
Φιλτράρει τα δεδομένα ανάρτησης πριν από τη δημιουργία νέας σελίδας.
add_filter( 'blockstudio/pages/create_post_data', function( $post_data, $page_data ) {
$post_data['post_author'] = 1;
return $post_data;
}, 10, 2 );
blockstudio/pages/update_post_data
Φιλτράρει τα δεδομένα ανάρτησης πριν από την ενημέρωση υπάρχουσας σελίδας.
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
return $post_data;
}, 10, 3 );
blockstudio/pages/synced
Ενέργεια που ενεργοποιείται μετά τον συγχρονισμό όλων των σελίδων.
add_action( 'blockstudio/pages/synced', function( $registry ) {
// $registry is the Page_Registry instance
} );
blockstudio/pages/post_created
Ενέργεια που ενεργοποιείται μετά τη δημιουργία μιας ανάρτησης σελίδας.
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
// Do something after page creation
}, 10, 2 );
blockstudio/pages/post_updated
Ενέργεια που ενεργοποιείται μετά την ενημέρωση μιας ανάρτησης σελίδας.
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
// Do something after page update
}, 10, 2 );
Μοτίβα
blockstudio/patterns/paths
Φιλτράρει τους καταλόγους που σαρώνονται για πρότυπα μοτίβων.
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
blockstudio/patterns/registered
Ενέργεια που ενεργοποιείται μετά την καταχώριση όλων των μοτίβων.
add_action( 'blockstudio/patterns/registered', function( $registry ) {
// $registry is the Pattern_Registry instance
} );
Πρότυπα ιστότοπου
blockstudio/site_templates/template_paths
Φιλτράρει τους καταλόγους που σαρώνονται για αρχεία template.json.
add_filter( 'blockstudio/site_templates/template_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-templates';
return $paths;
} );
blockstudio/site_templates/part_paths
Φιλτράρει τους καταλόγους που σαρώνονται για αρχεία part.json.
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-parts';
return $paths;
} );
blockstudio/site_templates/paths
Φιλτράρει μαζί και τις δύο λίστες διαδρομών εντοπισμού. Η τιμή περιέχει πίνακες templates και parts.
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
return $paths;
} );
blockstudio/site_templates/template_candidates
Φιλτράρει τα υποψήφια αρχεία πηγαίου κώδικα αφού επιλυθούν το manifest και το λογικό δέντρο πηγαίου κώδικα.
add_filter(
'blockstudio/site_templates/template_candidates',
function( $candidates, $directory, $manifest ) {
$candidates[] = $directory . '/template.custom.php';
return $candidates;
},
10,
3
);
blockstudio/site_templates/templates
Φιλτράρει τα πλήρη πρότυπα που επιστρέφει το registry API.
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
return $templates;
} );
blockstudio/site_templates/parts
Φιλτράρει τα τμήματα προτύπων που επιστρέφει το registry API.
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
return $parts;
} );
blockstudio/site_templates/template_content
Φιλτράρει μια συμβολοσειρά πηγαίου κώδικα προτύπου πριν το Blockstudio την αναλύσει σε blocks.
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/part_content
Φιλτράρει μια συμβολοσειρά πηγαίου κώδικα τμήματος προτύπου πριν το Blockstudio την αναλύσει σε blocks.
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/parser
Φιλτράρει το στιγμιότυπο του Blockstudio\Html_Parser που χρησιμοποιείται για ένα μεταγλωττισμένο πρότυπο ή τμήμα. Επιστρέψτε ένα Html_Parser· οι άλλες τιμές επαναφέρουν τον προεπιλεγμένο parser.
add_filter(
'blockstudio/site_templates/parser',
function( $parser, $item ) {
return $parser;
},
10,
2
);
blockstudio/site_templates/discovered
Ενέργεια που ενεργοποιείται μετά από έναν κύκλο ψυχρού εντοπισμού και μεταγλώττισης, πριν αποθηκευτεί το αναδημιουργημένο registry.
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
// Inspect the rebuilt Site_Template_Registry.
} );
blockstudio/site_templates/registered
Ενέργεια που ενεργοποιείται μετά την αποθήκευση ενός αναδημιουργημένου registry προτύπων Site Editor που βασίζεται σε αρχεία.
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
// $registry is the Site_Template_Registry instance
} );
Οι ενέργειες discovered και registered δεν ενεργοποιούνται όταν υπάρχει επιτυχής ανάκτηση από θερμή cache του registry.