WP_Tax_Query::clean_query() │ private │ WP 3.2.0

Validates a single query.

Method of the class: WP_Tax_Query{}

No Hooks.

Return

null. Nothing (null).

Usage

// private - for code of main (parent) class only
$result = $this->clean_query( $query );

$query(array) (required) (passed by reference — &)

The single query. Passed by reference.

Changelog

WP_Tax_Query::clean_query() WP Tax Query::clean query code ^{WP 6.7.2}

private function clean_query( &$query ) {
	if ( empty( $query['taxonomy'] ) ) {
		if ( 'term_taxonomy_id' !== $query['field'] ) {
			$query = new WP_Error( 'invalid_taxonomy', __( 'Invalid taxonomy.' ) );
			return;
		}

		// So long as there are shared terms, 'include_children' requires that a taxonomy is set.
		$query['include_children'] = false;
	} elseif ( ! taxonomy_exists( $query['taxonomy'] ) ) {
		$query = new WP_Error( 'invalid_taxonomy', __( 'Invalid taxonomy.' ) );
		return;
	}

	if ( 'slug' === $query['field'] || 'name' === $query['field'] ) {
		$query['terms'] = array_unique( (array) $query['terms'] );
	} else {
		$query['terms'] = wp_parse_id_list( $query['terms'] );
	}

	if ( is_taxonomy_hierarchical( $query['taxonomy'] ) && $query['include_children'] ) {
		$this->transform_query( $query, 'term_id' );

		if ( is_wp_error( $query ) ) {
			return;
		}

		$children = array();
		foreach ( $query['terms'] as $term ) {
			$children   = array_merge( $children, get_term_children( $term, $query['taxonomy'] ) );
			$children[] = $term;
		}
		$query['terms'] = $children;
	}

	$this->transform_query( $query, 'term_taxonomy_id' );
}