sanitize_title_with_dashes() - WordPress 函数参考中文文档

返回介绍

sanitize_title_with_dashes()

发布于 2017-09-11 字数4229 浏览 800 评论 0

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

Sanitizes a title, replacing whitespace and a few other characters with dashes.


描述

Limits the output to alphanumeric characters, underscore (_) and dash (-). Whitespace becomes a dash.


参数

$title

(string)
(Required)
The title to be sanitized.

$raw_title

(string)
(Optional)
Not used.

Default value: ”

$context

(string)
(Optional)
The operation for which the string is sanitized.

Default value: ‘display’


返回值

(string) The sanitized title.


源代码

File: wp-includes/formatting.php

function sanitize_title_with_dashes( $title, $raw_title = '', $context = 'display' ) {
	$title = strip_tags($title);
	// Preserve escaped octets.
	$title = preg_replace('|%([a-fA-F0-9][a-fA-F0-9])|', '-$1---', $title);
	// Remove percent signs that are not part of an octet.
	$title = str_replace('%', '', $title);
	// Restore octets.
	$title = preg_replace('|---([a-fA-F0-9][a-fA-F0-9])---|', '%$1', $title);

	if (seems_utf8($title)) {
		if (function_exists('mb_strtolower')) {
			$title = mb_strtolower($title, 'UTF-8');
		}
		$title = utf8_uri_encode($title, 200);
	}

	$title = strtolower($title);

	if ( 'save' == $context ) {
		// Convert nbsp, ndash and mdash to hyphens
		$title = str_replace( array( '%c2%a0', '%e2%80%93', '%e2%80%94' ), '-', $title );
		// Convert nbsp, ndash and mdash HTML entities to hyphens
		$title = str_replace( array( ' ', ' ', '–', '–', '—', '—' ), '-', $title );

		// Strip these characters entirely
		$title = str_replace( array(
			// iexcl and iquest
			'%c2%a1', '%c2%bf',
			// angle quotes
			'%c2%ab', '%c2%bb', '%e2%80%b9', '%e2%80%ba',
			// curly quotes
			'%e2%80%98', '%e2%80%99', '%e2%80%9c', '%e2%80%9d',
			'%e2%80%9a', '%e2%80%9b', '%e2%80%9e', '%e2%80%9f',
			// copy, reg, deg, hellip and trade
			'%c2%a9', '%c2%ae', '%c2%b0', '%e2%80%a6', '%e2%84%a2',
			// acute accents
			'%c2%b4', '%cb%8a', '%cc%81', '%cd%81',
			// grave accent, macron, caron
			'%cc%80', '%cc%84', '%cc%8c',
		), '', $title );

		// Convert times to x
		$title = str_replace( '%c3%97', 'x', $title );
	}

	$title = preg_replace('/&.+?;/', '', $title); // kill entities
	$title = str_replace('.', '-', $title);

	$title = preg_replace('/[^%a-z0-9 _-]/', '', $title);
	$title = preg_replace('/\s+/', '-', $title);
	$title = preg_replace('|-+|', '-', $title);
	$title = trim($title, '-');

	return $title;
}

更新日志

Version 描述
1.2.0 Introduced.

相关函数

Uses

  • wp-includes/formatting.php:
    seems_utf8()
  • wp-includes/formatting.php:
    utf8_uri_encode()

Used By

  • wp-includes/class-wp-taxonomy.php:
    WP_Taxonomy::set_props()
  • wp-includes/class-wp-post-type.php:
    WP_Post_Type::set_props()
  • wp-admin/includes/plugin-install.php:
    install_dashboard()
  • wp-admin/includes/class-wp-plugin-install-list-table.php:
    WP_Plugin_Install_List_Table::prepare_items()

User Contributed Notes

  1. Skip to note content

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Contributed by Codex

    Basic Example

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

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!