apply_filters( ‘the_title’, string $post_title, int $post_id )
过滤文章标题。
参数
$post_title string
帖子标题。
$post_id int
帖子 ID。
更多信息
the_title 是应用于从数据库检索的帖子标题的过滤器,在屏幕上打印之前。在某些情况下(例如使用 the_title 时),可以通过从过滤函数返回错误值(例如 NULL、FALSE 或空字符串)来抑制标题。
示例一
隐藏“blurb”类别中所有帖子模板中的标题:
add_filter( 'the_title', 'suppress_if_blurb', 10, 2 ); function suppress_if_blurb( $title, $id = null ) { if ( in_category(' blurb', $id ) ) { return ''; } return $title; }
注意: $id 变量的默认值为 null。这是因为使用此过滤器的某些实例未提供帖子 ID。此不一致是在版本 3.1 中引入的,并在版本 3.3 中修复(请参阅票号 #16688)。如果您想要与这些旧版本兼容,则需要提供如上所述的默认值,否则您将收到 PHP 警告,指出您缺少参数。如果您不需要支持 3.1 或 3.2,则无需为 $id 指定默认值。
示例二
在网站上呈现大写的文章标题,如下所示:
add_filter( 'the_title', 'wpdocs_capitalise_post_titles' ); function wpdocs_capitalise_post_titles( $title ) { return ucwords( $title ); }