W3cubDocs

/WordPress

apply_filters( 'query_vars', string[] $public_query_vars )

Filters the query variables allowed before processing.

Description

Allows (publicly allowed) query vars to be added, removed, or changed prior to executing the query. Needed to allow custom rewrite rules using your own arguments to work, or any other custom query variables you want to be publicly available.

Parameters

$public_query_vars

(string[]) The array of allowed query variable names.

More Information

This filter allows query vars to be added, removed, or changed prior to executing the query.

Example


function themeslug_query_vars( $qvars ) {
	$qvars[] = 'custom_query_var';
	return $qvars;
}
add_filter( 'query_vars', 'themeslug_query_vars' );

Source

File: wp-includes/class-wp.php

View on Trac

Changelog

Version Description
1.5.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/query_vars