概述

excerpt_remove_blocks() 函数用于从内容字符串中解析块，并渲染适合摘要的块。它通过过滤允许的块类型，确保摘要仅包含文本相关的内容，避免无限循环。

关键要点

• 函数检查内容是否包含块，若无则直接返回原内容。
• 定义允许的内部块（如 core/paragraph、core/heading）和包装块（如 core/columns、core/group），并通过过滤器 excerpt_allowed_blocks 和 excerpt_allowed_wrapper_blocks 允许自定义。
• 处理块时，跳过包含不允许或嵌套内部块的块，并渲染符合条件的块。

代码示例

function excerpt_remove_blocks( $content ) {
    if ( ! has_blocks( $content ) ) {
        return $content;
    }

    $allowed_inner_blocks = array(
        null,
        'core/freeform',
        'core/heading',
        'core/html',
        'core/list',
        'core/media-text',
        'core/paragraph',
        'core/preformatted',
        'core/pullquote',
        'core/quote',
        'core/table',
        'core/verse',
    );

    $allowed_wrapper_blocks = array(
        'core/columns',
        'core/column',
        'core/group',
    );

    $allowed_wrapper_blocks = apply_filters( 'excerpt_allowed_wrapper_blocks', $allowed_wrapper_blocks );
    $allowed_blocks = array_merge( $allowed_inner_blocks, $allowed_wrapper_blocks );
    $allowed_blocks = apply_filters( 'excerpt_allowed_blocks', $allowed_blocks );
    $blocks = parse_blocks( $content );
    $output = '';

    foreach ( $blocks as $block ) {
        if ( in_array( $block['blockName'], $allowed_blocks, true ) ) {
            if ( ! empty( $block['innerBlocks'] ) ) {
                if ( in_array( $block['blockName'], $allowed_wrapper_blocks, true ) ) {
                    $output .= _excerpt_render_inner_blocks( $block, $allowed_blocks );
                    continue;
                }

                foreach ( $block['innerBlocks'] as $inner_block ) {
                    if (
                        ! in_array( $inner_block['blockName'], $allowed_inner_blocks, true ) ||
                        ! empty( $inner_block['innerBlocks'] )
                    ) {
                        continue 2;
                    }
                }
            }

            $output .= render_block( $block );
        }
    }

    return $output;
}

注意事项

• 动态块添加到允许列表时，必须避免生成另一个摘要，否则可能导致无限循环。
• 函数依赖于 parse_blocks()、has_blocks() 和 render_block() 等核心函数。