WordPress.org

Make WordPress Core

Ticket #32417: 32417.14.diff

File 32417.14.diff, 25.7 KB (added by gonom9, 16 months ago)

The scale option is removed and all media will be responsive by default.

  • src/wp-includes/class-wp-customize-manager.php

    diff --git a/src/wp-includes/class-wp-customize-manager.php b/src/wp-includes/class-wp-customize-manager.php
    index 229a248..6468b49 100644
    a b final class WP_Customize_Manager { 
    18071807                                'stylesheet' => $this->get_stylesheet(),
    18081808                                'active'     => $this->is_theme_active(),
    18091809                        ),
     1810                        'media' => array(
     1811                                'audioLibrary' => apply_filters( 'wp_audio_shortcode_library', 'mediaelement' ),
     1812                                'videoLibrary' => apply_filters( 'wp_video_shortcode_library', 'mediaelement' ),
     1813                        ),
    18101814                        'url' => array(
    18111815                                'self' => $self_url,
    18121816                                'allowed' => array_map( 'esc_url_raw', $this->get_allowed_urls() ),
  • src/wp-includes/css/wp-media-widget.css

    diff --git a/src/wp-includes/css/wp-media-widget.css b/src/wp-includes/css/wp-media-widget.css
    index e69de29..d36ec25 100644
    a b  
     1.media-widget-preview .button {
     2        text-align: center
     3}
     4
     5.media-widget-preview .wp-caption {
     6        max-width: 100%;
     7        margin: 0;
     8}
     9
     10.media-widget-preview .image {
     11        height: auto;
     12        max-width: 100%;
     13        cursor: pointer;
     14}
     15
     16.media-widget-preview .aligncenter {
     17        display: block;
     18        margin: 0 auto;
     19        text-align: center
     20}
  • src/wp-includes/default-widgets.php

    diff --git a/src/wp-includes/default-widgets.php b/src/wp-includes/default-widgets.php
    index 0cf5fc3..e803135 100644
    a b require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-tag-cloud.php' ); 
    4545
    4646/** WP_Nav_Menu_Widget class */
    4747require_once( ABSPATH . WPINC . '/widgets/class-wp-nav-menu-widget.php' );
     48
     49/** WP_Widget_Media class */
     50require_once( ABSPATH . WPINC . '/widgets/class-wp-widget-media.php' );
  • src/wp-includes/js/customize-selective-refresh.js

    diff --git a/src/wp-includes/js/customize-selective-refresh.js b/src/wp-includes/js/customize-selective-refresh.js
    index d3b81db..bb21079 100644
    a b wp.customize.selectiveRefresh = ( function( $, api ) { 
    398398                 * @returns {boolean} Whether the rendering was successful and the fallback was not invoked.
    399399                 */
    400400                renderContent: function( placement ) {
    401                         var partial = this, content, newContainerElement;
     401                        var partial = this, content, mediaSettings = api.settings.media, newContainerElement;
    402402                        if ( ! placement.container ) {
    403403                                partial.fallback( new Error( 'no_container' ), [ placement ] );
    404404                                return false;
    wp.customize.selectiveRefresh = ( function( $, api ) { 
    452452                                        placement.container.html( content );
    453453                                }
    454454
     455                                // Auto-initialize media elements when they are contained in the placement
     456                                if ( $( 'audio, video', placement.container ).length > 0 ) {
     457                                        if ( wp.mediaelement && wp.mediaelement.initialize && _.contains( [ mediaSettings.audioLibrary, mediaSettings.videoLibrary ], 'mediaelement' ) ) {
     458                                                wp.mediaelement.initialize();
     459                                        }
     460                                }
     461
    455462                                placement.container.removeClass( 'customize-render-content-error' );
    456463                        } catch ( error ) {
    457464                                if ( 'undefined' !== typeof console && console.error ) {
  • src/wp-includes/js/wp-media-widget.js

    diff --git a/src/wp-includes/js/wp-media-widget.js b/src/wp-includes/js/wp-media-widget.js
    index e69de29..ca2bbf8 100644
    a b  
     1/**
     2 * @since 4.8.0
     3 *
     4 * @package WP_Media_Widget
     5 */
     6( function ( $, l10n ) {
     7        var frame = {
     8                defaultProps: {
     9                        id:    '',
     10                        align: '',
     11                        size:  '',
     12                        link:  ''
     13                },
     14
     15                init: function() {
     16                        frame.bindEvent();
     17                        wp.mediaelement.initialize();
     18                },
     19
     20                bindEvent: function( context ) {
     21                        $( '.button.select-media, .image', context || '.media-widget-preview' )
     22                                .off( 'click.mediaWidget' )
     23                                .on( 'click.mediaWidget', frame.openMediaManager );
     24                },
     25
     26                /**
     27                 * Get current selection of media
     28                 *
     29                 * @param {String} widgetId
     30                 * @return {wp.media.models.Selection|null}
     31                 */
     32                getSelection: function( widgetId ) {
     33                        var ids = $( '#widget-' + widgetId + '-id' ).val();
     34
     35                        if ( ! ids ) {
     36                                return null;
     37                        }
     38
     39                        var selection = ids.split(',').reduce( function( list, id ) {
     40                                var attachment = wp.media.attachment( id );
     41                                if ( id && attachment ) {
     42                                        list.push( attachment );
     43                                }
     44                                return list;
     45                        }, [] );
     46
     47                        return new wp.media.model.Selection( selection );
     48                },
     49
     50                openMediaManager: function( event ) {
     51                        var widgetId = $( event.target ).data( 'id' );
     52
     53                        // Create the media frame.
     54                        var widgetFrame = wp.media( {
     55                                button: {
     56                                        text: translate( 'addToWidget', 'Add to widget' ) // Text of the submit button.
     57                                },
     58
     59                                states: new wp.media.controller.Library( {
     60                                        library:    wp.media.query( { type: [ 'image', 'audio', 'video' ] } ),
     61                                        title:      translate( 'selectMedia', 'Select Media' ), // Media frame title
     62                                        selection:  frame.getSelection( widgetId ),
     63                                        multiple:   false,
     64                                        priority:   20,
     65                                        display:    true, // attachment display setting
     66                                        filterable: 'all'
     67                                } )
     68                        } );
     69
     70                        // Render the attachment details.
     71                        widgetFrame.on( 'select', function() {
     72                                var props, attachment;
     73
     74                                // Only try to render the attachment details if a selection was made.
     75                                if ( widgetFrame.state().get( 'selection' ).length > 0 ) {
     76                                        props = widgetFrame.content.get( '.attachments-browser' )
     77                                                .sidebar.get( 'display' ).model.toJSON();
     78
     79                                        attachment = widgetFrame.state().get( 'selection' ).first().toJSON();
     80
     81                                        frame.renderFormView( widgetId, props, attachment );
     82                                }
     83                        } );
     84
     85                        widgetFrame.open( widgetId );
     86                },
     87
     88                /**
     89                 * Renders the attachment details from the media modal into the widget.
     90                 *
     91                 * @param {String} widgetId
     92                 * @param {Object} props Attachment Display Settings (align, link, size, etc).
     93                 * @param {Object} attachment Attachment Details (title, description, caption, url, sizes, etc).
     94                 */
     95                renderFormView: function( widgetId, props, attachment ) {
     96                        // Start with container elements for the widgets page, customizer controls, and customizer preview.
     97                        var extras, formView = $( '.' + widgetId + ', #customize-control-widget_' + widgetId + ', #' + widgetId );
     98
     99                        // Bail if there is no target form
     100                        if ( ! formView.length ) {
     101                                return;
     102                        }
     103
     104                        _.extend( attachment, _.pick( props, 'link', 'size' ) );
     105
     106                        // Show/hide the widget description
     107                        formView.find( '.attachment-description' )
     108                                .toggleClass( 'hidden', ! attachment.description )
     109                                .html( attachment.description );
     110
     111                        // Display a preview of the image in the widgets page and customizer controls.
     112                        extras = formView.find( '.extras' ).removeClass( 'hidden' );
     113
     114                        // Set the preview content
     115                        formView.find( '.media-widget-admin-preview' )
     116                                .html( frame.renderMediaElement( widgetId, props, attachment ) )
     117                                // Apply responsive styles to the media
     118                                .find( '.wp-video, .wp-caption' ).css( 'width', '100%' ).end()
     119                                .find( 'img.image' ).css( { width: '100%', height: 'auto' } );
     120
     121                        if ( _.contains( [ 'audio', 'video' ], attachment.type ) ) {
     122                                wp.mediaelement.initialize();
     123                        }
     124
     125                        frame.bindEvent( formView );
     126
     127                        // Populate form fields with selection data from the media frame.
     128                        _.each( _.keys( frame.defaultProps ), function ( key ) {
     129                                formView.find( '#widget-' + widgetId + '-' + key ).val( attachment[ key ] || props[ key ] ).trigger( 'change' );
     130                        } );
     131
     132                        // Trigger a sync to update the widget in the customizer preview.
     133                        formView.find( '#widget-' + widgetId + '-url' ).trigger( 'change' );
     134
     135                        // Change button text
     136                        formView.find( frame.buttonId ).text( translate( 'changeMedia', 'Change Media' ) );
     137                },
     138
     139                /**
     140                 * Renders the media attachment in HTML.
     141                 *
     142                 * @param {String} widgetId
     143                 * @param {Object} props Attachment Display Settings (align, link, size, etc).
     144                 * @param {Object} attachment Attachment Details (title, description, caption, url, sizes, etc).
     145                 *
     146                 * @return {String}
     147                 */
     148                renderMediaElement: function( widgetId, props, attachment ) {
     149                        var type = attachment.type || '';
     150                        var renderer = 'render' + type.charAt(0).toUpperCase() + type.slice(1);
     151
     152                        if ( 'function' === typeof frame[renderer] ) {
     153                                return frame[renderer]( widgetId, props, attachment );
     154                        }
     155
     156                        // In case no renderer found
     157                        return '';
     158                },
     159
     160                /**
     161                 * Renders the image attachment
     162                 *
     163                 * @param {String} widgetId
     164                 * @param {Object} props Attachment Display Settings (align, link, size, etc).
     165                 * @param {Object} attachment Attachment Details (title, description, caption, url, sizes, etc).
     166                 *
     167                 * @return {String}
     168                 */
     169                renderImage: function( widgetId, props, attachment ) {
     170                        var image = $( '<img />' )
     171                                .addClass( 'image wp-image' + attachment.id )
     172                                .attr( {
     173                                        'data-id': widgetId,
     174                                        src:       attachment.sizes[ props.size ].url,
     175                                        title:     attachment.title,
     176                                        alt:       attachment.alt,
     177                                        width:     attachment.sizes[ props.size ].width,
     178                                        height:    attachment.sizes[ props.size ].height
     179                                } );
     180
     181                        if ( attachment.caption ) {
     182                                image = $( '<figure />' )
     183                                        .width( attachment.sizes[ props.size ].width )
     184                                        .addClass( 'wp-caption' )
     185                                        .attr( 'id', widgetId + '-caption' )
     186                                        .append( image );
     187
     188                                $( '<figcaption class="wp-caption-text" />' ).text( attachment.caption ).appendTo( image );
     189                        }
     190
     191                        return image.wrap( '<div />' ).parent().html();
     192                },
     193
     194                /**
     195                 * Renders the audio attachment
     196                 *
     197                 * @param {String} widgetId
     198                 * @param {Object} props Attachment Display Settings (align, link, size, etc).
     199                 * @param {Object} attachment Attachment Details (title, description, caption, url, sizes, etc).
     200                 *
     201                 * @return {String}
     202                 */
     203                renderAudio: function( widgetId, props, attachment ) {
     204                        if ( 'embed' === props.link ) {
     205                                return wp.media.template( 'wp-media-widget-audio' )( {
     206                                        model: {
     207                                                src:    attachment.url
     208                                        }
     209                                } );
     210                        }
     211
     212                        return wp.html.string( {
     213                                tag: 'a',
     214                                content: attachment.title,
     215                                attrs: {
     216                                        href: '#'
     217                                }
     218                        } );
     219                },
     220
     221                /**
     222                 * Renders the video attachment
     223                 *
     224                 * @param {String} widgetId
     225                 * @param {Object} props Attachment Display Settings (align, link, size, etc).
     226                 * @param {Object} attachment Attachment Details (title, description, caption, url, sizes, etc).
     227                 *
     228                 * @return {String}
     229                 */
     230                renderVideo: function( widgetId, props, attachment ) {
     231                        if ( 'embed' === props.link ) {
     232                                return wp.media.template( 'wp-media-widget-video' )( {
     233                                        model: {
     234                                                src:    attachment.url,
     235                                                width:  attachment.width,
     236                                                height: attachment.height
     237                                        }
     238                                } );
     239                        }
     240
     241                        return wp.html.string( {
     242                                tag: 'a',
     243                                content: attachment.title,
     244                                attrs: {
     245                                        href: '#'
     246                                }
     247                        } );
     248                }
     249        };
     250
     251        function translate( key, defaultText ) {
     252                return l10n[ key ] || defaultText;
     253        }
     254
     255        $( document )
     256                .ready( frame.init )
     257                .on( 'widget-added widget-updated', frame.init );
     258
     259        window.wp = window.wp || {};
     260        window.wp.MediaWidget = frame;
     261} )( jQuery, window._mediaWidgetL10n || {} );
  • src/wp-includes/script-loader.php

    diff --git a/src/wp-includes/script-loader.php b/src/wp-includes/script-loader.php
    index b2e24d6..3609373 100644
    a b function wp_default_scripts( &$scripts ) { 
    761761                $scripts->add( 'media-gallery', "/wp-admin/js/media-gallery$suffix.js", array('jquery'), false, 1 );
    762762
    763763                $scripts->add( 'svg-painter', '/wp-admin/js/svg-painter.js', array( 'jquery' ), false, 1 );
     764
     765                // Media Widget
     766                $scripts->add( 'wp-media-widget', '/wp-includes/js/wp-media-widget.js', array( 'jquery', 'media-models', 'media-views' ), false, 1 );
     767                did_action( 'init' ) && $scripts->localize( 'wp-media-widget', '_mediaWidgetL10n', array(
     768                        'selectMedia' => __( 'Select Media' ),
     769                        'changeMedia' => __( 'Change Media' ),
     770                        'addToWidget' => __( 'Add to widget' )
     771                ) );
    764772        }
    765773}
    766774
    function wp_default_styles( &$styles ) { 
    865873        $styles->add( 'media-views',          "/wp-includes/css/media-views$suffix.css", array( 'buttons', 'dashicons', 'wp-mediaelement' ) );
    866874        $styles->add( 'wp-pointer',           "/wp-includes/css/wp-pointer$suffix.css", array( 'dashicons' ) );
    867875        $styles->add( 'customize-preview',    "/wp-includes/css/customize-preview$suffix.css", array( 'dashicons' ) );
     876        $styles->add( 'wp-media-widget',      "/wp-includes/css/wp-media-widget.css", array( 'media-views' ) );
    868877        $styles->add( 'wp-embed-template-ie', "/wp-includes/css/wp-embed-template-ie$suffix.css" );
    869878        $styles->add_data( 'wp-embed-template-ie', 'conditional', 'lte IE 8' );
    870879
  • src/wp-includes/widgets.php

    diff --git a/src/wp-includes/widgets.php b/src/wp-includes/widgets.php
    index 1abadfb..f046f2d 100644
    a b function wp_widgets_init() { 
    14661466
    14671467        register_widget('WP_Nav_Menu_Widget');
    14681468
     1469        register_widget('WP_Media_Widget');
     1470
    14691471        /**
    14701472         * Fires after all default WordPress widgets have been registered.
    14711473         *
  • src/wp-includes/widgets/class-wp-widget-media.php

    diff --git a/src/wp-includes/widgets/class-wp-widget-media.php b/src/wp-includes/widgets/class-wp-widget-media.php
    index e69de29..51ff5a7 100644
    a b  
     1<?php
     2/**
     3 * Widget API: WP_Media_Widget class
     4 *
     5 * @package WordPress
     6 * @subpackage Widgets
     7 * @since 4.8.0
     8 */
     9
     10/**
     11 * Core class that implements a media widget.
     12 *
     13 * @since 4.8.0
     14 *
     15 * @see WP_Widget
     16 */
     17class WP_Media_Widget extends WP_Widget {
     18        private $default_instance = array(
     19                'id'          => '',
     20                'title'       => '',
     21                'description' => '',
     22                'link'        => '',
     23                'align'       => 'none',
     24        );
     25
     26        /**
     27         * Constructor.
     28         *
     29         * @since 4.8.0
     30         * @access public
     31         *
     32         * @param string $id_base         Optional Base ID for the widget, lowercase and unique. If left empty,
     33         *                                a portion of the widget's class name will be used Has to be unique.
     34         * @param string $name            Optional. Name for the widget displayed on the configuration page.
     35         *                                Default empty.
     36         * @param array  $widget_options  Optional. Widget options. See wp_register_sidebar_widget() for
     37         *                                information on accepted arguments. Default empty array.
     38         * @param array  $control_options Optional. Widget control options. See wp_register_widget_control()
     39         *                                for information on accepted arguments. Default empty array.
     40         */
     41        public function __construct( $id_base = '', $name = '', $widget_options = array(), $control_options = array() ) {
     42                $widget_opts = wp_parse_args( $widget_options, array(
     43                        'classname' => 'widget_media',
     44                        'description' => __( 'Display media such as images, video, or audio in your sidebar.' ),
     45                        'customize_selective_refresh' => true,
     46                ) );
     47
     48                $control_opts = wp_parse_args( $control_options, array() );
     49
     50                parent::__construct(
     51                        $id_base ? $id_base : 'wp-media-widget',
     52                        $name ? $name : __( 'Media' ),
     53                        $widget_opts,
     54                        $control_opts
     55                );
     56
     57                if ( is_customize_preview() ) {
     58                        $this->enqueue_mediaelement_script();
     59                }
     60
     61                add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_admin_styles' ) );
     62                add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_admin_scripts' ) );
     63        }
     64
     65        /**
     66         * Displays the widget on the front-end.
     67         *
     68         * @since 4.8.0
     69         * @access public
     70         *
     71         * @see WP_Widget::widget()
     72         *
     73         * @param array $args     Display arguments including before_title, after_title, before_widget, and after_widget.
     74         * @param array $instance Saved setting from the database.
     75         */
     76        public function widget( $args, $instance ) {
     77                $output = $args['before_widget'];
     78
     79                $instance = array_merge( $this->default_instance, $instance );
     80
     81                if ( $instance['title'] ) {
     82                        $title = apply_filters( 'widget_title', $instance['title'], $instance, $this->id_base );
     83                        $output .= $args['before_title'] . $title . $args['after_title'];
     84                }
     85                if ( $instance['description'] ) {
     86                        $output .= '<p class="attachment-description align' . $instance['align'] . '">' . $instance['description'] . '</p>';
     87                }
     88
     89                // Render the media.
     90                $attachment = $instance['id'] ? get_post( $instance['id'] ) : null;
     91                if ( $attachment ) {
     92                        $output .= $this->render_media( $attachment, $args['widget_id'], $instance );
     93                        $output .= $this->get_responsive_style( $attachment, $args['widget_id'], $instance );
     94                }
     95
     96                $output .= $args['after_widget'];
     97
     98                echo $output;
     99        }
     100
     101        /**
     102         * Sanitizes the widget form values as they are saved.
     103         *
     104         * @since 4.8.0
     105         * @access public
     106         *
     107         * @see WP_Widget::update()
     108         *
     109         * @param array $new_instance Values just sent to be saved.
     110         * @param array $old_instance Previously saved values from database.
     111         * @return array Updated safe values to be saved.
     112         */
     113        public function update( $new_instance, $old_instance ) {
     114                $instance = $old_instance;
     115
     116                // ID, title
     117                $instance['id']    = (int) $new_instance['id'];
     118                $instance['title'] = sanitize_text_field( $new_instance['title'] );
     119
     120                // Everything else.
     121                $instance['align'] = sanitize_text_field( $new_instance['align'] );
     122                $instance['size']  = sanitize_text_field( $new_instance['size'] );
     123                $instance['link']  = sanitize_text_field( $new_instance['link'] );
     124
     125                return $instance;
     126        }
     127
     128        /**
     129         * Get type of a media attachment
     130         *
     131         * @since 4.8.0
     132         * @access private
     133         *
     134         * @param WP_Post $attachment Attachment object.
     135         *
     136         * @return String type string such as image, audio and video. Returns empty string for unknown type
     137         */
     138        private function get_typeof_media( $attachment ) {
     139                if ( wp_attachment_is_image( $attachment ) ) {
     140                        return 'image';
     141                }
     142
     143                if ( wp_attachment_is( 'audio', $attachment ) ) {
     144                        return 'audio';
     145                }
     146
     147                if ( wp_attachment_is( 'video', $attachment ) ) {
     148                        return 'video';
     149                }
     150
     151                // unknown media type
     152                return '';
     153        }
     154
     155        /**
     156         * Renders a single media attachment
     157         *
     158         * @since 4.8.0
     159         * @access public
     160         *
     161         * @param WP_Post $attachment Attachment object.
     162         * @param string  $widget_id  Widget ID.
     163         * @param array   $instance   Current widget instance arguments.
     164         * @return string
     165         */
     166        public function render_media( $attachment, $widget_id, $instance ) {
     167                $output = '';
     168                $renderer = 'render_' . $this->get_typeof_media( $attachment );
     169
     170                if ( method_exists( $this, $renderer ) ) {
     171                        $output .= call_user_func( array( $this, $renderer ), $attachment, $widget_id, $instance );
     172                }
     173
     174                return $output;
     175        }
     176
     177        /**
     178         * Renders an image attachment preview.
     179         *
     180         * @since 4.8.0
     181         * @access private
     182         *
     183         * @param WP_Post $attachment Attachment object.
     184         * @param string  $widget_id  Widget ID.
     185         * @param array   $instance   Current widget instance arguments.
     186         * @return string
     187         */
     188        private function render_image( $attachment, $widget_id, $instance ) {
     189                $has_caption   = ( ! empty( $attachment->post_excerpt ) );
     190
     191                $img_attrs = array(
     192                        'data-id' => $widget_id,
     193                        'title'   => $attachment->post_title,
     194                        'class'   => 'image wp-image-' . $attachment->ID,
     195                        'style'   => 'width: 100%; height: auto;',
     196                );
     197
     198                if ( ! $has_caption ) {
     199                        $img_attrs['class'] .= ' align' . $instance['align'];
     200                }
     201
     202                $image = wp_get_attachment_image( $attachment->ID, $instance['size'], false, $img_attrs );
     203
     204                if ( ! $has_caption ) {
     205                        return $image;
     206                }
     207
     208                $fig_attrs = array(
     209                        'id'      => $widget_id . '-caption',
     210                        'width'   => get_option( $instance['size'] . '_size_w'),
     211                        'align'   => $instance['align'],
     212                        'caption' => $attachment->post_excerpt
     213                );
     214
     215                $figure = img_caption_shortcode( $fig_attrs, $image );
     216
     217                return $figure;
     218        }
     219
     220        /**
     221         * Renders an audio attachment preview.
     222         *
     223         * @since 4.8.0
     224         * @access private
     225         *
     226         * @param WP_Post $attachment Attachment object.
     227         * @param string  $widget_id  Widget ID.
     228         * @param array   $instance   Current widget instance arguments.
     229         * @return string
     230         */
     231        private function render_audio( $attachment, $widget_id, $instance ) {
     232                if ( in_array( $instance['link'], array( 'file', 'post' ) ) ) {
     233                        return $this->create_link_for( $attachment, $instance['link'] );
     234                }
     235
     236                return wp_audio_shortcode( array(
     237                        'src' => wp_get_attachment_url( $attachment->ID )
     238                ) );
     239        }
     240
     241        /**
     242         * Renders a video attachment preview.
     243         *
     244         * @since 4.8.0
     245         * @access private
     246         *
     247         * @param WP_Post $attachment Attachment object.
     248         * @param string  $widget_id  Widget ID.
     249         * @param array   $instance   Current widget instance arguments.
     250         * @return string
     251         */
     252        private function render_video( $attachment, $widget_id, $instance ) {
     253                if ( in_array( $instance['link'], array( 'file', 'post' ) ) ) {
     254                        return $this->create_link_for( $attachment, $instance['link'] );
     255                }
     256
     257                return wp_video_shortcode( array(
     258                        'src' => wp_get_attachment_url( $attachment->ID )
     259                ) );
     260        }
     261
     262        /**
     263         * Get styles for responsifying the widget
     264         *
     265         * @since 4.8.0
     266         * @access private
     267         *
     268         * @param WP_Post $attachment Attachment object.
     269         * @param string  $widget_id  Widget ID.
     270         * @param array   $instance   Current widget instance arguments.
     271         * @return string styles for responsive media
     272         */
     273        private function get_responsive_style( $attachment, $widget_id, $instance ) {
     274                if ( wp_attachment_is( 'audio', $attachment ) ) {
     275                        return;
     276                }
     277
     278                $output = '<style type="text/css">';
     279
     280                if ( wp_attachment_is_image( $attachment ) ) {
     281                        $output .= "#{$widget_id}-caption{ width: 100% !important; }";
     282                }
     283
     284                if ( wp_attachment_is( 'video', $attachment ) ) {
     285                        $output .= "#{$widget_id} .wp-video{ width: 100% !important; }";
     286                }
     287
     288                $output .= '</style>';
     289
     290                return $output;
     291        }
     292
     293
     294        /**
     295         * Creates and returns a link for an attachment
     296         *
     297         * @param WP_Post $attachment Attachment object.
     298         * @param string  $type       link type.
     299         * @return string
     300         */
     301        private function create_link_for( $attachment, $type = '' ) {
     302                $url = '#';
     303                if ( 'file' === $type ) {
     304                        $url = wp_get_attachment_url( $attachment->ID );
     305                } elseif ( 'post' === $type ) {
     306                        $url = get_attachment_link( $attachment->ID );
     307                }
     308
     309                return '<a href="' . $url  . '">' . $attachment->post_title . '</a>';
     310        }
     311
     312        /**
     313         * Outputs the settings update form.
     314         *
     315         * @since 4.8.0
     316         * @access public
     317         *
     318         * @param array $saved_instance Current settings.
     319         * @return string Default return is 'noform'.
     320         */
     321        public function form( $saved_instance ) {
     322                $defaults = array(
     323                        'title'  => '',
     324                        // Attachment props.
     325                        'id'     => '',
     326                        'align'  => '',
     327                        'size'   => '',
     328                        'link'   => '',
     329                );
     330
     331                $instance   = wp_parse_args( (array) $saved_instance, $defaults );
     332                $attachment = empty( $instance['id'] ) ? null : get_post( $instance['id'] );
     333                $widget_id  = $this->id;
     334                ?>
     335                <div class="<?php echo esc_attr( $widget_id ); ?> media-widget-preview">
     336                        <p>
     337                                <label for="<?php echo $this->get_field_id( 'title' ); ?>"><?php esc_html_e( 'Title:' ); ?></label>
     338                                <input class="widefat" id="<?php echo $this->get_field_id( 'title' ); ?>" name="<?php echo $this->get_field_name( 'title' ); ?>" type="text" value="<?php echo esc_attr( $instance['title'] ); ?>" />
     339                        </p>
     340
     341                        <p>
     342                                <?php esc_html_e( 'Add an image, video, or audio to your sidebar.' ); ?>
     343                        </p>
     344
     345                        <div class="media-widget-admin-preview" id="<?php echo $widget_id; ?>">
     346                        <?php
     347                                if ( $attachment ) {
     348                                        echo $this->render_media( $attachment, $widget_id, $instance );
     349                                        echo $this->get_responsive_style( $attachment, $widget_id, $instance );
     350                                }
     351                        ?>
     352                        </div>
     353
     354                        <p class="extras"></p>
     355
     356                        <p>
     357                                <button type="button" data-id="<?php echo esc_attr( $widget_id ); ?>" class="button select-media widefat">
     358                                        <?php $attachment ? esc_html_e( 'Change Media' ) : esc_html_e( 'Select Media' ); ?>
     359                                </button>
     360                        </p>
     361
     362                        <?php
     363                        // Use hidden form fields to capture the attachment details from the media manager.
     364                        unset( $instance['title'] );
     365                        ?>
     366
     367                        <?php foreach ( $instance as $name => $value ) : ?>
     368                                <input type="hidden" id="<?php echo esc_attr( $this->get_field_id( $name ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( $name ) ); ?>" value="<?php echo esc_attr( $value ); ?>" />
     369                        <?php endforeach; ?>
     370                </div>
     371                <?php
     372        }
     373
     374        /**
     375         * Registers the stylesheet for handling the widget in the back-end.
     376         *
     377         * @since 4.8.0
     378         * @access public
     379         */
     380        public function enqueue_admin_styles() {
     381                wp_enqueue_style( 'wp-media-widget' );
     382        }
     383
     384        /**
     385         * Registers the scripts for handling the widget in the back-end.
     386         *
     387         * @since 4.8.0
     388         * @access public
     389         */
     390        public function enqueue_admin_scripts() {
     391                global $pagenow;
     392
     393                // Bail if we are not in the widgets or customize screens.
     394                if ( 'widgets.php' !== $pagenow && ! is_customize_preview() ) {
     395                        return;
     396                }
     397
     398                // Load the required media files for the media manager.
     399                wp_enqueue_media();
     400
     401                wp_enqueue_script( 'wp-media-widget' );
     402
     403                add_action( 'admin_print_footer_scripts', array( $this, 'admin_print_footer_scripts' ) );
     404        }
     405
     406        /**
     407         * Prints footer scripts.
     408         *
     409         * @since 4.8.0
     410         * @access public
     411         */
     412        public function admin_print_footer_scripts() {
     413                ?>
     414                <script type="text/html" id="tmpl-wp-media-widget-audio">
     415                <?php wp_underscore_audio_template() ?>
     416                </script>
     417
     418                <script type="text/html" id="tmpl-wp-media-widget-video">
     419                <?php wp_underscore_video_template() ?>
     420                </script>
     421
     422                <?php
     423        }
     424
     425        /**
     426         * Enqueue mediaelement script and style if in need,
     427         * so the first instance of the media widget can properly handle media elements.
     428         *
     429         * @since 4.8.0
     430         * @access private
     431         */
     432        private function enqueue_mediaelement_script() {
     433                $audio_library = apply_filters( 'wp_audio_shortcode_library', 'mediaelement' );
     434                $video_library = apply_filters( 'wp_video_shortcode_library', 'mediaelement' );
     435
     436                if ( ! in_array( 'mediaelement', array( $audio_library, $video_library ) ) ) {
     437                        return;
     438                }
     439
     440                wp_enqueue_style( 'wp-mediaelement' );
     441                wp_enqueue_script( 'wp-mediaelement' );
     442        }
     443}