Ticket #50835: 50835.4.diff

src/wp-includes/media.php

@@ -3767 +3767 @@
  * @since 3.5.0
  *
  * @param int|WP_Post $attachment Attachment ID or object.
- * @return array|void Array of attachment details.
+ *
+ * @return array|void {
+ *     Array of attachment details, or void if the parameter does not correspond to an attachment.
+ *
+ *     @type string $alt                   Alt text of the attachment.
+ *     @type string $author                ID of the attachment author, as a string.
+ *     @type string $authorName            Name of the attachment author.
+ *     @type string $caption               Caption for the attachment.
+ *     @type array  $compat                Containing item and meta.
+ *     @type string $context               Context, whether it's used as the site icon for example.
+ *     @type int    $date                  Uploaded date, timestamp in milliseconds.
+ *     @type string $dateFormatted         Formatted date (eg. June 29, 2018).
+ *     @type string $description           Description of the attachment.
+ *     @type string $editLink              URL to the edit page for the attachment.
+ *     @type string $filename              File name of the attachment.
+ *     @type string $filesizeHumanReadable Filesize of the attachment in human readable format (eg. 1 MB).
+ *     @type int    $filesizeInBytes       Filesize of the attachment in bytes.
+ *     @type int    $height                If the attachment is an image, represents the height of the image in pixels.
+ *     @type string $icon                  Icon URL of the attachment (eg. /wp-includes/images/media/archive.png).
+ *     @type int    $id                    ID of the attachment.
+ *     @type string $link                  URL to the attachment.
+ *     @type int    $menuOrder             Menu order of the attachment post.
+ *     @type array  $meta                  Meta data for the attachment.
+ *     @type string $mime                  Mime type of the attachment (eg. image/jpeg or application/zip).
+ *     @type int    $modified              Last modified, timestamp in milliseconds.
+ *     @type string $name                  Name, same as title of the attachment.
+ *     @type array  $nonces                Nonces for update, delete and edit.
+ *     @type string $orientation           If the attachment is an image, represents the image orientation (landscape or portrait).
+ *     @type array  $sizes                 If the attachment is an image, contains an array of arrays for the images sizes: thumbnail, medium, large, and full.
+ *     @type string $status                Post status of the attachmnet (usually 'inherit').
+ *     @type string $subtype               Mime subtype of the attachment (usually the last part, eg. jpeg or zip).
+ *     @type string $title                 Title of the attachment (usually the slugified file name without the extension).
+ *     @type string $type                  Type of the attachment (usually first part of the mime type, eg. image).
+ *     @type int    $uploadedTo            Parent post to which the attachment was uploaded.
+ *     @type string $uploadedToLink        URL to the edit page of the parent post of the attachment.
+ *     @type string $uploadedToTitle       Post title of the parent of the attachment.
+ *     @type string $url                   Direct URL to the attachment file (from wp-content).
+ *     @type int    $width                 If the attachment is an image, represents the width of the image in pixels.
+ * }
+ *
  */
 function wp_prepare_attachment_for_js( $attachment ) {
         $attachment = get_post( $attachment );
@@ -3999 +4038 @@
          *
          * @since 3.5.0
          *
-         * @param array       $response   Array of prepared attachment data.
+         * @param array       $response   Array of prepared attachment data. @see wp_prepare_attachment_for_js().
          * @param WP_Post     $attachment Attachment object.
          * @param array|false $meta       Array of attachment meta data, or false if there is none.
          */