当前浏览:首页 / WordPress函数 / sanitize_title_with_dashes()

sanitize_title_with_dashes( string $title, string $raw_title = '', string $context = 'display' )

清理标题,用破折号替换空格和其他几个字符

kses 清理

sanitize 清理more...

titlemore...


描述

将输出限制为字母数字字符、下划线(_)和短划线(-)。空格变成破折号。


参数

$title

(string) (必填) 要清理的标题。

$raw_title

(string) (可选) 未使用

默认值: ''

$context

(string) (可选) 对字符串执行清理的操作。当设置为“save”时,其他实体将转换为连字符或完全剥离。

默认值: 'display'


返回

(string) 经过净化清理的标题。


说明

  • 该函数不替换特殊重音字符。
  • 此函数不对标题应用 sanitize_title 过滤器。


源码

查看源码 官方文档


更新日志

版本描述
1.2.0开始引入

使用示例

  • 示例1

    基本示例

    <?php
    echo sanitize_title_with_dashes("I'm in LOVE with WordPress!!!1");
    // this will print: im-in-love-with-wordpress1
    ?>
    
  • 示例2

    添加当前子站点body类–WordPress 多站点

    // Add Current Child-Site Body Class – Wordpress Multisite
    function wpdocs_childSiteClass( $classes ) {
    	$site_title =  sanitize_title_with_dashes( get_bloginfo( 'name' ) );
    	$classes[] = 'website-' . $site_title;
    
    	return $classes;
    }
    add_filter( 'body_class', 'wpdocs_childSiteClass' );