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

Άγκιστρα

Φίλτρα και ενέργειες για την προσαρμογή σελίδων, μοτίβων, Προτύπων ιστοτόπου και του αναλυτή HTML.

Αναλυτής

blockstudio/block_tags/builders

Καταχωρίζει builders block-array που χρησιμοποιούνται από block tags και προσαρμοσμένα blocks με αντιστοίχιση στοιχείων. Η callback για κάθε block λαμβάνει έναν πίνακα attributes και το ακατέργαστο εσωτερικό περιεχόμενο.

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

PHP
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

Φιλτράρει τους καταλόγους που σαρώνονται για πρότυπα σελίδων.

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

PHP
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
    return 10;
} );

blockstudio/pages/create_post_data

Φιλτράρει τα δεδομένα ανάρτησης πριν από τη δημιουργία νέας σελίδας.

PHP
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

Φιλτράρει τα δεδομένα ανάρτησης πριν από την ενημέρωση υπάρχουσας σελίδας.

PHP
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
    return $post_data;
}, 10, 3 );

blockstudio/pages/synced

Ενέργεια που ενεργοποιείται μετά τον συγχρονισμό όλων των σελίδων.

PHP
add_action( 'blockstudio/pages/synced', function( $registry ) {
    // $registry is the Page_Registry instance
} );

blockstudio/pages/post_created

Ενέργεια που ενεργοποιείται μετά τη δημιουργία μιας ανάρτησης σελίδας.

PHP
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
    // Do something after page creation
}, 10, 2 );

blockstudio/pages/post_updated

Ενέργεια που ενεργοποιείται μετά την ενημέρωση μιας ανάρτησης σελίδας.

PHP
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
    // Do something after page update
}, 10, 2 );

Μοτίβα

blockstudio/patterns/paths

Φιλτράρει τους καταλόγους που σαρώνονται για πρότυπα μοτίβων.

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

blockstudio/patterns/registered

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

PHP
add_action( 'blockstudio/patterns/registered', function( $registry ) {
    // $registry is the Pattern_Registry instance
} );

Πρότυπα ιστότοπου

blockstudio/site_templates/template_paths

Φιλτράρει τους καταλόγους που σαρώνονται για αρχεία template.json.

PHP
add_filter( 'blockstudio/site_templates/template_paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/site-templates';
    return $paths;
} );

blockstudio/site_templates/part_paths

Φιλτράρει τους καταλόγους που σαρώνονται για αρχεία part.json.

PHP
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/site-parts';
    return $paths;
} );

blockstudio/site_templates/paths

Φιλτράρει μαζί και τις δύο λίστες διαδρομών εντοπισμού. Η τιμή περιέχει πίνακες templates και parts.

PHP
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
    return $paths;
} );

blockstudio/site_templates/template_candidates

Φιλτράρει τα υποψήφια αρχεία πηγαίου κώδικα αφού επιλυθούν το manifest και το λογικό δέντρο πηγαίου κώδικα.

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

PHP
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
    return $templates;
} );

blockstudio/site_templates/parts

Φιλτράρει τα τμήματα προτύπων που επιστρέφει το registry API.

PHP
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
    return $parts;
} );

blockstudio/site_templates/template_content

Φιλτράρει μια συμβολοσειρά πηγαίου κώδικα προτύπου πριν το Blockstudio την αναλύσει σε blocks.

PHP
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
    return $content;
}, 10, 2 );

blockstudio/site_templates/part_content

Φιλτράρει μια συμβολοσειρά πηγαίου κώδικα τμήματος προτύπου πριν το Blockstudio την αναλύσει σε blocks.

PHP
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
    return $content;
}, 10, 2 );

blockstudio/site_templates/parser

Φιλτράρει το στιγμιότυπο του Blockstudio\Html_Parser που χρησιμοποιείται για ένα μεταγλωττισμένο πρότυπο ή τμήμα. Επιστρέψτε ένα Html_Parser· οι άλλες τιμές επαναφέρουν τον προεπιλεγμένο parser.

PHP
add_filter(
    'blockstudio/site_templates/parser',
    function( $parser, $item ) {
        return $parser;
    },
    10,
    2
);

blockstudio/site_templates/discovered

Ενέργεια που ενεργοποιείται μετά από έναν κύκλο ψυχρού εντοπισμού και μεταγλώττισης, πριν αποθηκευτεί το αναδημιουργημένο registry.

PHP
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
    // Inspect the rebuilt Site_Template_Registry.
} );

blockstudio/site_templates/registered

Ενέργεια που ενεργοποιείται μετά την αποθήκευση ενός αναδημιουργημένου registry προτύπων Site Editor που βασίζεται σε αρχεία.

PHP
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
    // $registry is the Site_Template_Registry instance
} );

Οι ενέργειες discovered και registered δεν ενεργοποιούνται όταν υπάρχει επιτυχής ανάκτηση από θερμή cache του registry.