参数
- $title
-
(string) 文章标题
- $id
-
(int) 文章 ID
说明
the_title
应用于从数据库检索的文章标题,然后再打印在屏幕上。在某些情况下(例如使用the_title时),可以通过从filter函数返回假值(例如NULL
、FALSE
或空字符串)来抑制标题。
源码
更新日志
版本 | 描述 |
---|---|
0.71 | 开始引入 |
使用示例
抑制“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
指定默认值。