在WordPress中，`excerpt_allowed_wrapper_blocks`是一个钩子（hook），用于定义允许在摘要（excerpt）中包装内容的块（blocks）。
摘要是指在文章列表中显示的文章部分，它通常是文章的开头几个段落。 默认情况下，WordPress的摘要不支持包含任何块元素（如标题、段落、图像等）。
使用`excerpt_allowed_wrapper_blocks`钩子，你可以定义允许在摘要中包装的特定块元素。这样，你就可以在摘要中显示更丰富的内容。
以下是使用`excerpt_allowed_wrapper_blocks`钩子的示例代码：
function custom_excerpt_allowed_wrapper_blocks($wrapper_blocks) {
$wrapper_blocks[] = 'core/paragraph'; // 允许包装段落块
$wrapper_blocks[] = 'core/image'; // 允许包装图像块
return $wrapper_blocks;
}
add_filter('excerpt_allowed_wrapper_blocks', 'custom_excerpt_allowed_wrapper_blocks');
在上面的代码中，我们定义了一个名为`custom_excerpt_allowed_wrapper_blocks`的函数，并将其作为`excerpt_allowed_wrapper_blocks`钩子的回调函数。在这个函数中，我们通过将特定块的名称添加到`$wrapper_blocks`数组中，来定义了允许在摘要中包装的块元素。在这个示例中，我们允许包装段落块（`core/paragraph`）和图像块（`core/image`）。
你可以根据你的需要添加或删除`$wrapper_blocks`数组中的块元素。
将上述代码添加到你的WordPress主题的`functions.php`文件中，保存并生效后，摘要就可以支持包含指定的块元素了。
需要注意的是，`excerpt_allowed_wrapper_blocks`钩子只对WordPress新版本中的Gutenberg编辑器生效。如果你使用的是旧版本的编辑器（如经典编辑器），那么这个钩子可能不起作用。
0 个评论