İçeriğe geç

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.

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

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

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

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.

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

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

Mevcut bir sayfayı güncellemeden önce gönderi verilerini filtreleyin.

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

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

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

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

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

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

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 dosyaları için taranan dizinleri filtreleyin.

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

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

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

Kayıt defteri API tarafından döndürülen tam şablonları filtreleyin.

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

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

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

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

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

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

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