'library' => __('Media Library')
);
- return apply_filters('media_upload_tabs', $_default_tabs);
+ /**
+ * Filter the available tabs in the legacy (pre-3.5.0) media popup.
+ *
+ * @since 2.5.0
+ *
+ * @param array $_default_tabs An array of media tabs.
+ */
+ return apply_filters( 'media_upload_tabs', $_default_tabs );
}
/**
if ( !empty($tabs) ) {
echo "<ul id='sidemenu'>\n";
- if ( isset($redir_tab) && array_key_exists($redir_tab, $tabs) )
+ if ( isset($redir_tab) && array_key_exists($redir_tab, $tabs) ) {
$current = $redir_tab;
- elseif ( isset($_GET['tab']) && array_key_exists($_GET['tab'], $tabs) )
+ } elseif ( isset($_GET['tab']) && array_key_exists($_GET['tab'], $tabs) ) {
$current = $_GET['tab'];
- else
- $current = apply_filters('media_upload_default_tab', $default);
+ } else {
+ /** This filter is documented in wp-admin/media-upload.php */
+ $current = apply_filters( 'media_upload_default_tab', $default );
+ }
foreach ( $tabs as $callback => $text ) {
$class = '';
if ( $url )
$html = '<a href="' . esc_attr($url) . "\"$rel>$html</a>";
+ /**
+ * Filter the image HTML markup to send to the editor.
+ *
+ * @since 2.5.0
+ *
+ * @param string $html The image HTML markup to send.
+ * @param int $id The attachment id.
+ * @param string $caption The image caption.
+ * @param string $title The image title.
+ * @param string $align The image alignment.
+ * @param string $url The image source URL.
+ * @param string $size The image size.
+ * @param string $alt The image alternative, or alt, text.
+ */
$html = apply_filters( 'image_send_to_editor', $html, $id, $caption, $title, $align, $url, $size, $alt );
return $html;
*/
function image_add_caption( $html, $id, $caption, $title, $align, $url, $size, $alt = '' ) {
+ /**
+ * Filter whether to disable captions.
+ *
+ * Prevents image captions from being appended to image HTML when inserted into the editor.
+ *
+ * @since 2.6.0
+ *
+ * @param bool $bool Whether to disable appending captions. Returning true to the filter
+ * will disable captions. Default empty string.
+ */
if ( empty($caption) || apply_filters( 'disable_captions', '' ) )
return $html;
$shcode = '[caption id="' . $id . '" align="align' . $align . '" width="' . $width . '"]' . $html . ' ' . $caption . '[/caption]';
+ /**
+ * Filter the image HTML markup including the caption shortcode.
+ *
+ * @since 2.6.0
+ *
+ * @param string $shcode The image HTML markup with caption shortcode.
+ * @param string $html The image HTML markup.
+ */
return apply_filters( 'image_add_caption_shortcode', $shcode, $html );
}
add_filter( 'image_send_to_editor', 'image_add_caption', 20, 8 );
* @param int $post_id The post ID the media is associated with
* @param array $post_data allows you to overwrite some of the attachment
* @param array $overrides allows you to override the {@link wp_handle_upload()} behavior
- * @return int the ID of the attachment
+ * @return int|WP_Error ID of the attachment or a WP_Error object on failure.
*/
function media_handle_upload($file_id, $post_id, $post_data = array(), $overrides = array( 'test_form' => false )) {
//]]>
</script>
<?php
-do_action('admin_enqueue_scripts', 'media-upload-popup');
-do_action('admin_print_styles-media-upload-popup');
-do_action('admin_print_styles');
-do_action('admin_print_scripts-media-upload-popup');
-do_action('admin_print_scripts');
-do_action('admin_head-media-upload-popup');
-do_action('admin_head');
-
-if ( is_string($content_func) )
+ /** This action is documented in wp-admin/admin-header.php */
+ do_action( 'admin_enqueue_scripts', 'media-upload-popup' );
+
+ /**
+ * Fires when admin styles enqueued for the legacy (pre-3.5.0) media upload popup are printed.
+ *
+ * @since 2.9.0
+ */
+ do_action( 'admin_print_styles-media-upload-popup' );
+
+ /** This action is documented in wp-admin/admin-header.php */
+ do_action( 'admin_print_styles' );
+
+ /**
+ * Fires when admin scripts enqueued for the legacy (pre-3.5.0) media upload popup are printed.
+ *
+ * @since 2.9.0
+ */
+ do_action( 'admin_print_scripts-media-upload-popup' );
+
+ /** This action is documented in wp-admin/admin-header.php */
+ do_action( 'admin_print_scripts' );
+
+ /**
+ * Fires when scripts enqueued for the admin header for the legacy (pre-3.5.0)
+ * media upload popup are printed.
+ *
+ * @since 2.9.0
+ */
+ do_action( 'admin_head-media-upload-popup' );
+
+ /** This action is documented in wp-admin/admin-header.php */
+ do_action( 'admin_head' );
+
+if ( is_string( $content_func ) ) {
+ /**
+ * Fires in the admin header for each specific form tab in the legacy
+ * (pre-3.5.0) media upload popup.
+ *
+ * The dynamic portion of the hook, $content_func, refers to the form
+ * callback for the media upload type. Possible values include
+ * 'media_upload_type_form', 'media_upload_type_url_form', and
+ * 'media_upload_library_form'.
+ *
+ * @since 2.5.0
+ */
do_action( "admin_head_{$content_func}" );
+}
?>
</head>
<body<?php if ( isset($GLOBALS['body_id']) ) echo ' id="' . $GLOBALS['body_id'] . '"'; ?> class="wp-core-ui no-js">
$args = array_slice($args, 1);
call_user_func_array($content_func, $args);
- do_action('admin_print_footer_scripts');
+ /** This action is documented in wp-admin/admin-footer.php */
+ do_action( 'admin_print_footer_scripts' );
?>
<script type="text/javascript">if(typeof wpOnload=='function')wpOnload();</script>
</body>
echo '<a href="#" id="insert-media-button" class="button insert-media add_media" data-editor="' . esc_attr( $editor_id ) . '" title="' . esc_attr__( 'Add Media' ) . '">' . $img . __( 'Add Media' ) . '</a>';
- // Don't use this filter. Want to add a button? Use the media_buttons action.
- $legacy_filter = apply_filters('media_buttons_context', ''); // deprecated
+ /**
+ * Filter the legacy (pre-3.5.0) media buttons.
+ *
+ * @since 2.5.0
+ * @deprecated 3.5.0 Use 'media_buttons' action instead.
+ *
+ * @param string $string Media buttons context. Default empty.
+ */
+ $legacy_filter = apply_filters( 'media_buttons_context', '' );
if ( $legacy_filter ) {
// #WP22559. Close <a> if a plugin started by closing <a> to open their own <a> tag.
if ( ! empty( $tab ) )
$upload_iframe_src = add_query_arg('tab', $tab, $upload_iframe_src);
- $upload_iframe_src = apply_filters($type . '_upload_iframe_src', $upload_iframe_src);
+ /**
+ * Filter the upload iframe source URL for a specific media type.
+ *
+ * The dynamic portion of the hook name, $type, refers to the type
+ * of media uploaded.
+ *
+ * @since 3.0.0
+ *
+ * @param string $upload_iframe_src The upload iframe source URL by type.
+ */
+ $upload_iframe_src = apply_filters( $type . '_upload_iframe_src', $upload_iframe_src );
return add_query_arg('TB_iframe', true, $upload_iframe_src);
}
$post['post_parent'] = $attachment['post_parent'];
}
- $post = apply_filters('attachment_fields_to_save', $post, $attachment);
+ /**
+ * Filter the attachment fields to be saved.
+ *
+ * @since 2.5.0
+ *
+ * @see wp_get_attachment_metadata()
+ *
+ * @param WP_Post $post The WP_Post object.
+ * @param array $attachment An array of attachment metadata.
+ */
+ $post = apply_filters( 'attachment_fields_to_save', $post, $attachment );
if ( isset($attachment['image_alt']) ) {
$image_alt = wp_unslash( $attachment['image_alt'] );
$html = "<a href='{$attachment['url']}'$rel>$html</a>";
}
- $html = apply_filters('media_send_to_editor', $html, $send_id, $attachment);
+ /**
+ * Filter the HTML markup for a media item sent to the editor.
+ *
+ * @since 2.5.0
+ *
+ * @see wp_get_attachment_metadata()
+ *
+ * @param string $html HTML markup for a media item sent to the editor.
+ * @param int $send_id The first key from the $_POST['send'] data.
+ * @param array $attachment Array of attachment metadata.
+ */
+ $html = apply_filters( 'media_send_to_editor', $html, $send_id, $attachment );
return media_send_to_editor($html);
}
&& ( 'audio' == $ext_type || 'video' == $ext_type ) )
$type = $ext_type;
+ /**
+ * Filter the URL sent to the editor for a specific media type.
+ *
+ * The dynamic portion of the hook name, $type, refers to the type
+ * of media being sent.
+ *
+ * @since 3.3.0
+ *
+ * @param string $html HTML markup sent to the editor.
+ * @param string $src Media source URL.
+ * @param string $title Media title.
+ */
$html = apply_filters( $type . '_send_to_editor_url', $html, esc_url_raw( $src ), $title );
} else {
$align = '';
if ( !empty($src) )
$html = "<img src='" . esc_url($src) . "' alt='$alt'$class />";
+ /**
+ * Filter the image URL sent to the editor.
+ *
+ * @since 2.8.0
+ *
+ * @param string $html HTML markup sent to the editor for an image.
+ * @param string $src Image source URL.
+ * @param string $alt Image alternate, or alt, text.
+ * @param string $align The image alignment. Default 'alignnone'. Possible values include
+ * 'alignleft', 'aligncenter', 'alignright', 'alignnone'.
+ */
$html = apply_filters( 'image_send_to_editor_url', $html, esc_url_raw( $src ), $alt, $align );
}
foreach ( $alignments as $name => $label ) {
$name = esc_attr($name);
$out[] = "<input type='radio' name='attachments[{$post->ID}][align]' id='image-align-{$name}-{$post->ID}' value='$name'".
- ( $checked == $name ? " checked='checked'" : "" ) .
+ ( $checked == $name ? " checked='checked'" : "" ) .
" /><label for='image-align-{$name}-{$post->ID}' class='align image-align-{$name}-label'>$label</label>";
}
return join("\n", $out);
*/
function image_size_input_fields( $post, $check = '' ) {
- // get a list of the actual pixel dimensions of each possible intermediate version of this image
- $size_names = apply_filters( 'image_size_names_choose', array('thumbnail' => __('Thumbnail'), 'medium' => __('Medium'), 'large' => __('Large'), 'full' => __('Full Size')) );
+ /**
+ * Filter the names and labels of the default image sizes.
+ *
+ * @since 3.3.0
+ *
+ * @param array $size_names Array of image sizes and their names. Default values
+ * include 'Thumbnail', 'Medium', 'Large', 'Full Size'.
+ */
+ $size_names = apply_filters( 'image_size_names_choose', array(
+ 'thumbnail' => __( 'Thumbnail' ),
+ 'medium' => __( 'Medium' ),
+ 'large' => __( 'Large' ),
+ 'full' => __( 'Full Size' )
+ ) );
if ( empty($check) )
$check = get_user_setting('imgsize', 'medium');
unset( $form_fields['image_alt'] );
}
- $form_fields = apply_filters('attachment_fields_to_edit', $form_fields, $post);
+ /**
+ * Filter the attachment fields to edit.
+ *
+ * @since 2.5.0
+ *
+ * @param array $form_fields An array of attachment form fields.
+ * @param WP_Post $post The WP_Post attachment object.
+ */
+ $form_fields = apply_filters( 'attachment_fields_to_edit', $form_fields, $post );
return $form_fields;
}
$default_args = array( 'errors' => null, 'send' => $current_post_id ? post_type_supports( get_post_type( $current_post_id ), 'editor' ) : true, 'delete' => true, 'toggle' => true, 'show_title' => true );
$args = wp_parse_args( $args, $default_args );
+
+ /**
+ * Filter the arguments used to retrieve an image for the edit image form.
+ *
+ * @since 3.1.0
+ *
+ * @see get_media_item
+ *
+ * @param array $args An array of arguments.
+ */
$args = apply_filters( 'get_media_item_args', $args );
extract( $args, EXTR_SKIP );
$meta = wp_get_attachment_metadata( $post->ID );
if ( isset( $meta['width'], $meta['height'] ) )
$media_dims .= "<span id='media-dims-$post->ID'>{$meta['width']} × {$meta['height']}</span> ";
+
+ /**
+ * Filter the media metadata.
+ *
+ * @since 2.5.0
+ *
+ * @param string $media_dims The HTML markup containing the media dimensions.
+ * @param WP_Post $post The WP_Post attachment object.
+ */
$media_dims = apply_filters( 'media_meta', $media_dims, $post );
$image_edit_button = '';
$display_title
<table class='slidetoggle describe $class'>
<thead class='media-item-info' id='media-head-$post->ID'>
- <tr valign='top'>
+ <tr>
<td class='A1B1' id='thumbnail-head-$post->ID'>
<p><a href='$attachment_url' target='_blank'><img class='thumbnail' src='$thumb_url' alt='' /></a></p>
<p>$image_edit_button</p>
$class = $id;
$class .= $field['required'] ? ' form-required' : '';
- $item .= "\t\t<tr class='$class'>\n\t\t\t<th valign='top' scope='row' class='label'><label for='$name'><span class='alignleft'>{$field['label']}</span>$required<br class='clear' /></label></th>\n\t\t\t<td class='field'>";
+ $item .= "\t\t<tr class='$class'>\n\t\t\t<th scope='row' class='label'><label for='$name'><span class='alignleft'>{$field['label']}</span>$required<br class='clear' /></label></th>\n\t\t\t<td class='field'>";
if ( !empty( $field[ $field['input'] ] ) )
$item .= $field[ $field['input'] ];
elseif ( $field['input'] == 'textarea' ) {
$user_can_edit = current_user_can( 'edit_post', $attachment_id );
$args = wp_parse_args( $args, $default_args );
+
+ /** This filter is documented in wp-admin/includes/media.php */
$args = apply_filters( 'get_media_item_args', $args );
$form_fields = array();
// The recursive merge is easily traversed with array casting: foreach( (array) $things as $thing )
$form_fields = array_merge_recursive($form_fields, (array) $args['errors'] );
+ /** This filter is documented in wp-admin/includes/media.php */
$form_fields = apply_filters( 'attachment_fields_to_edit', $form_fields, $post );
unset( $form_fields['image-size'], $form_fields['align'], $form_fields['image_alt'],
$form_fields['post_title'], $form_fields['post_excerpt'], $form_fields['post_content'],
$form_fields['url'], $form_fields['menu_order'], $form_fields['image_url'] );
+ /** This filter is documented in wp-admin/includes/media.php */
$media_meta = apply_filters( 'media_meta', '', $post );
$defaults = array(
'input' => 'text',
- 'required' => false,
- 'value' => '',
- 'extra_rows' => array(),
- 'show_in_edit' => true,
- 'show_in_modal' => true,
+ 'required' => false,
+ 'value' => '',
+ 'extra_rows' => array(),
+ 'show_in_edit' => true,
+ 'show_in_modal' => true,
);
$hidden_fields = array();
$class .= $field['required'] ? ' form-required' : '';
$item .= "\t\t<tr class='$class'>";
- $item .= "\t\t\t<th valign='top' scope='row' class='label'><label for='$id_attr'><span class='alignleft'>{$field['label']}</span>$required<br class='clear' /></label>";
+ $item .= "\t\t\t<th scope='row' class='label'><label for='$id_attr'><span class='alignleft'>{$field['label']}</span>$required<br class='clear' /></label>";
$item .= "</th>\n\t\t\t<td class='field'>";
if ( !empty( $field[ $field['input'] ] ) )
global $type, $tab, $is_IE, $is_opera;
if ( ! _device_can_upload() ) {
- echo '<p>' . sprintf( __('The web browser on your device cannot be used to upload files. You may be able to use the <a href="%s">native app for your device</a> instead.'), 'http://wordpress.org/mobile/' ) . '</p>';
+ echo '<p>' . sprintf( __('The web browser on your device cannot be used to upload files. You may be able to use the <a href="%s">native app for your device</a> instead.'), 'https://wordpress.org/mobile/' ) . '</p>';
return;
}
?></div>
<?php
if ( is_multisite() && !is_upload_space_available() ) {
+ /**
+ * Fires when an upload will exceed the defined upload space quota for a network site.
+ *
+ * @since 3.5.0
+ */
do_action( 'upload_ui_over_quota' );
return;
}
-do_action('pre-upload-ui');
+/**
+ * Fires just before the legacy (pre-3.5.0) upload interface is loaded.
+ *
+ * @since 2.6.0
+ */
+do_action( 'pre-upload-ui' );
$post_params = array(
"post_id" => $post_id,
"short" => "1",
);
-$post_params = apply_filters( 'upload_post_params', $post_params ); // hook change! old name: 'swfupload_post_params'
+/**
+ * Filter the media upload post parameters.
+ *
+ * @since 3.1.0 As 'swfupload_post_params'
+ * @since 3.3.0
+ *
+ * @param array $post_params An array of media upload parameters used by Plupload.
+ */
+$post_params = apply_filters( 'upload_post_params', $post_params );
$plupload_init = array(
- 'runtimes' => 'html5,silverlight,flash,html4',
- 'browse_button' => 'plupload-browse-button',
- 'container' => 'plupload-upload-ui',
- 'drop_element' => 'drag-drop-area',
- 'file_data_name' => 'async-upload',
- 'multiple_queues' => true,
- 'max_file_size' => $max_upload_size . 'b',
- 'url' => $upload_action_url,
- 'flash_swf_url' => includes_url('js/plupload/plupload.flash.swf'),
- 'silverlight_xap_url' => includes_url('js/plupload/plupload.silverlight.xap'),
- 'filters' => array( array('title' => __( 'Allowed Files' ), 'extensions' => '*') ),
- 'multipart' => true,
- 'urlstream_upload' => true,
- 'multipart_params' => $post_params
+ 'runtimes' => 'html5,flash,silverlight,html4',
+ 'browse_button' => 'plupload-browse-button',
+ 'container' => 'plupload-upload-ui',
+ 'drop_element' => 'drag-drop-area',
+ 'file_data_name' => 'async-upload',
+ 'url' => $upload_action_url,
+ 'flash_swf_url' => includes_url( 'js/plupload/plupload.flash.swf' ),
+ 'silverlight_xap_url' => includes_url( 'js/plupload/plupload.silverlight.xap' ),
+ 'filters' => array(
+ 'max_file_size' => $max_upload_size . 'b',
+ ),
+ 'multipart_params' => $post_params,
);
// Multi-file uploading doesn't currently work in iOS Safari,
if ( wp_is_mobile() )
$plupload_init['multi_selection'] = false;
+/**
+ * Filter the default Plupload settings.
+ *
+ * @since 3.3.0
+ *
+ * @param array $plupload_init An array of default settings used by Plupload.
+ */
$plupload_init = apply_filters( 'plupload_init', $plupload_init );
?>
</script>
<div id="plupload-upload-ui" class="hide-if-no-js">
-<?php do_action('pre-plupload-upload-ui'); // hook change, old name: 'pre-flash-upload-ui' ?>
+<?php
+/**
+ * Fires before the upload interface loads.
+ *
+ * @since 2.6.0 As 'pre-flash-upload-ui'
+ * @since 3.3.0
+ */
+do_action( 'pre-plupload-upload-ui' ); ?>
<div id="drag-drop-area">
<div class="drag-drop-inside">
<p class="drag-drop-info"><?php _e('Drop files here'); ?></p>
<p class="drag-drop-buttons"><input id="plupload-browse-button" type="button" value="<?php esc_attr_e('Select Files'); ?>" class="button" /></p>
</div>
</div>
-<?php do_action('post-plupload-upload-ui'); // hook change, old name: 'post-flash-upload-ui' ?>
+<?php
+/**
+ * Fires after the upload interface loads.
+ *
+ * @since 2.6.0 As 'post-flash-upload-ui'
+ * @since 3.3.0
+ */
+do_action( 'post-plupload-upload-ui' ); ?>
</div>
<div id="html-upload-ui" class="hide-if-js">
-<?php do_action('pre-html-upload-ui'); ?>
+ <?php
+ /**
+ * Fires before the upload button in the media upload interface.
+ *
+ * @since 2.6.0
+ */
+ do_action( 'pre-html-upload-ui' );
+ ?>
<p id="async-upload-wrap">
<label class="screen-reader-text" for="async-upload"><?php _e('Upload'); ?></label>
<input type="file" name="async-upload" id="async-upload" />
<a href="#" onclick="try{top.tb_remove();}catch(e){}; return false;"><?php _e('Cancel'); ?></a>
</p>
<div class="clear"></div>
-<?php do_action('post-html-upload-ui'); ?>
+<?php
+/**
+ * Fires after the upload button in the media upload interface.
+ *
+ * @since 2.6.0
+ */
+do_action( 'post-html-upload-ui' );
+?>
</div>
<span class="max-upload-size"><?php printf( __( 'Maximum upload file size: %d%s.' ), esc_html($upload_size_unit), esc_html($sizes[$u]) ); ?></span>
<?php
-if ( ($is_IE || $is_opera) && $max_upload_size > 100 * 1024 * 1024 ) { ?>
- <span class="big-file-warning"><?php _e('Your browser has some limitations uploading large files with the multi-file uploader. Please use the browser uploader for files over 100MB.'); ?></span>
-<?php }
- do_action('post-upload-ui');
+ /**
+ * Fires on the post upload UI screen.
+ *
+ * Legacy (pre-3.5.0) media workflow hook.
+ *
+ * @since 2.6.0
+ */
+ do_action( 'post-upload-ui' );
}
/**
$post_id = isset( $_REQUEST['post_id'] )? intval( $_REQUEST['post_id'] ) : 0;
$form_action_url = admin_url("media-upload.php?type=$type&tab=type&post_id=$post_id");
- $form_action_url = apply_filters('media_upload_form_url', $form_action_url, $type);
+
+ /**
+ * Filter the media upload form action URL.
+ *
+ * @since 2.6.0
+ *
+ * @param string $form_action_url The media upload form action URL.
+ * @param string $type The type of media. Default 'file'.
+ */
+ $form_action_url = apply_filters( 'media_upload_form_url', $form_action_url, $type );
$form_class = 'media-upload-form type-form validate';
if ( get_user_setting('uploader') )
$post_id = isset( $_REQUEST['post_id'] ) ? intval( $_REQUEST['post_id'] ) : 0;
$form_action_url = admin_url("media-upload.php?type=$type&tab=type&post_id=$post_id");
- $form_action_url = apply_filters('media_upload_form_url', $form_action_url, $type);
+ /** This filter is documented in wp-admin/includes/media.php */
+ $form_action_url = apply_filters( 'media_upload_form_url', $form_action_url, $type );
$form_class = 'media-upload-form type-form validate';
if ( get_user_setting('uploader') )
if ( f.alt.value )
alt = f.alt.value.replace(/'/g, ''').replace(/"/g, '"').replace(/</g, '<').replace(/>/g, '>');
-<?php if ( ! apply_filters( 'disable_captions', '' ) ) { ?>
+<?php
+ /** This filter is documented in wp-admin/includes/media.php */
+ if ( ! apply_filters( 'disable_captions', '' ) ) {
+ ?>
if ( f.caption.value ) {
caption = f.caption.value.replace(/\r\n|\r/g, '\n');
caption = caption.replace(/<[a-zA-Z0-9]+( [^<>]+)?>/g, function(a){
<div id="media-items">
<div class="media-item media-blank">
-<?php echo apply_filters( 'type_url_form_media', wp_media_insert_url_form( $type ) ); ?>
+<?php
+/**
+ * Filter the insert media from URL form HTML.
+ *
+ * @since 3.3.0
+ *
+ * @param string $form_html The insert from URL form HTML.
+ */
+echo apply_filters( 'type_url_form_media', wp_media_insert_url_form( $type ) );
+?>
</div>
</div>
</form>
$post_id = intval($_REQUEST['post_id']);
$form_action_url = admin_url("media-upload.php?type=$type&tab=gallery&post_id=$post_id");
- $form_action_url = apply_filters('media_upload_form_url', $form_action_url, $type);
+ /** This filter is documented in wp-admin/includes/media.php */
+ $form_action_url = apply_filters( 'media_upload_form_url', $form_action_url, $type );
$form_class = 'media-upload-form validate';
if ( get_user_setting('uploader') )
<form enctype="multipart/form-data" method="post" action="<?php echo esc_url( $form_action_url ); ?>" class="<?php echo $form_class; ?>" id="gallery-form">
<?php wp_nonce_field('media-form'); ?>
<?php //media_upload_form( $errors ); ?>
-<table class="widefat" cellspacing="0">
+<table class="widefat">
<thead><tr>
<th><?php _e('Media'); ?></th>
<th class="order-head"><?php _e('Order'); ?></th>
$post_id = isset( $_REQUEST['post_id'] ) ? intval( $_REQUEST['post_id'] ) : 0;
$form_action_url = admin_url("media-upload.php?type=$type&tab=library&post_id=$post_id");
- $form_action_url = apply_filters('media_upload_form_url', $form_action_url, $type);
+ /** This filter is documented in wp-admin/includes/media.php */
+ $form_action_url = apply_filters( 'media_upload_form_url', $form_action_url, $type );
$form_class = 'media-upload-form validate';
if ( get_user_setting('uploader') )
$form_class .= ' html-uploader';
- $_GET['paged'] = isset( $_GET['paged'] ) ? intval($_GET['paged']) : 0;
- if ( $_GET['paged'] < 1 )
- $_GET['paged'] = 1;
- $start = ( $_GET['paged'] - 1 ) * 10;
- if ( $start < 1 )
- $start = 0;
- add_filter( 'post_limits', create_function( '$a', "return 'LIMIT $start, 10';" ) );
+ $q = $_GET;
+ $q['posts_per_page'] = 10;
+ $q['paged'] = isset( $q['paged'] ) ? intval( $q['paged'] ) : 0;
+ if ( $q['paged'] < 1 ) {
+ $q['paged'] = 1;
+ }
+ $q['offset'] = ( $q['paged'] - 1 ) * 10;
+ if ( $q['offset'] < 1 ) {
+ $q['offset'] = 0;
+ }
- list($post_mime_types, $avail_post_mime_types) = wp_edit_attachments_query();
+ list($post_mime_types, $avail_post_mime_types) = wp_edit_attachments_query( $q );
?>
$type_links[] = "<li><a href='" . esc_url(add_query_arg(array('post_mime_type'=>$mime_type, 'paged'=>false))) . "'$class>" . sprintf( translate_nooped_plural( $label[2], $num_posts[$mime_type] ), "<span id='$mime_type-counter'>" . number_format_i18n( $num_posts[$mime_type] ) . '</span>') . '</a>';
}
+/**
+ * Filter the media upload mime type list items.
+ *
+ * Returned values should begin with an <li> tag.
+ *
+ * @since 3.1.0
+ *
+ * @param array $type_links An array of list items containing mime type link HTML.
+ */
echo implode(' | </li>', apply_filters( 'media_upload_mime_type_links', $type_links ) ) . '</li>';
unset($type_links);
?>
'prev_text' => __('«'),
'next_text' => __('»'),
'total' => ceil($wp_query->found_posts / 10),
- 'current' => $_GET['paged']
+ 'current' => $q['paged'],
));
if ( $page_links )
if ( $month_count && !( 1 == $month_count && 0 == $arc_result[0]->mmonth ) ) { ?>
<select name='m'>
-<option<?php selected( $selected_month, 0 ); ?> value='0'><?php _e('Show all dates'); ?></option>
+<option<?php selected( $selected_month, 0 ); ?> value='0'><?php _e( 'All dates' ); ?></option>
<?php
foreach ($arc_result as $arc_row) {
if ( $arc_row->yyear == 0 )
* @return string the form html
*/
function wp_media_insert_url_form( $default_view = 'image' ) {
- if ( !apply_filters( 'disable_captions', '' ) ) {
+ /** This filter is documented in wp-admin/includes/media.php */
+ if ( ! apply_filters( 'disable_captions', '' ) ) {
$caption = '
<tr class="image-only">
- <th valign="top" scope="row" class="label">
+ <th scope="row" class="label">
<label for="caption"><span class="alignleft">' . __('Image Caption') . '</span></label>
</th>
<td class="field"><textarea id="caption" name="caption"></textarea></td>
<p class="media-types"><label><input type="radio" name="media_type" value="image" id="image-only"' . checked( 'image-only', $view, false ) . ' /> ' . __( 'Image' ) . '</label> <label><input type="radio" name="media_type" value="generic" id="not-image"' . checked( 'not-image', $view, false ) . ' /> ' . __( 'Audio, Video, or Other File' ) . '</label></p>
<table class="describe ' . $table_class . '"><tbody>
<tr>
- <th valign="top" scope="row" class="label" style="width:130px;">
+ <th scope="row" class="label" style="width:130px;">
<label for="src"><span class="alignleft">' . __('URL') . '</span></label>
<span class="alignright"><abbr id="status_img" title="required" class="required">*</abbr></span>
</th>
</tr>
<tr>
- <th valign="top" scope="row" class="label">
+ <th scope="row" class="label">
<label for="title"><span class="alignleft">' . __('Title') . '</span></label>
<span class="alignright"><abbr title="required" class="required">*</abbr></span>
</th>
<tr class="not-image"><td></td><td><p class="help">' . __('Link text, e.g. “Ransom Demands (PDF)”') . '</p></td></tr>
<tr class="image-only">
- <th valign="top" scope="row" class="label">
+ <th scope="row" class="label">
<label for="alt"><span class="alignleft">' . __('Alternative Text') . '</span></label>
</th>
<td class="field"><input id="alt" name="alt" value="" type="text" aria-required="true" />
</tr>
' . $caption . '
<tr class="align image-only">
- <th valign="top" scope="row" class="label"><p><label for="align">' . __('Alignment') . '</label></p></th>
+ <th scope="row" class="label"><p><label for="align">' . __('Alignment') . '</label></p></th>
<td class="field">
<input name="align" id="align-none" value="none" onclick="addExtImage.align=\'align\'+this.value" type="radio"' . ($default_align == 'none' ? ' checked="checked"' : '').' />
<label for="align-none" class="align image-align-none-label">' . __('None') . '</label>
</tr>
<tr class="image-only">
- <th valign="top" scope="row" class="label">
+ <th scope="row" class="label">
<label for="url"><span class="alignleft">' . __('Link Image To:') . '</span></label>
</th>
<td class="field"><input id="url" name="url" value="" type="text" /><br />
function media_upload_html_bypass() {
?>
<p class="upload-html-bypass hide-if-no-js">
- <?php _e('You are using the browser’s built-in file uploader. The WordPress uploader includes multiple file selection and drag and drop capability. <a href="#">Switch to the multi-file uploader</a>.'); ?>
+ <?php _e('You are using the browser’s built-in file uploader. The WordPress uploader includes multiple file selection and drag and drop capability. <a href="#">Switch to the multi-file uploader</a>.'); ?>
</p>
<?php
}
$nonce = wp_create_nonce( "image_editor-$post->ID" );
$image_edit_button = "<input type='button' id='imgedit-open-btn-$post->ID' onclick='imageEdit.open( $post->ID, \"$nonce\" )' class='button' value='" . esc_attr__( 'Edit Image' ) . "' /> <span class='spinner'></span>";
}
- ?>
+ ?>
<div class="imgedit-response" id="imgedit-response-<?php echo $attachment_id; ?>"></div>
<?php
elseif ( $attachment_id && 0 === strpos( $post->post_mime_type, 'audio/' ) ):
+ wp_maybe_generate_attachment_metadata( $post );
+
echo wp_audio_shortcode( array( 'src' => $att_url ) );
elseif ( $attachment_id && 0 === strpos( $post->post_mime_type, 'video/' ) ):
+ wp_maybe_generate_attachment_metadata( $post );
+
$meta = wp_get_attachment_metadata( $attachment_id );
- $w = ! empty( $meta['width'] ) ? min( $meta['width'], 600 ) : 0;
- $h = 0;
- if ( ! empty( $meta['height'] ) )
- $h = $meta['height'];
- if ( $h && $w < $meta['width'] )
+ $w = ! empty( $meta['width'] ) ? min( $meta['width'], 640 ) : 0;
+ $h = ! empty( $meta['height'] ) ? $meta['height'] : 0;
+ if ( $h && $w < $meta['width'] ) {
$h = round( ( $meta['height'] * $w ) / $meta['width'] );
+ }
$attr = array( 'src' => $att_url );
-
- if ( ! empty( $meta['width' ] ) )
+ if ( ! empty( $w ) && ! empty( $h ) ) {
$attr['width'] = $w;
-
- if ( ! empty( $meta['height'] ) )
$attr['height'] = $h;
+ }
echo wp_video_shortcode( $attr );
<textarea class="widefat" name="excerpt" id="attachment_caption"><?php echo $post->post_excerpt; ?></textarea>
</p>
+
<?php if ( 'image' === substr( $post->post_mime_type, 0, 5 ) ) : ?>
<p>
<label for="attachment_alt"><strong><?php _e( 'Alternative Text' ); ?></strong></label><br />
);
?>
- <label for="content"><strong><?php _e( 'Description' ); ?></strong></label>
+ <label for="content"><strong><?php _e( 'Description' ); ?></strong><?php
+ if ( preg_match( '#^(audio|video)/#', $post->post_mime_type ) ) {
+ echo ': ' . __( 'Displayed on attachment pages.' );
+ } ?></label>
<?php wp_editor( $post->post_content, 'attachment_content', $editor_args ); ?>
</div>
$meta = wp_get_attachment_metadata( $post->ID );
if ( isset( $meta['width'], $meta['height'] ) )
$media_dims .= "<span id='media-dims-$post->ID'>{$meta['width']} × {$meta['height']}</span> ";
+ /** This filter is documented in wp-admin/includes/media.php */
$media_dims = apply_filters( 'media_meta', $media_dims, $post );
$att_url = wp_get_attachment_url( $post->ID );
</div>
<div class="misc-pub-section misc-pub-filetype">
<?php _e( 'File type:' ); ?> <strong><?php
- if ( preg_match( '/^.*?\.(\w+)$/', get_attached_file( $post->ID ), $matches ) )
+ if ( preg_match( '/^.*?\.(\w+)$/', get_attached_file( $post->ID ), $matches ) ) {
echo esc_html( strtoupper( $matches[1] ) );
- else
+ list( $mime_type ) = explode( '/', $post->post_mime_type );
+ if ( $mime_type !== 'image' && ! empty( $meta['mime_type'] ) ) {
+ if ( $meta['mime_type'] !== "$mime_type/" . strtolower( $matches[1] ) ) {
+ echo ' (' . $meta['mime_type'] . ')';
+ }
+ }
+ } else {
echo strtoupper( str_replace( 'image/', '', $post->post_mime_type ) );
+ }
?></strong>
</div>
<?php
endif;
- if ( preg_match( '#^(audio|video)#', $post->post_mime_type ) ):
+ if ( preg_match( '#^(audio|video)/#', $post->post_mime_type ) ) {
/**
- * Audio and video metadata fields to be shown in the publish meta box.
+ * Filter the audio and video metadata fields to be shown in the publish meta box.
*
* The key for each item in the array should correspond to an attachment
* metadata key, and the value should be the desired label.
*
- * @since 3.7.0
- *
- * @param array $fields {
- * An array of the attachment metadata keys and labels.
+ * @since 3.7.0
*
- * @type string 'mime_type' Label to be shown before the field mime_type.
- * @type string 'year' Label to be shown before the field year.
- * @type string 'genre' Label to be shown before the field genre.
- * @type string 'length_formatted' Label to be shown before the field length_formatted.
- * }
+ * @param array $fields An array of the attachment metadata keys and labels.
*/
$fields = apply_filters( 'media_submitbox_misc_sections', array(
- 'mime_type' => __( 'Mime-type:' ),
- 'year' => __( 'Year:' ),
- 'genre' => __( 'Genre:' ),
'length_formatted' => __( 'Length:' ),
+ 'bitrate' => __( 'Bitrate:' ),
) );
- foreach ( $fields as $key => $label ):
- if ( ! empty( $meta[$key] ) ) : ?>
+ foreach ( $fields as $key => $label ) {
+ if ( empty( $meta[ $key ] ) ) {
+ continue;
+ }
+ ?>
<div class="misc-pub-section misc-pub-mime-meta misc-pub-<?php echo sanitize_html_class( $key ); ?>">
- <?php echo $label ?> <strong><?php echo esc_html( $meta[$key] ); ?></strong>
- </div>
- <?php
- endif;
- endforeach;
-
- if ( ! empty( $meta['bitrate'] ) ) : ?>
- <div class="misc-pub-section misc-pub-bitrate">
- <?php _e( 'Bitrate:' ); ?> <strong><?php
- echo round( $meta['bitrate'] / 1000 ), 'kb/s';
-
- if ( ! empty( $meta['bitrate_mode'] ) )
- echo ' ', strtoupper( $meta['bitrate_mode'] );
-
+ <?php echo $label ?> <strong><?php
+ switch ( $key ) {
+ case 'bitrate' :
+ echo round( $meta['bitrate'] / 1000 ) . 'kb/s';
+ if ( ! empty( $meta['bitrate_mode'] ) ) {
+ echo ' ' . strtoupper( esc_html( $meta['bitrate_mode'] ) );
+ }
+ break;
+ default:
+ echo esc_html( $meta[ $key ] );
+ break;
+ }
?></strong>
</div>
<?php
- endif;
+ }
/**
- * Audio attachment metadata fields to be shown in the publish meta box.
+ * Filter the audio attachment metadata fields to be shown in the publish meta box.
*
* The key for each item in the array should correspond to an attachment
* metadata key, and the value should be the desired label.
*
- * @since 3.7.0
- *
- * @param array $fields {
- * An array of the attachment metadata keys and labels.
+ * @since 3.7.0
*
- * @type string 'dataformat' Label to be shown before the field dataformat.
- * @type string 'codec' Label to be shown before the field codec.
- * }
+ * @param array $fields An array of the attachment metadata keys and labels.
*/
$audio_fields = apply_filters( 'audio_submitbox_misc_sections', array(
'dataformat' => __( 'Audio Format:' ),
'codec' => __( 'Audio Codec:' )
) );
- foreach ( $audio_fields as $key => $label ):
- if ( ! empty( $meta['audio'][$key] ) ) : ?>
+ foreach ( $audio_fields as $key => $label ) {
+ if ( empty( $meta['audio'][ $key ] ) ) {
+ continue;
+ }
+ ?>
<div class="misc-pub-section misc-pub-audio misc-pub-<?php echo sanitize_html_class( $key ); ?>">
<?php echo $label; ?> <strong><?php echo esc_html( $meta['audio'][$key] ); ?></strong>
</div>
<?php
- endif;
- endforeach;
+ }
- endif;
+ }
if ( $media_dims ) : ?>
<div class="misc-pub-section misc-pub-dimensions">