W3cubDocs

/WordPress

WP_Tax_Query::__construct( array $tax_query )

Constructor.

Parameters

$tax_query

(array) (Required) Array of taxonomy query clauses.

  • 'relation'
    (string) Optional. The MySQL keyword used to join the clauses of the query. Accepts 'AND', or 'OR'. Default 'AND'.
  • '...$0'
    (array) An array of first-order clause parameters, or another fully-formed tax query.
    • 'taxonomy'
      (string) Taxonomy being queried. Optional when field=term_taxonomy_id.
    • 'terms'
      (string|int|array) Term or terms to filter by.
    • 'field'
      (string) Field to match $terms against. Accepts 'term_id', 'slug', 'name', or 'term_taxonomy_id'. Default: 'term_id'.
    • 'operator'
      (string) MySQL operator to be used with $terms in the WHERE clause. Accepts 'AND', 'IN', 'NOT IN', 'EXISTS', 'NOT EXISTS'. Default: 'IN'.
    • 'include_children'
      (bool) Optional. Whether to include child terms. Requires a $taxonomy. Default: true.

Source

File: wp-includes/class-wp-tax-query.php 

public function __construct( $tax_query ) {
		if ( isset( $tax_query['relation'] ) ) {
			$this->relation = $this->sanitize_relation( $tax_query['relation'] );
		} else {
			$this->relation = 'AND';
		}

		$this->queries = $this->sanitize_query( $tax_query );
	}

Used By

Used By Description
wp-includes/class-wp-query.php: WP_Query::parse_tax_query()

Parses various taxonomy related query vars.
wp-includes/taxonomy.php: get_tax_sql()

Given a taxonomy query, generates SQL to be appended to a main query.

Changelog

Version Description
4.1.0 Added support for $operator 'NOT EXISTS' and 'EXISTS' values.
3.1.0 Introduced.

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