Changeset 38292 for trunk/src/wp-includes/media.php

Timestamp:

08/20/2016 05:34:13 PM (7 years ago)

Author:

boonebgorges

Message:

Allow attachment taxonomies to be fetched as objects.

By adding the $output parameter to get_attachment_taxonomies(), the
function signature matches that of get_object_taxonomies(). The change
also allows for more consistent behavior when passing output=objects
to get_object_taxonomies() for the 'attachment' object type, since
the $output parameter is now passed through the function stack.

Props codemovement.pk.
See #37368.

File:

• trunk/src/wp-includes/media.php (modified) (2 diffs)

trunk/src/wp-includes/media.php

@@ -2695 +2695 @@
  *
  * @since 2.5.0
+ * @since 4.7.0 Introduced the `$output` parameter.
  *
  * @param int|array|object $attachment Attachment ID, data array, or data object.
+ * @param string           $output     Output type. 'names' to return an array of taxonomy names,
+ *                                     or 'objects' to return an array of taxonomy objects.
+ *                                     Default is 'names'.
  * @return array Empty array on failure. List of taxonomies on success.
  */
-function get_attachment_taxonomies( $attachment ) {
+function get_attachment_taxonomies( $attachment, $output = 'names' ) {
     if ( is_int( $attachment ) ) {
         $attachment = get_post( $attachment );
@@ -2724 +2728 @@
 
     $taxonomies = array();
-    foreach ( $objects as $object )
-        if ( $taxes = get_object_taxonomies($object) )
-            $taxonomies = array_merge($taxonomies, $taxes);
+    foreach ( $objects as $object ) {
+        if ( $taxes = get_object_taxonomies( $object, $output ) ) {
+            $taxonomies = array_merge( $taxonomies, $taxes );
+        }
+    }
 
     return array_unique($taxonomies);