본문으로 건너뛰기

훅

페이지, 패턴, 사이트 템플릿 및 HTML 파서를 사용자 지정하는 데 사용할 수 있는 필터와 액션입니다.

파서

blockstudio/block_tags/builders

블록 태그와 요소 매핑 사용자 지정 블록에서 사용하는 블록 배열 빌더를 등록합니다. 각 블록의 콜백은 속성 배열과 원시 내부 콘텐츠를 받습니다.

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은 동일한 레지스트리를 받습니다. blockstudio/block_tags/builders 다음에 이 순서대로 실행되며, 같은 블록의 이전 빌더를 대체할 수 있습니다.

blockstudio/parser/element_mapping

기본 HTML 요소-블록 매핑을 재정의합니다. 기본적으로 <h1>, <p>, <img> 같은 표준 HTML 요소는 코어 WordPress 블록에 매핑됩니다. 이 필터를 사용하면 어떤 요소든 다른 블록을 가리키도록 설정할 수 있습니다.

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 리치 텍스트 속성이 있는 등록된 비코어 Blockstudio 블록에 매핑되면, 내부 HTML가 code 및 img처럼 요소 매핑이 적용된 인라인 태그를 포함해 해당 속성으로 복사됩니다. 이미지 하나만 자식으로 가진 문단은 <img>가 매핑하는 블록이 됩니다. 중첩된 블록 태그 또는 블록 수준 HTML는 일반적인 내부 블록 파싱 동작을 유지합니다.

페이지

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

업그레이드 중 지속형 컬렉션 런타임의 초기값으로 사용할 수 있는 레거시 7.6.2 이전 매니페스트 캐시의 최대 수명을 필터링합니다. 일반 요청은 지속형 컬렉션 구성을 사용하며 페이지 루트를 주기적으로 다시 검색하지 않습니다. 컬렉션 매니페스트를 변경한 후에는 wp bs pages sync을 실행하거나 Blockstudio\Pages::reconcile()를 호출하세요.

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

매니페스트와 논리적 소스 트리를 확인한 뒤 소스 파일 후보를 필터링합니다.

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

레지스트리 API가 반환하는 전체 템플릿을 필터링합니다.

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

blockstudio/site_templates/parts

레지스트리 API가 반환하는 템플릿 파트를 필터링합니다.

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

blockstudio/site_templates/template_content

Blockstudio가 템플릿 소스 문자열을 블록으로 파싱하기 전에 필터링합니다.

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

blockstudio/site_templates/part_content

Blockstudio가 템플릿 파트 소스 문자열을 블록으로 파싱하기 전에 필터링합니다.

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

blockstudio/site_templates/parser

컴파일된 템플릿 또는 파트 하나에 사용할 Blockstudio\Html_Parser 인스턴스를 필터링합니다. Html_Parser을 반환하세요. 다른 값을 반환하면 기본 파서를 사용합니다.

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

blockstudio/site_templates/discovered

콜드 검색 및 컴파일이 끝난 뒤 재구축된 레지스트리가 저장되기 전에 실행되는 액션입니다.

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

blockstudio/site_templates/registered

파일 기반 Site Editor 템플릿 레지스트리가 재구축되어 저장된 뒤 실행되는 액션입니다.

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

discovered 및 registered 액션은 워밍된 레지스트리 캐시 적중 시 실행되지 않습니다.