функция
since 2.1.0
add_rewrite_tag()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
add_rewrite_tag( string $tag, string $regex, string $query = '' )Описание
Параметр $query необязателен. Если он опущен, необходимо вызывать это на хуке ‘init’ или раньше. Это связано с тем, что $query по умолчанию равен $tag=, и для работы нужно добавить новую переменную запроса.
Оригинал (английский)
The $query parameter is optional. If it is omitted you must ensure that you call this on, or before, the ‘init’ hook. This is because $query defaults to $tag=, and for this to work a new query var has to be added.
Параметры
$tag
string
обязательный
Имя нового тега перезаписи.
$regex
string
обязательный
Регулярное выражение, на которое подставляется тег в правилах перезаписи.
$query
string
необязательный
= ''
Строка, добавляемая к переписанному запросу. Должна заканчиваться на '='.
Исходный код
wp-includes/rewrite.php:162
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 );
}История изменений
| Версия | Описание |
|---|---|
| 2.1.0 | Introduced. |
