当前浏览:首页 / WordPress钩子 / the_title

apply_filters( 'the_title', string $title, int $id )

过滤文章标题

themore...

titlemore...


参数

$title

(string) 文章标题

$id

(int) 文章 ID


说明

the_title应用于从数据库检索的文章标题,然后再打印在屏幕上。在某些情况下(例如使用the_title时),可以通过从filter函数返回假值(例如NULLFALSE或空字符串)来抑制标题。



源码

查看源码 官方文档


更新日志

版本描述
0.71开始引入

使用示例

  • 示例1

    抑制“blurb”类别中所有文章的标题:

    function suppress_if_blurb( $title, $id = null ) {
    
        if ( in_category(' blurb', $id ) ) {
            return '';
        }
    
        return $title;
    }
    add_filter( 'the_title', 'suppress_if_blurb', 10, 2 );
    

    注意添加了null作为$id变量的默认值。这是因为此过滤器的某些使用实例没有提供post ID。此不一致性在3.1版中引入,并在3.3版中修复(请参见ticket #16688)。如果希望与这些旧版本兼容,则需要如上所述提供默认值,否则会出现PHP警告,指出缺少参数。如果不需要支持3.1或3.2,则无需为$id指定默认值。