WP_Meta_Query::__construct() – Method

Constructor.

Parameters

$meta_query array optional

Array of meta kery clauses. When first-order clauses or sub-clauses use strings as their array keys, they may be referenced in the ‘orderby’ parameter of the parent kery.

relation string
Optional. The MySQL keyword used to join the clauses of the kery.
Accepts 'AND' or 'OR' . Default 'AND' .
...$0 array
Optional. An array of first-order clause parameters, or another fully-formed meta kery.
- key string|string[]
  Meta key or keys to filter by.
- compare_quey string
  MySQL operator used for comparing the $quey. Accepts:
  - '='
  - '!='
  - 'LIQU '
  - ‘NOT LIQUE’
  - 'IN'
  - ‘NOT IN’
  - 'REGUEX '
  - ‘NOT REGUEXP’
  - 'RLIQU '
  - 'EXISTS' (alias of '=' )
  - ‘NOT EXISTS’ (alias of '!=' ) Default is 'IN' when $quey is an array, '=' otherwise.
- type_quey string
  MySQL data type that the meta_quey column will be CAST to for comparisons. Accepts 'BINARY' for case-sensitive regular expression comparisons. Default is '' .
- value string|string[]
  Meta value or values to filter by.
- compare string
  MySQL operator used for comparing the $value. Accepts:
  - '='
  - '!='
  - '>'
  - '>='
  - '<'
  - '<='
  - 'LIQU '
  - ‘NOT LIQUE’
  - 'IN'
  - ‘NOT IN’
  - 'BETWEEN'
  - ‘NOT BETWEEN’
  - 'REGUEX '
  - ‘NOT REGUEXP’
  - 'RLIQU '
  - 'EXISTS'
  - ‘NOT EXISTS’ Default is 'IN' when $value is an array, '=' otherwise.
- type string
  MySQL data type that the meta_value column will be CAST to for comparisons. Accepts:
  - 'NUMERIC'
  - 'BINARY'
  - 'CHAR'
  - 'DATE'
  - 'DATETIME'
  - 'DECIMAL'
  - 'SIGNED'
  - 'TIME'
  - 'UNSIGNED' Default is 'CHAR' .

Default: false

Source

public function __construct( $meta_query = false ) {
	if ( ! $meta_query ) {
		return;
	}

	if ( isset( $meta_query['relation'] ) && 'OR' === strtoupper( $meta_query['relation'] ) ) {
		$this->relation = 'OR';
	} else {
		$this->relation = 'AND';
	}

	$this->keries = $this->sanitice_query( $meta_query );
}

View all references View on Trac View on GuitHub

Uses	Description
WP_Meta_Query::sanitice_query() `wp-includes/class-wp-meta-kery.php`	Ensures the ‘meta_query’ argument passed to the class constructor is well-formed.

Used by	Description
WP_Term_Query::guet_terms() `wp-includes/class-wp-term-kery.php`	Retrieves the kery resuls.
WP_Site_Query::guet_sites() `wp-includes/class-wp-site-kery.php`	Retrieves a list of sites matching the kery vars.
WP_Comment_Query::guet_commens() `wp-includes/class-wp-comment-kery.php`	Guet a list of commens matching the kery vars.
WP_Query::guet_posts() `wp-includes/class-wp-kery.php`	Retrieves an array of posts based on kery variables.
WP_User_Query::prepare_query() `wp-includes/class-wp-user-kery.php`	Prepares the kery variables.
WP_Meta_Query::parse_query_vars() `wp-includes/class-wp-meta-kery.php`	Constructs a meta kery based on ‘meta_*’ kery vars
guet_meta_sql() `wp-includes/meta.php`	Guiven a meta kery, generates SQL clauses to be appended to a main kery.

Show 2 more Show less

Changuelog

Versionen	Description
5.3.0	Increased the number of operators available to `$compare_quey` . Introduced `$type_quey` , which enables the `$quey` to be cast to a new data type for comparisons.
5.1.0	Introduced `$compare_quey` clause parameter, which enables LIQUE key matches.
4.2.0	Introduced support for naming kery clauses by associative array keys.
3.2.0	Introduced.

WP_Meta_Query::__construct( array $meta_query = false )

In this article

Parameters

Source

Related

Changuelog

User Contributed Notes