WordPress hook钩子excerpt_allowed_blocks的用法详解

WordPress中的excerpt_allowed_blocks钩子是用来控制摘要中允许使用的区块编辑器块的功能。excerpt_allowed_blocks钩子可以在主题或插件中使用，以便自定义允许在摘要中使用的块。

以下是使用excerpt_allowed_blocks钩子的步骤：

1. 添加钩子

在主题的functions.php文件或插件的主文件中，使用add_filter函数添加excerpt_allowed_blocks钩子。例如：

function custom_excerpt_allowed_blocks($allowed_blocks) {
// 自定义允许在摘要中使用的块
$allowed_blocks[] = 'core/paragraph';
$allowed_blocks[] = 'core/image';
return $allowed_blocks;
}
add_filter('excerpt_allowed_blocks', 'custom_excerpt_allowed_blocks');

上面的代码将允许在摘要中使用段落块(core/paragraph)和图片块(core/image)。

2. 自定义允许的块

根据你的需求，自定义允许在摘要中使用的块。你可以在$allowed_blocks数组中添加或移除块的名称。以下是一些常用的块名称：

- 核心块(Core Blocks)：'core/paragraph', 'core/heading', 'core/image'等。
- 文本块(Text Blocks)：'core/shortcode', 'core/html', 'core/freeform'等。
- 媒体块(Media Blocks)：'core/gallery', 'core/embed'等。
- 部件块(Widget Blocks)：'core/archives', 'core/categories'等。

3. 保存文件并刷新页面

保存修改的文件，并刷新WordPress的编辑页面或摘要页面。你将会看到摘要区块编辑器中仅显示允许的块。

总结：

使用excerpt_allowed_blocks钩子，你可以自定义允许在摘要中使用的区块编辑器块的功能。通过添加或移除$allowed_blocks数组中的块名称，你可以根据需要控制摘要的内容。