Make WordPress Core

12/06/2012 12:41:06 AM (11 years ago)

Restore the Description field to the media UI in 3.5.

We tried in vain -- a noble but ultimately failed effort -- to reduce the number of fields for attachments from four (title, caption, alt, description) to one (caption for images, title otherwise). Alternative text needed to stay for accessibility reasons, of course.

Eventually title returned due to heavy plugin reliance. Description is too used by too many plugins (often times incorrectly -- the caption is more likely the proper field), hence its less-than-triumphant return today.

Version 3.5 has tried to streamline media in a number of ways. Removing fields may have been too much at once, as it forced not only a user interface change, but a paradigm change as well.

Finally, on upload we populate the description field with IPTC/EXIF captions, rather than the caption field. See #22768, this should be fixed. For now, Description stays.

This commit also restores 'Title' attribute editing to the main tab of the Edit Image dialog. The "Title" field no longer populates title attributes for <img> tags by design (for accessibility and other purposes, see #18984). So, here is a more obvious 'workaround' for the tooltip community.

Finally, this:

  • Cleans up the post.php attachment editor, including by showing a prettier form of the mime type.
  • Enables plugins to specifically hide attachment_fields_to_edit from either post.php (where you can create meta boxes) or the modal (which you may not want to clutter), for compatibility reasons.
  • Hides the 'Describe this file...' placeholder when a field is read-only in the modal.

props nacin, helenyhou.
fixes #22759.

1 edited


  • trunk/wp-admin/includes/ajax-actions.php

    r23058 r23083  
    18851885        $post['post_excerpt'] = $changes['caption'];
     1887    if ( isset( $changes['description'] ) )
     1888        $post['post_content'] = $changes['description'];
    18871890    if ( isset( $changes['alt'] ) ) {
    18881891        $alt = get_post_meta( $id, '_wp_attachment_image_alt', true );
    19231926    if ( 'attachment' != $post['post_type'] )
    19241927        wp_send_json_error();
    1926     // Handle the description field automatically, if a plugin adds it back.
    1927     if ( isset( $attachment_data['post_content'] ) )
    1928         $post['post_content'] = $attachment_data['post_content'];
    19301929    $post = apply_filters( 'attachment_fields_to_save', $post, $attachment_data );
Note: See TracChangeset for help on using the changeset viewer.