Changeset 31024 for trunk/src/wp-includes/taxonomy.php

Timestamp:

01/02/2015 09:33:33 PM (12 years ago)

Author:

boonebgorges

Message:

Introduce 'name' parameter for get_terms().

This enhancement requires a modification in the way that wp_dropdown_categories()
prepares its arguments for get_terms(), so that its unrelated 'name' param is
not mistaken for the new 'name' argument in get_terms().

Props danielbachhuber.
Fixes #30611.

File:

• trunk/src/wp-includes/taxonomy.php (modified) (4 diffs)

trunk/src/wp-includes/taxonomy.php

@@ -1549 +1549 @@
  *
  * @since 2.3.0
+ * @since 4.2.0 Introduced 'name' parameter.
  *
  * @global wpdb $wpdb WordPress database abstraction object.
@@ -1579 +1580 @@
  *                                           term objects), 'ids' or 'names' (returns an array of integers
  *                                           or strings, respectively. Default 'all'.
+ *     @type string|array $name              Optional. Name or array of names to return term(s) for. Default empty.
  *     @type string|array $slug              Optional. Slug or array of slugs to return term(s) for. Default empty.
  *     @type bool         $hierarchical      Whether to include terms that have non-empty descendants (even
@@ -1619 +1621 @@
         $defaults = array('orderby' => 'name', 'order' => 'ASC',
                 'hide_empty' => true, 'exclude' => array(), 'exclude_tree' => array(), 'include' => array(),
-                'number' => '', 'fields' => 'all', 'slug' => '', 'parent' => '',
+                'number' => '', 'fields' => 'all', 'name' => '', 'slug' => '', 'parent' => '',
                 'hierarchical' => true, 'child_of' => 0, 'get' => '', 'name__like' => '', 'description__like' => '',
                 'pad_counts' => false, 'offset' => '', 'search' => '', 'cache_domain' => 'core' );
@@ -1794 +1796 @@
         if ( ! empty( $exclusions ) ) {
                 $where .= $exclusions;
+        }
+
+        if ( ! empty( $args['name'] ) ) {
+                if ( is_array( $args['name'] ) ) {
+                        $name = array_map( 'sanitize_text_field', $args['name'] );
+                        $where .= " AND t.name IN ('" . implode( "', '", $name ) . "')";
+                } else {
+                        $name = sanitize_text_field( $args['name'] );
+                        $where .= $wpdb->prepare( " AND t.name = %s", $name );
+                }
         }