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数组中的块名称,你可以根据需要控制摘要的内容。