Hooki
Filtry i akcje służące do dostosowywania stron, wzorców, szablonów witryny oraz parsera HTML.
Parser
blockstudio/block_tags/builders
Rejestruje konstruktory tablic bloków używane przez tagi bloków i niestandardowe bloki mapowane na elementy. Funkcja zwrotna każdego bloku otrzymuje tablicę atrybutów i surową zawartość wewnętrzną.
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 i blockstudio/parser/renderers korzystają z tego samego rejestru. Są uruchamiane po blockstudio/block_tags/builders, w tej kolejności, i mogą zastąpić wcześniejszy konstruktor dla tego samego bloku.
blockstudio/parser/element_mapping
Zastępuje domyślne mapowanie elementów HTML na bloki. Domyślnie standardowe elementy HTML, takie jak <h1>, <p> i <img>, są mapowane na bloki podstawowe WordPress. Użyj tego filtra, aby przypisać dowolny element do innego bloku.
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 );
Jeśli <p> mapuje się na zarejestrowany blok spoza rdzenia Blockstudio z atrybutem richtext content, jego wewnętrzna zawartość HTML jest kopiowana do tego atrybutu, łącznie z tagami w tekście, takimi jak code i img, które również są mapowane na elementy. Akapit, którego jedynym elementem potomnym jest obraz, staje się blokiem wskazanym przez mapowanie <img>. Zagnieżdżone tagi bloków lub elementy HTML na poziomie bloku zachowują standardowe parsowanie bloków wewnętrznych.
Strony
blockstudio/pages/paths
Filtruje katalogi przeszukiwane w poszukiwaniu szablonów stron.
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
Filtruje maksymalny wiek pamięci podręcznej manifestu sprzed 7.6.2, który może zasilić utrwalone środowisko uruchomieniowe kolekcji podczas aktualizacji. Zwykłe żądania korzystają z utrwalonej konfiguracji kolekcji i nie skanują okresowo katalogów stron. Uruchom wp bs pages sync lub wywołaj Blockstudio\Pages::reconcile() po zmianie manifestu kolekcji.
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
return 10;
} );
blockstudio/pages/create_post_data
Filtruje dane wpisu przed utworzeniem nowej strony.
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
Filtruje dane wpisu przed aktualizacją istniejącej strony.
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
return $post_data;
}, 10, 3 );
blockstudio/pages/synced
Akcja uruchamiana po zsynchronizowaniu wszystkich stron.
add_action( 'blockstudio/pages/synced', function( $registry ) {
// $registry is the Page_Registry instance
} );
blockstudio/pages/post_created
Akcja uruchamiana po utworzeniu wpisu strony.
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
// Do something after page creation
}, 10, 2 );
blockstudio/pages/post_updated
Akcja uruchamiana po zaktualizowaniu wpisu strony.
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
// Do something after page update
}, 10, 2 );
Wzorce
blockstudio/patterns/paths
Filtruje katalogi przeszukiwane w poszukiwaniu szablonów wzorców.
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
blockstudio/patterns/registered
Akcja uruchamiana po zarejestrowaniu wszystkich wzorców.
add_action( 'blockstudio/patterns/registered', function( $registry ) {
// $registry is the Pattern_Registry instance
} );
Szablony witryny
blockstudio/site_templates/template_paths
Filtruje katalogi przeszukiwane w poszukiwaniu plików template.json.
add_filter( 'blockstudio/site_templates/template_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-templates';
return $paths;
} );
blockstudio/site_templates/part_paths
Filtruje katalogi przeszukiwane w poszukiwaniu plików part.json.
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-parts';
return $paths;
} );
blockstudio/site_templates/paths
Filtruje jednocześnie obie listy ścieżek wyszukiwania. Wartość zawiera tablice templates i parts.
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
return $paths;
} );
blockstudio/site_templates/template_candidates
Filtruje kandydatów na pliki źródłowe po rozstrzygnięciu manifestu i logicznego drzewa źródeł.
add_filter(
'blockstudio/site_templates/template_candidates',
function( $candidates, $directory, $manifest ) {
$candidates[] = $directory . '/template.custom.php';
return $candidates;
},
10,
3
);
blockstudio/site_templates/templates
Filtruje pełne szablony zwracane przez rejestr API.
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
return $templates;
} );
blockstudio/site_templates/parts
Filtruje części szablonów zwracane przez rejestr API.
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
return $parts;
} );
blockstudio/site_templates/template_content
Filtruje źródłowy ciąg szablonu przed sparsowaniem go na bloki przez Blockstudio.
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/part_content
Filtruje źródłowy ciąg części szablonu przed sparsowaniem go na bloki przez Blockstudio.
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/parser
Filtruje instancję Blockstudio\Html_Parser używaną dla pojedynczego skompilowanego szablonu lub jego części. Zwróć wartość Html_Parser; inne wartości powodują użycie domyślnego parsera.
add_filter(
'blockstudio/site_templates/parser',
function( $parser, $item ) {
return $parser;
},
10,
2
);
blockstudio/site_templates/discovered
Akcja uruchamiana po przebiegu wyszukiwania i kompilacji przy pustej pamięci podręcznej, przed utrwaleniem przebudowanego rejestru.
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
// Inspect the rebuilt Site_Template_Registry.
} );
blockstudio/site_templates/registered
Akcja uruchamiana po utrwaleniu przebudowanego rejestru szablonów Edytora witryny opartych na plikach.
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
// $registry is the Site_Template_Registry instance
} );
Akcje discovered i registered nie są uruchamiane przy trafieniu w ciepłą pamięć podręczną rejestru.