Changeset 23776

Timestamp:

03/22/2013 08:08:46 AM (12 years ago)

Author:

helen

Message:

Add a generic get_attached_media() function and use it in get_attached_audio|video|images. Add filters for the query args and resulting array. fixes #23843.

File:

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

trunk/wp-includes/media.php

@@ -1775 +1775 @@
 
 /**
- * Retrieve audio attached to the passed post
- *
- * @since 3.6.0
- *
+ * Retrieve media attached to the passed post
+ *
+ * @since 3.6.0
+ *
+ * @param string $type (Mime) type of media desired
  * @param int $post_id  Post ID
- * @return array Found audio attachments
- */
-function get_attached_audio( $post_id = 0 ) {
+ * @return array Found attachments
+ */
+function get_attached_ $post_id = 0 ) {
     $post = empty( $post_id ) ? get_post() : get_post( $post_id );
     if ( empty( $post ) )
         return;
 
-    $children = get_children( array(
+    $ array(
         'post_parent' => $post->ID,
         'post_type' => 'attachment',
-        'post_mime_type' => 'audio',
-        'posts_per_page' => -1
-    ) );
-
-    if ( ! empty( $children ) )
-        return $children;
+        'post_mime_type' => $type,
+        'posts_per_page' => -1,
+        'orderby' => 'menu_order',
+        'order' => 'ASC',
+    );
+
+    $args = apply_filters( 'get_attached_media_args', $args, $type, $post );
+
+    $children = get_children( $args );
+
+    return (array) apply_filters( 'get_attached_media', $children, $type, $post );
+}
+
+/**
+ * Retrieve audio attached to the passed post
+ *
+ * @since 3.6.0
+ *
+ * @param int $post_id  Post ID
+ * @return array Found audio attachments
+ */
+function get_attached_audio( $post_id = 0 ) {
+    return get_attached_media( 'audio', $post_id );
 }
 
@@ -1807 +1825 @@
  */
 function get_attached_video( $post_id = 0 ) {
-    $post = empty( $post_id ) ? get_post() : get_post( $post_id );
-    if ( empty( $post ) )
-        return;
-
-    $children = get_children( array(
-        'post_parent' => $post->ID,
-        'post_type' => 'attachment',
-        'post_mime_type' => 'video',
-        'posts_per_page' => -1
-    ) );
-
-    if ( ! empty( $children ) )
-        return $children;
+    return get_attached_media( 'video', $post_id );
 }
 
@@ -2004 +2010 @@
  */
 function get_attached_images( $post_id = 0 ) {
-    $post = empty( $post_id ) ? get_post() : get_post( $post_id );
-    if ( empty( $post ) )
-        return array();
-
-    $children = get_children( array(
-        'post_parent' => $post->ID,
-        'post_type' => 'attachment',
-        'post_mime_type' => 'image',
-        'posts_per_page' => -1,
-        'orderby' => 'menu_order',
-        'order' => 'ASC'
-    ) );
-
-    if ( ! empty( $children ) )
-        return $children;
-
-    return array();
+    return get_attached_media( 'image', $post_id );
 }