钩子文档

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.