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

Timestamp:

05/23/2015 06:28:22 PM (10 years ago)

Author:

boonebgorges

Message:

Introduced $field argument to get_term_link().

This new argument allows developers to specify which term field should be
matched by the value of the $term parameter (in particular, 'name' and
'term_taxonomy_id' are now supported).

Props sudar, mordauk.
Fixes #14156.

File:

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

trunk/src/wp-includes/taxonomy.php

@@ -4382 +4382 @@
  *
  * @since 2.5.0
+ * @since 4.3.0 Introduced `$field` argument.
  *
  * @param object|int|string $term     The term object, ID, or slug whose link will be retrieved.
  * @param string            $taxonomy Optional. Taxonomy. Default empty.
+ * @param string            $field    Optional. The term field that should be matched by the `$term` argument. Accepts
+ *                                    any `$field` values accepted by `get_term_by()`: 'slug', 'name',
+ *                                    'term_taxonomy_id', or 'id'. Default is 'slug', unless `$term` is an integer, in
+ *                                    which case it's asssumed to be an ID.
  * @return string|WP_Error HTML link to taxonomy term archive on success, WP_Error if term does not exist.
  */
-function get_term_link( $term, $taxonomy = '' ) {
+function get_term_link( $term, $taxonomy = '', $field = null ) {
     global $wp_rewrite;
 
     if ( !is_object($term) ) {
-        if ( is_int($term) ) {
-            $term = get_term($term, $taxonomy);
-        } else {
-            $term = get_term_by('slug', $term, $taxonomy);
-        }
+        if ( is_null( $field ) ) {
+            $field = is_int( $term ) ? 'id' : 'slug';
+        }
+
+        $term = get_term_by( $field, $term, $taxonomy );
     }