Changeset 52987

Timestamp:

03/24/2022 10:24:52 AM (4 years ago)

Author:

spacedmonkey

Message:

Taxonomy: Introduce term_exists_default_query_args filter.

In [52921] term_exists was converted to use get_terms. This change adds a filter called term_exists_default_query_args
to the term_exists function to allow developers to modify the arguments passed to get_terms before the query is run.

Props Chouby, Spacedmonkey, peterwilsoncc.
Fixes #55439.

File:

• trunk/src/wp-includes/taxonomy.php (modified) (1 diff)

trunk/src/wp-includes/taxonomy.php

@@ -1560 +1560 @@
         }
 
+        /**
+         * Filters default arguments for checking if term exists.
+         *
+         * @since 6.0.0
+         *
+         * @param array      $defaults An array of arguments for term_exists.
+         * @param int|string $term     The term to check. Accepts term ID, slug, or name.
+         * @param string     $taxonomy The taxonomy name to use. An empty string indicates the search is against all taxonomies.
+         * @param int|null   $parent   ID of parent term under which to confine the exists search. Null indicates the search is unconfined.
+         */
+        $defaults = apply_filters( 'term_exists_default_query_args', $defaults, $term, $taxonomy, $parent );
+
         if ( is_int( $term ) ) {
                 if ( 0 === $term ) {