aboutsummaryrefslogtreecommitdiff
path: root/srcs/wordpress/wp-admin/includes/media.php
diff options
context:
space:
mode:
authorCharles <sircharlesaze@gmail.com>2020-01-07 13:06:14 +0100
committerCharles <sircharlesaze@gmail.com>2020-01-07 13:06:14 +0100
commit7086111ad4dd997e12a3220e1ee60c9b9bcf0bb8 (patch)
treef7453d7dd5cbaaab246e23810b02d3edf1e451be /srcs/wordpress/wp-admin/includes/media.php
parentc59bdcf77c50cbe89b4a93782cdd6d9e7532080e (diff)
downloadft_server-7086111ad4dd997e12a3220e1ee60c9b9bcf0bb8.tar.gz
ft_server-7086111ad4dd997e12a3220e1ee60c9b9bcf0bb8.tar.bz2
ft_server-7086111ad4dd997e12a3220e1ee60c9b9bcf0bb8.zip
Added wordpress
Diffstat (limited to 'srcs/wordpress/wp-admin/includes/media.php')
-rw-r--r--srcs/wordpress/wp-admin/includes/media.php3717
1 files changed, 3717 insertions, 0 deletions
diff --git a/srcs/wordpress/wp-admin/includes/media.php b/srcs/wordpress/wp-admin/includes/media.php
new file mode 100644
index 0000000..16b2052
--- /dev/null
+++ b/srcs/wordpress/wp-admin/includes/media.php
@@ -0,0 +1,3717 @@
+<?php
+/**
+ * WordPress Administration Media API.
+ *
+ * @package WordPress
+ * @subpackage Administration
+ */
+
+/**
+ * Defines the default media upload tabs
+ *
+ * @since 2.5.0
+ *
+ * @return array default tabs
+ */
+function media_upload_tabs() {
+ $_default_tabs = array(
+ 'type' => __( 'From Computer' ), // handler action suffix => tab text
+ 'type_url' => __( 'From URL' ),
+ 'gallery' => __( 'Gallery' ),
+ 'library' => __( 'Media Library' ),
+ );
+
+ /**
+ * Filters 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 );
+}
+
+/**
+ * Adds the gallery tab back to the tabs array if post has image attachments
+ *
+ * @since 2.5.0
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
+ *
+ * @param array $tabs
+ * @return array $tabs with gallery if post has image attachment
+ */
+function update_gallery_tab( $tabs ) {
+ global $wpdb;
+
+ if ( ! isset( $_REQUEST['post_id'] ) ) {
+ unset( $tabs['gallery'] );
+ return $tabs;
+ }
+
+ $post_id = intval( $_REQUEST['post_id'] );
+
+ if ( $post_id ) {
+ $attachments = intval( $wpdb->get_var( $wpdb->prepare( "SELECT count(*) FROM $wpdb->posts WHERE post_type = 'attachment' AND post_status != 'trash' AND post_parent = %d", $post_id ) ) );
+ }
+
+ if ( empty( $attachments ) ) {
+ unset( $tabs['gallery'] );
+ return $tabs;
+ }
+
+ /* translators: %s: Number of attachments. */
+ $tabs['gallery'] = sprintf( __( 'Gallery (%s)' ), "<span id='attachments-count'>$attachments</span>" );
+
+ return $tabs;
+}
+
+/**
+ * Outputs the legacy media upload tabs UI.
+ *
+ * @since 2.5.0
+ *
+ * @global string $redir_tab
+ */
+function the_media_upload_tabs() {
+ global $redir_tab;
+ $tabs = media_upload_tabs();
+ $default = 'type';
+
+ if ( ! empty( $tabs ) ) {
+ echo "<ul id='sidemenu'>\n";
+
+ if ( isset( $redir_tab ) && array_key_exists( $redir_tab, $tabs ) ) {
+ $current = $redir_tab;
+ } elseif ( isset( $_GET['tab'] ) && array_key_exists( $_GET['tab'], $tabs ) ) {
+ $current = $_GET['tab'];
+ } 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 ( $current == $callback ) {
+ $class = " class='current'";
+ }
+
+ $href = add_query_arg(
+ array(
+ 'tab' => $callback,
+ 's' => false,
+ 'paged' => false,
+ 'post_mime_type' => false,
+ 'm' => false,
+ )
+ );
+ $link = "<a href='" . esc_url( $href ) . "'$class>$text</a>";
+ echo "\t<li id='" . esc_attr( "tab-$callback" ) . "'>$link</li>\n";
+ }
+
+ echo "</ul>\n";
+ }
+}
+
+/**
+ * Retrieves the image HTML to send to the editor.
+ *
+ * @since 2.5.0
+ *
+ * @param int $id Image attachment id.
+ * @param string $caption Image caption.
+ * @param string $title Image title attribute.
+ * @param string $align Image CSS alignment property.
+ * @param string $url Optional. Image src URL. Default empty.
+ * @param bool|string $rel Optional. Value for rel attribute or whether to add a default value. Default false.
+ * @param string|array $size Optional. Image size. Accepts any valid image size, or an array of width
+ * and height values in pixels (in that order). Default 'medium'.
+ * @param string $alt Optional. Image alt attribute. Default empty.
+ * @return string The HTML output to insert into the editor.
+ */
+function get_image_send_to_editor( $id, $caption, $title, $align, $url = '', $rel = false, $size = 'medium', $alt = '' ) {
+
+ $html = get_image_tag( $id, $alt, '', $align, $size );
+
+ if ( $rel ) {
+ if ( is_string( $rel ) ) {
+ $rel = ' rel="' . esc_attr( $rel ) . '"';
+ } else {
+ $rel = ' rel="attachment wp-att-' . intval( $id ) . '"';
+ }
+ } else {
+ $rel = '';
+ }
+
+ if ( $url ) {
+ $html = '<a href="' . esc_attr( $url ) . '"' . $rel . '>' . $html . '</a>';
+ }
+
+ /**
+ * Filters the image HTML markup to send to the editor when inserting an image.
+ *
+ * @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|array $size Size of image. Image size or array of width and height values
+ * (in that order). Default 'medium'.
+ * @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;
+}
+
+/**
+ * Adds image shortcode with caption to editor
+ *
+ * @since 2.6.0
+ *
+ * @param string $html The image HTML markup to send.
+ * @param integer $id Image attachment ID.
+ * @param string $caption Image caption.
+ * @param string $title Image title attribute (not used).
+ * @param string $align Image CSS alignment property.
+ * @param string $url Image source URL (not used).
+ * @param string $size Image size (`thumbnail`, `medium`, `large`, `full`, or added with `add_image_size()`) (not used).
+ * @param string $alt Image `alt` attribute (not used).
+ * @return string The image HTML markup with caption shortcode.
+ */
+function image_add_caption( $html, $id, $caption, $title, $align, $url, $size, $alt = '' ) {
+
+ /**
+ * Filters the caption text.
+ *
+ * Note: If the caption text is empty, the caption shortcode will not be appended
+ * to the image HTML when inserted into the editor.
+ *
+ * Passing an empty value also prevents the {@see 'image_add_caption_shortcode'}
+ * Filters from being evaluated at the end of image_add_caption().
+ *
+ * @since 4.1.0
+ *
+ * @param string $caption The original caption text.
+ * @param int $id The attachment ID.
+ */
+ $caption = apply_filters( 'image_add_caption_text', $caption, $id );
+
+ /**
+ * Filters 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;
+ }
+
+ $id = ( 0 < (int) $id ) ? 'attachment_' . $id : '';
+
+ if ( ! preg_match( '/width=["\']([0-9]+)/', $html, $matches ) ) {
+ return $html;
+ }
+
+ $width = $matches[1];
+
+ $caption = str_replace( array( "\r\n", "\r" ), "\n", $caption );
+ $caption = preg_replace_callback( '/<[a-zA-Z0-9]+(?: [^<>]+>)*/', '_cleanup_image_add_caption', $caption );
+
+ // Convert any remaining line breaks to <br>.
+ $caption = preg_replace( '/[ \n\t]*\n[ \t]*/', '<br />', $caption );
+
+ $html = preg_replace( '/(class=["\'][^\'"]*)align(none|left|right|center)\s?/', '$1', $html );
+ if ( empty( $align ) ) {
+ $align = 'none';
+ }
+
+ $shcode = '[caption id="' . $id . '" align="align' . $align . '" width="' . $width . '"]' . $html . ' ' . $caption . '[/caption]';
+
+ /**
+ * Filters 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 );
+}
+
+/**
+ * Private preg_replace callback used in image_add_caption()
+ *
+ * @access private
+ * @since 3.4.0
+ */
+function _cleanup_image_add_caption( $matches ) {
+ // Remove any line breaks from inside the tags.
+ return preg_replace( '/[\r\n\t]+/', ' ', $matches[0] );
+}
+
+/**
+ * Adds image html to editor
+ *
+ * @since 2.5.0
+ *
+ * @param string $html
+ */
+function media_send_to_editor( $html ) {
+ ?>
+ <script type="text/javascript">
+ var win = window.dialogArguments || opener || parent || top;
+ win.send_to_editor( <?php echo wp_json_encode( $html ); ?> );
+ </script>
+ <?php
+ exit;
+}
+
+/**
+ * Save a file submitted from a POST request and create an attachment post for it.
+ *
+ * @since 2.5.0
+ *
+ * @param string $file_id Index of the `$_FILES` array that the file was sent. Required.
+ * @param int $post_id The post ID of a post to attach the media item to. Required, but can
+ * be set to 0, creating a media item that has no relationship to a post.
+ * @param array $post_data Overwrite some of the attachment. Optional.
+ * @param array $overrides Override the wp_handle_upload() behavior. Optional.
+ * @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 ) ) {
+ $time = current_time( 'mysql' );
+ $post = get_post( $post_id );
+
+ if ( $post ) {
+ // The post date doesn't usually matter for pages, so don't backdate this upload.
+ if ( 'page' !== $post->post_type && substr( $post->post_date, 0, 4 ) > 0 ) {
+ $time = $post->post_date;
+ }
+ }
+
+ $file = wp_handle_upload( $_FILES[ $file_id ], $overrides, $time );
+
+ if ( isset( $file['error'] ) ) {
+ return new WP_Error( 'upload_error', $file['error'] );
+ }
+
+ $name = $_FILES[ $file_id ]['name'];
+ $ext = pathinfo( $name, PATHINFO_EXTENSION );
+ $name = wp_basename( $name, ".$ext" );
+
+ $url = $file['url'];
+ $type = $file['type'];
+ $file = $file['file'];
+ $title = sanitize_text_field( $name );
+ $content = '';
+ $excerpt = '';
+
+ if ( preg_match( '#^audio#', $type ) ) {
+ $meta = wp_read_audio_metadata( $file );
+
+ if ( ! empty( $meta['title'] ) ) {
+ $title = $meta['title'];
+ }
+
+ if ( ! empty( $title ) ) {
+
+ if ( ! empty( $meta['album'] ) && ! empty( $meta['artist'] ) ) {
+ /* translators: 1: Audio track title, 2: Album title, 3: Artist name. */
+ $content .= sprintf( __( '"%1$s" from %2$s by %3$s.' ), $title, $meta['album'], $meta['artist'] );
+ } elseif ( ! empty( $meta['album'] ) ) {
+ /* translators: 1: Audio track title, 2: Album title. */
+ $content .= sprintf( __( '"%1$s" from %2$s.' ), $title, $meta['album'] );
+ } elseif ( ! empty( $meta['artist'] ) ) {
+ /* translators: 1: Audio track title, 2: Artist name. */
+ $content .= sprintf( __( '"%1$s" by %2$s.' ), $title, $meta['artist'] );
+ } else {
+ /* translators: %s: Audio track title. */
+ $content .= sprintf( __( '"%s".' ), $title );
+ }
+ } elseif ( ! empty( $meta['album'] ) ) {
+
+ if ( ! empty( $meta['artist'] ) ) {
+ /* translators: 1: Audio album title, 2: Artist name. */
+ $content .= sprintf( __( '%1$s by %2$s.' ), $meta['album'], $meta['artist'] );
+ } else {
+ $content .= $meta['album'] . '.';
+ }
+ } elseif ( ! empty( $meta['artist'] ) ) {
+
+ $content .= $meta['artist'] . '.';
+
+ }
+
+ if ( ! empty( $meta['year'] ) ) {
+ /* translators: Audio file track information. %d: Year of audio track release. */
+ $content .= ' ' . sprintf( __( 'Released: %d.' ), $meta['year'] );
+ }
+
+ if ( ! empty( $meta['track_number'] ) ) {
+ $track_number = explode( '/', $meta['track_number'] );
+
+ if ( isset( $track_number[1] ) ) {
+ /* translators: Audio file track information. 1: Audio track number, 2: Total audio tracks. */
+ $content .= ' ' . sprintf( __( 'Track %1$s of %2$s.' ), number_format_i18n( $track_number[0] ), number_format_i18n( $track_number[1] ) );
+ } else {
+ /* translators: Audio file track information. %s: Audio track number. */
+ $content .= ' ' . sprintf( __( 'Track %s.' ), number_format_i18n( $track_number[0] ) );
+ }
+ }
+
+ if ( ! empty( $meta['genre'] ) ) {
+ /* translators: Audio file genre information. %s: Audio genre name. */
+ $content .= ' ' . sprintf( __( 'Genre: %s.' ), $meta['genre'] );
+ }
+
+ // Use image exif/iptc data for title and caption defaults if possible.
+ } elseif ( 0 === strpos( $type, 'image/' ) ) {
+ $image_meta = wp_read_image_metadata( $file );
+
+ if ( $image_meta ) {
+ if ( trim( $image_meta['title'] ) && ! is_numeric( sanitize_title( $image_meta['title'] ) ) ) {
+ $title = $image_meta['title'];
+ }
+
+ if ( trim( $image_meta['caption'] ) ) {
+ $excerpt = $image_meta['caption'];
+ }
+ }
+ }
+
+ // Construct the attachment array
+ $attachment = array_merge(
+ array(
+ 'post_mime_type' => $type,
+ 'guid' => $url,
+ 'post_parent' => $post_id,
+ 'post_title' => $title,
+ 'post_content' => $content,
+ 'post_excerpt' => $excerpt,
+ ),
+ $post_data
+ );
+
+ // This should never be set as it would then overwrite an existing attachment.
+ unset( $attachment['ID'] );
+
+ // Save the data
+ $attachment_id = wp_insert_attachment( $attachment, $file, $post_id, true );
+
+ if ( ! is_wp_error( $attachment_id ) ) {
+ // Set a custom header with the attachment_id.
+ // Used by the browser/client to resume creating image sub-sizes after a PHP fatal error.
+ if ( ! headers_sent() ) {
+ header( 'X-WP-Upload-Attachment-ID: ' . $attachment_id );
+ }
+
+ // The image sub-sizes are created during wp_generate_attachment_metadata().
+ // This is generally slow and may cause timeouts or out of memory errors.
+ wp_update_attachment_metadata( $attachment_id, wp_generate_attachment_metadata( $attachment_id, $file ) );
+ }
+
+ return $attachment_id;
+}
+
+/**
+ * Handles a side-loaded file in the same way as an uploaded file is handled by media_handle_upload().
+ *
+ * @since 2.6.0
+ * @since 5.3.0 The `$post_id` parameter was made optional.
+ *
+ * @param array $file_array Array similar to a `$_FILES` upload array.
+ * @param int $post_id Optional. The post ID the media is associated with.
+ * @param string $desc Optional. Description of the side-loaded file. Default null.
+ * @param array $post_data Optional. Post data to override. Default empty array.
+ * @return int|WP_Error The ID of the attachment or a WP_Error on failure.
+ */
+function media_handle_sideload( $file_array, $post_id = 0, $desc = null, $post_data = array() ) {
+ $overrides = array( 'test_form' => false );
+
+ $time = current_time( 'mysql' );
+ $post = get_post( $post_id );
+
+ if ( $post ) {
+ if ( substr( $post->post_date, 0, 4 ) > 0 ) {
+ $time = $post->post_date;
+ }
+ }
+
+ $file = wp_handle_sideload( $file_array, $overrides, $time );
+
+ if ( isset( $file['error'] ) ) {
+ return new WP_Error( 'upload_error', $file['error'] );
+ }
+
+ $url = $file['url'];
+ $type = $file['type'];
+ $file = $file['file'];
+ $title = preg_replace( '/\.[^.]+$/', '', wp_basename( $file ) );
+ $content = '';
+
+ // Use image exif/iptc data for title and caption defaults if possible.
+ $image_meta = wp_read_image_metadata( $file );
+
+ if ( $image_meta ) {
+ if ( trim( $image_meta['title'] ) && ! is_numeric( sanitize_title( $image_meta['title'] ) ) ) {
+ $title = $image_meta['title'];
+ }
+
+ if ( trim( $image_meta['caption'] ) ) {
+ $content = $image_meta['caption'];
+ }
+ }
+
+ if ( isset( $desc ) ) {
+ $title = $desc;
+ }
+
+ // Construct the attachment array.
+ $attachment = array_merge(
+ array(
+ 'post_mime_type' => $type,
+ 'guid' => $url,
+ 'post_parent' => $post_id,
+ 'post_title' => $title,
+ 'post_content' => $content,
+ ),
+ $post_data
+ );
+
+ // This should never be set as it would then overwrite an existing attachment.
+ unset( $attachment['ID'] );
+
+ // Save the attachment metadata
+ $attachment_id = wp_insert_attachment( $attachment, $file, $post_id, true );
+
+ if ( ! is_wp_error( $attachment_id ) ) {
+ wp_update_attachment_metadata( $attachment_id, wp_generate_attachment_metadata( $attachment_id, $file ) );
+ }
+
+ return $attachment_id;
+}
+
+/**
+ * Outputs the iframe to display the media upload page.
+ *
+ * @since 2.5.0
+ * @since 5.3.0 Formalized the existing and already documented `...$args` parameter
+ * by adding it to the function signature.
+ *
+ * @global int $body_id
+ *
+ * @param callable $content_func Function that outputs the content.
+ * @param mixed ...$args Optional additional parameters to pass to the callback function when it's called.
+ */
+function wp_iframe( $content_func, ...$args ) {
+ _wp_admin_html_begin();
+ ?>
+ <title><?php bloginfo( 'name' ); ?> &rsaquo; <?php _e( 'Uploads' ); ?> &#8212; <?php _e( 'WordPress' ); ?></title>
+ <?php
+
+ wp_enqueue_style( 'colors' );
+ // Check callback name for 'media'
+ if (
+ ( is_array( $content_func ) && ! empty( $content_func[1] ) && 0 === strpos( (string) $content_func[1], 'media' ) ) ||
+ ( ! is_array( $content_func ) && 0 === strpos( $content_func, 'media' ) )
+ ) {
+ wp_enqueue_style( 'deprecated-media' );
+ }
+ wp_enqueue_style( 'ie' );
+
+ ?>
+ <script type="text/javascript">
+ addLoadEvent = function(func){if(typeof jQuery!="undefined")jQuery(document).ready(func);else if(typeof wpOnload!='function'){wpOnload=func;}else{var oldonload=wpOnload;wpOnload=function(){oldonload();func();}}};
+ var ajaxurl = '<?php echo admin_url( 'admin-ajax.php', 'relative' ); ?>', pagenow = 'media-upload-popup', adminpage = 'media-upload-popup',
+ isRtl = <?php echo (int) is_rtl(); ?>;
+ </script>
+ <?php
+ /** 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' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
+
+ /** 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' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
+
+ /** 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' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
+
+ /** 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}" );
+ }
+
+ $body_id_attr = '';
+
+ if ( isset( $GLOBALS['body_id'] ) ) {
+ $body_id_attr = ' id="' . $GLOBALS['body_id'] . '"';
+ }
+
+ ?>
+ </head>
+ <body<?php echo $body_id_attr; ?> class="wp-core-ui no-js">
+ <script type="text/javascript">
+ document.body.className = document.body.className.replace('no-js', 'js');
+ </script>
+ <?php
+
+ call_user_func_array( $content_func, $args );
+
+ /** 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>
+ </html>
+ <?php
+}
+
+/**
+ * Adds the media button to the editor
+ *
+ * @since 2.5.0
+ *
+ * @global int $post_ID
+ *
+ * @staticvar int $instance
+ *
+ * @param string $editor_id
+ */
+function media_buttons( $editor_id = 'content' ) {
+ static $instance = 0;
+ $instance++;
+
+ $post = get_post();
+
+ if ( ! $post && ! empty( $GLOBALS['post_ID'] ) ) {
+ $post = $GLOBALS['post_ID'];
+ }
+
+ wp_enqueue_media( array( 'post' => $post ) );
+
+ $img = '<span class="wp-media-buttons-icon"></span> ';
+
+ $id_attribute = $instance === 1 ? ' id="insert-media-button"' : '';
+
+ printf(
+ '<button type="button"%s class="button insert-media add_media" data-editor="%s">%s</button>',
+ $id_attribute,
+ esc_attr( $editor_id ),
+ $img . __( 'Add Media' )
+ );
+
+ /**
+ * Filters the legacy (pre-3.5.0) media buttons.
+ *
+ * Use {@see 'media_buttons'} action instead.
+ *
+ * @since 2.5.0
+ * @deprecated 3.5.0 Use {@see '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 ( 0 === stripos( trim( $legacy_filter ), '</a>' ) ) {
+ $legacy_filter .= '</a>';
+ }
+ echo $legacy_filter;
+ }
+}
+
+/**
+ * @global int $post_ID
+ * @param string $type
+ * @param int $post_id
+ * @param string $tab
+ * @return string
+ */
+function get_upload_iframe_src( $type = null, $post_id = null, $tab = null ) {
+ global $post_ID;
+
+ if ( empty( $post_id ) ) {
+ $post_id = $post_ID;
+ }
+
+ $upload_iframe_src = add_query_arg( 'post_id', (int) $post_id, admin_url( 'media-upload.php' ) );
+
+ if ( $type && 'media' != $type ) {
+ $upload_iframe_src = add_query_arg( 'type', $type, $upload_iframe_src );
+ }
+
+ if ( ! empty( $tab ) ) {
+ $upload_iframe_src = add_query_arg( 'tab', $tab, $upload_iframe_src );
+ }
+
+ /**
+ * Filters 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 );
+}
+
+/**
+ * Handles form submissions for the legacy media uploader.
+ *
+ * @since 2.5.0
+ *
+ * @return mixed void|object WP_Error on failure
+ */
+function media_upload_form_handler() {
+ check_admin_referer( 'media-form' );
+
+ $errors = null;
+
+ if ( isset( $_POST['send'] ) ) {
+ $keys = array_keys( $_POST['send'] );
+ $send_id = (int) reset( $keys );
+ }
+
+ if ( ! empty( $_POST['attachments'] ) ) {
+ foreach ( $_POST['attachments'] as $attachment_id => $attachment ) {
+ $post = get_post( $attachment_id, ARRAY_A );
+ $_post = $post;
+
+ if ( ! current_user_can( 'edit_post', $attachment_id ) ) {
+ continue;
+ }
+
+ if ( isset( $attachment['post_content'] ) ) {
+ $post['post_content'] = $attachment['post_content'];
+ }
+
+ if ( isset( $attachment['post_title'] ) ) {
+ $post['post_title'] = $attachment['post_title'];
+ }
+
+ if ( isset( $attachment['post_excerpt'] ) ) {
+ $post['post_excerpt'] = $attachment['post_excerpt'];
+ }
+
+ if ( isset( $attachment['menu_order'] ) ) {
+ $post['menu_order'] = $attachment['menu_order'];
+ }
+
+ if ( isset( $send_id ) && $attachment_id == $send_id ) {
+ if ( isset( $attachment['post_parent'] ) ) {
+ $post['post_parent'] = $attachment['post_parent'];
+ }
+ }
+
+ /**
+ * Filters the attachment fields to be saved.
+ *
+ * @since 2.5.0
+ *
+ * @see wp_get_attachment_metadata()
+ *
+ * @param array $post An array of post data.
+ * @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'] );
+
+ if ( $image_alt != get_post_meta( $attachment_id, '_wp_attachment_image_alt', true ) ) {
+ $image_alt = wp_strip_all_tags( $image_alt, true );
+
+ // Update_meta expects slashed.
+ update_post_meta( $attachment_id, '_wp_attachment_image_alt', wp_slash( $image_alt ) );
+ }
+ }
+
+ if ( isset( $post['errors'] ) ) {
+ $errors[ $attachment_id ] = $post['errors'];
+ unset( $post['errors'] );
+ }
+
+ if ( $post != $_post ) {
+ wp_update_post( $post );
+ }
+
+ foreach ( get_attachment_taxonomies( $post ) as $t ) {
+ if ( isset( $attachment[ $t ] ) ) {
+ wp_set_object_terms( $attachment_id, array_map( 'trim', preg_split( '/,+/', $attachment[ $t ] ) ), $t, false );
+ }
+ }
+ }
+ }
+
+ if ( isset( $_POST['insert-gallery'] ) || isset( $_POST['update-gallery'] ) ) {
+ ?>
+ <script type="text/javascript">
+ var win = window.dialogArguments || opener || parent || top;
+ win.tb_remove();
+ </script>
+ <?php
+
+ exit;
+ }
+
+ if ( isset( $send_id ) ) {
+ $attachment = wp_unslash( $_POST['attachments'][ $send_id ] );
+ $html = isset( $attachment['post_title'] ) ? $attachment['post_title'] : '';
+
+ if ( ! empty( $attachment['url'] ) ) {
+ $rel = '';
+
+ if ( strpos( $attachment['url'], 'attachment_id' ) || get_attachment_link( $send_id ) == $attachment['url'] ) {
+ $rel = " rel='attachment wp-att-" . esc_attr( $send_id ) . "'";
+ }
+
+ $html = "<a href='{$attachment['url']}'$rel>$html</a>";
+ }
+
+ /**
+ * Filters 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 );
+ }
+
+ return $errors;
+}
+
+/**
+ * Handles the process of uploading media.
+ *
+ * @since 2.5.0
+ *
+ * @return null|string
+ */
+function wp_media_upload_handler() {
+ $errors = array();
+ $id = 0;
+
+ if ( isset( $_POST['html-upload'] ) && ! empty( $_FILES ) ) {
+ check_admin_referer( 'media-form' );
+ // Upload File button was clicked
+ $id = media_handle_upload( 'async-upload', $_REQUEST['post_id'] );
+ unset( $_FILES );
+
+ if ( is_wp_error( $id ) ) {
+ $errors['upload_error'] = $id;
+ $id = false;
+ }
+ }
+
+ if ( ! empty( $_POST['insertonlybutton'] ) ) {
+ $src = $_POST['src'];
+
+ if ( ! empty( $src ) && ! strpos( $src, '://' ) ) {
+ $src = "http://$src";
+ }
+
+ if ( isset( $_POST['media_type'] ) && 'image' != $_POST['media_type'] ) {
+ $title = esc_html( wp_unslash( $_POST['title'] ) );
+ if ( empty( $title ) ) {
+ $title = esc_html( wp_basename( $src ) );
+ }
+
+ if ( $title && $src ) {
+ $html = "<a href='" . esc_url( $src ) . "'>$title</a>";
+ }
+
+ $type = 'file';
+ $ext = preg_replace( '/^.+?\.([^.]+)$/', '$1', $src );
+
+ if ( $ext ) {
+ $ext_type = wp_ext2type( $ext );
+ if ( 'audio' == $ext_type || 'video' == $ext_type ) {
+ $type = $ext_type;
+ }
+ }
+
+ /**
+ * Filters 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 = '';
+ $alt = esc_attr( wp_unslash( $_POST['alt'] ) );
+
+ if ( isset( $_POST['align'] ) ) {
+ $align = esc_attr( wp_unslash( $_POST['align'] ) );
+ $class = " class='align$align'";
+ }
+
+ if ( ! empty( $src ) ) {
+ $html = "<img src='" . esc_url( $src ) . "' alt='$alt'$class />";
+ }
+
+ /**
+ * Filters 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 );
+ }
+
+ return media_send_to_editor( $html );
+ }
+
+ if ( isset( $_POST['save'] ) ) {
+ $errors['upload_notice'] = __( 'Saved.' );
+ wp_enqueue_script( 'admin-gallery' );
+
+ return wp_iframe( 'media_upload_gallery_form', $errors );
+
+ } elseif ( ! empty( $_POST ) ) {
+ $return = media_upload_form_handler();
+
+ if ( is_string( $return ) ) {
+ return $return;
+ }
+
+ if ( is_array( $return ) ) {
+ $errors = $return;
+ }
+ }
+
+ if ( isset( $_GET['tab'] ) && $_GET['tab'] == 'type_url' ) {
+ $type = 'image';
+
+ if ( isset( $_GET['type'] ) && in_array( $_GET['type'], array( 'video', 'audio', 'file' ) ) ) {
+ $type = $_GET['type'];
+ }
+
+ return wp_iframe( 'media_upload_type_url_form', $type, $errors, $id );
+ }
+
+ return wp_iframe( 'media_upload_type_form', 'image', $errors, $id );
+}
+
+/**
+ * Downloads an image from the specified URL and attaches it to a post.
+ *
+ * @since 2.6.0
+ * @since 4.2.0 Introduced the `$return` parameter.
+ * @since 4.8.0 Introduced the 'id' option within the `$return` parameter.
+ * @since 5.3.0 The `$post_id` parameter was made optional.
+ *
+ * @param string $file The URL of the image to download.
+ * @param int $post_id Optional. The post ID the media is to be associated with.
+ * @param string $desc Optional. Description of the image.
+ * @param string $return Optional. Accepts 'html' (image tag html) or 'src' (URL), or 'id' (attachment ID). Default 'html'.
+ * @return string|WP_Error Populated HTML img tag on success, WP_Error object otherwise.
+ */
+function media_sideload_image( $file, $post_id = 0, $desc = null, $return = 'html' ) {
+ if ( ! empty( $file ) ) {
+
+ // Set variables for storage, fix file filename for query strings.
+ preg_match( '/[^\?]+\.(jpe?g|jpe|gif|png)\b/i', $file, $matches );
+
+ if ( ! $matches ) {
+ return new WP_Error( 'image_sideload_failed', __( 'Invalid image URL' ) );
+ }
+
+ $file_array = array();
+ $file_array['name'] = wp_basename( $matches[0] );
+
+ // Download file to temp location.
+ $file_array['tmp_name'] = download_url( $file );
+
+ // If error storing temporarily, return the error.
+ if ( is_wp_error( $file_array['tmp_name'] ) ) {
+ return $file_array['tmp_name'];
+ }
+
+ // Do the validation and storage stuff.
+ $id = media_handle_sideload( $file_array, $post_id, $desc );
+
+ // If error storing permanently, unlink.
+ if ( is_wp_error( $id ) ) {
+ @unlink( $file_array['tmp_name'] );
+ return $id;
+ // If attachment id was requested, return it early.
+ } elseif ( $return === 'id' ) {
+ return $id;
+ }
+
+ $src = wp_get_attachment_url( $id );
+ }
+
+ // Finally, check to make sure the file has been saved, then return the HTML.
+ if ( ! empty( $src ) ) {
+ if ( $return === 'src' ) {
+ return $src;
+ }
+
+ $alt = isset( $desc ) ? esc_attr( $desc ) : '';
+ $html = "<img src='$src' alt='$alt' />";
+
+ return $html;
+ } else {
+ return new WP_Error( 'image_sideload_failed' );
+ }
+}
+
+/**
+ * Retrieves the legacy media uploader form in an iframe.
+ *
+ * @since 2.5.0
+ *
+ * @return string|null
+ */
+function media_upload_gallery() {
+ $errors = array();
+
+ if ( ! empty( $_POST ) ) {
+ $return = media_upload_form_handler();
+
+ if ( is_string( $return ) ) {
+ return $return;
+ }
+
+ if ( is_array( $return ) ) {
+ $errors = $return;
+ }
+ }
+
+ wp_enqueue_script( 'admin-gallery' );
+ return wp_iframe( 'media_upload_gallery_form', $errors );
+}
+
+/**
+ * Retrieves the legacy media library form in an iframe.
+ *
+ * @since 2.5.0
+ *
+ * @return string|null
+ */
+function media_upload_library() {
+ $errors = array();
+
+ if ( ! empty( $_POST ) ) {
+ $return = media_upload_form_handler();
+
+ if ( is_string( $return ) ) {
+ return $return;
+ }
+ if ( is_array( $return ) ) {
+ $errors = $return;
+ }
+ }
+
+ return wp_iframe( 'media_upload_library_form', $errors );
+}
+
+/**
+ * Retrieve HTML for the image alignment radio buttons with the specified one checked.
+ *
+ * @since 2.7.0
+ *
+ * @param WP_Post $post
+ * @param string $checked
+ * @return string
+ */
+function image_align_input_fields( $post, $checked = '' ) {
+
+ if ( empty( $checked ) ) {
+ $checked = get_user_setting( 'align', 'none' );
+ }
+
+ $alignments = array(