excerpt_allowed_blocks
云策文档标注
概述
excerpt_allowed_blocks 是一个 WordPress 过滤器,用于控制哪些块(blocks)可以贡献到摘要(excerpt)中。它允许开发者自定义允许的块列表,以避免无限循环问题。
关键要点
- 这是一个过滤器钩子,用于过滤允许贡献到摘要的块列表。
- 如果动态块被添加到允许列表中,必须确保它不会生成另一个摘要,否则会导致无限循环。
- 参数 $allowed_blocks 是一个字符串数组,表示允许的块名称列表。
- 在 WordPress 5.0.0 版本中引入。
代码示例
$allowed_blocks = apply_filters( 'excerpt_allowed_blocks', $allowed_blocks );注意事项
- 动态块添加到允许列表时需谨慎,避免生成额外摘要引发无限循环。
原文内容
Filters the list of blocks that can contribute to the excerpt.
Description
If a dynamic block is added to this list, it must not generate another excerpt, as this will cause an infinite loop to occur.
Parameters
$allowed_blocksstring[]-
The list of names of allowed blocks.
Source
$allowed_blocks = apply_filters( 'excerpt_allowed_blocks', $allowed_blocks );
Changelog
| Version | Description |
|---|---|
| 5.0.0 | Introduced. |