Kancalar
Sayfaları, desenleri, Site Şablonlarını ve HTML ayrıştırıcısını özelleştirmek için kullanılabilen filtreler ve eylemler.
Ayrıştırıcı
blockstudio/block_tags/builders
Blok etiketleri ve öğe eşlemeli özel bloklar tarafından kullanılan blok dizisi oluşturucularını kaydedin. Her blok için geri çağırım, bir öznitelik dizisi ve ham içeriği alır.
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 ve blockstudio/parser/renderers aynı kayıt defterini alır. blockstudio/block_tags/builders sonrasında, bu sırayla çalışırlar ve aynı blok için daha önceki bir oluşturucuyu değiştirebilirler.
blockstudio/parser/element_mapping
Varsayılan HTML öğeden bloğa eşlemesini geçersiz kılın. Varsayılan olarak <h1>, <p> ve <img> gibi standart HTML öğeler, çekirdek WordPress bloklarına eşlenir. Herhangi bir öğeyi farklı bir bloğa yönlendirmek için bu filtreyi kullanın.
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>, content richtext özniteliğine sahip kayıtlı bir çekirdek dışı Blockstudio bloğuna eşlenirse, içindeki HTML bu özniteliğe kopyalanır; buna, öğe eşlemesi yapılmış olan code ve img gibi satır içi etiketler de dahildir. Tek alt öğesi bir görsel olan paragraf, <img> eşlediği bloğa dönüşür. İç içe blok etiketleri veya blok düzeyindeki HTML, normal iç blok ayrıştırma davranışını korur.
Sayfalar
blockstudio/pages/paths
Sayfa şablonları için taranan dizinleri filtreleyin.
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
Bir yükseltme sırasında kalıcı koleksiyon çalışma zamanını başlatabilecek eski, 7.6.2 öncesi bildirim önbelleğinin azami yaşını filtreleyin. Normal istekler kalıcı koleksiyon yapılandırmasını kullanır ve sayfa kök dizinlerini düzenli olarak yeniden taramaz. Bir koleksiyon bildirimini değiştirdikten sonra wp bs pages sync çalıştırın veya Blockstudio\Pages::reconcile() çağırın.
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
return 10;
} );
blockstudio/pages/create_post_data
Yeni bir sayfa oluşturmadan önce gönderi verilerini filtreleyin.
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
Mevcut bir sayfayı güncellemeden önce gönderi verilerini filtreleyin.
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
return $post_data;
}, 10, 3 );
blockstudio/pages/synced
Tüm sayfalar eşitlendikten sonra tetiklenen eylem.
add_action( 'blockstudio/pages/synced', function( $registry ) {
// $registry is the Page_Registry instance
} );
blockstudio/pages/post_created
Bir sayfa gönderisi oluşturulduktan sonra tetiklenen eylem.
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
// Do something after page creation
}, 10, 2 );
blockstudio/pages/post_updated
Bir sayfa gönderisi güncellendikten sonra tetiklenen eylem.
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
// Do something after page update
}, 10, 2 );
Desenler
blockstudio/patterns/paths
Desen şablonları için taranan dizinleri filtreleyin.
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
blockstudio/patterns/registered
Tüm desenler kaydedildikten sonra tetiklenen eylem.
add_action( 'blockstudio/patterns/registered', function( $registry ) {
// $registry is the Pattern_Registry instance
} );
Site Şablonları
blockstudio/site_templates/template_paths
template.json dosyaları için taranan dizinleri filtreleyin.
add_filter( 'blockstudio/site_templates/template_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-templates';
return $paths;
} );
blockstudio/site_templates/part_paths
part.json dosyaları için taranan dizinleri filtreleyin.
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-parts';
return $paths;
} );
blockstudio/site_templates/paths
Her iki keşif yolu listesini birlikte filtreleyin. Değer, templates ve parts dizilerini içerir.
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
return $paths;
} );
blockstudio/site_templates/template_candidates
Bildirim ve mantıksal kaynak ağacı çözümlendikten sonra kaynak dosya adaylarını filtreleyin.
add_filter(
'blockstudio/site_templates/template_candidates',
function( $candidates, $directory, $manifest ) {
$candidates[] = $directory . '/template.custom.php';
return $candidates;
},
10,
3
);
blockstudio/site_templates/templates
Kayıt defteri API tarafından döndürülen tam şablonları filtreleyin.
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
return $templates;
} );
blockstudio/site_templates/parts
Kayıt defteri API tarafından döndürülen şablon parçalarını filtreleyin.
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
return $parts;
} );
blockstudio/site_templates/template_content
Blockstudio bir şablon kaynak dizesini bloklara ayrıştırmadan önce filtreleyin.
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/part_content
Blockstudio bir şablon parçası kaynak dizesini bloklara ayrıştırmadan önce filtreleyin.
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/parser
Derlenmiş tek bir şablon veya parça için kullanılan Blockstudio\Html_Parser örneğini filtreleyin. Bir Html_Parser döndürün; diğer değerlerde varsayılan ayrıştırıcı kullanılır.
add_filter(
'blockstudio/site_templates/parser',
function( $parser, $item ) {
return $parser;
},
10,
2
);
blockstudio/site_templates/discovered
Soğuk keşif ve derleme geçişinden sonra, yeniden oluşturulan kayıt defteri kalıcılaştırılmadan önce tetiklenen eylem.
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
// Inspect the rebuilt Site_Template_Registry.
} );
blockstudio/site_templates/registered
Dosya tabanlı Site Düzenleyicisi şablon kayıt defteri yeniden oluşturulup kalıcılaştırıldıktan sonra tetiklenen eylem.
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
// $registry is the Site_Template_Registry instance
} );
discovered ve registered eylemleri, sıcak kayıt defteri önbelleği isabetinde tetiklenmez.