add_rewrite_tag()

添加新的重写标记（如％postname％）。

原型

add_rewrite_tag( string $tag, string $regex, string $query = '' )

描述

$ query参数是可选的。如果省略，则必须确保在’init’挂钩之前或之前调用它。这是因为$ query默认为“$ tag =”，为此，必须添加一个新的查询var。

参数

$tag (string) (Required) 新重写标记的名称。

$regex (string) (Required) 正则表达式，用于在重写规则中替换标记。

$query (string) (Optional)  要附加到重写查询的字符串。必须以’=’结尾。

源文件

路径：wp-includes/rewrite.php

<?php
...
function add_rewrite_tag( $tag, $regex, $query = '' ) {
	// validate the tag's name
	if ( strlen( $tag ) < 3 || $tag[0] != '%' || $tag[ strlen($tag) - 1 ] != '%' )
		return;
	global $wp_rewrite, $wp;
	if ( empty( $query ) ) {
		$qv = trim( $tag, '%' );
		$wp->add_query_var( $qv );
		$query = $qv . '=';
	}
	$wp_rewrite->add_rewrite_tag( $tag, $regex, $query );
}
...
?>

其他

英文文档：https://developer.wordpress.org/reference/functions/add_rewrite_tag/