WordPress.org

Make WordPress Core

Changeset 23729


Ignore:
Timestamp:
03/16/2013 05:25:44 AM (5 years ago)
Author:
markjaquith
Message:

Introduce [audio] and [video] shortcodes, and use MediaElement.js to play them.

props wonderboymusic. see #23282.

Location:
trunk
Files:
15 added
7 edited

Legend:

Unmodified
Added
Removed
  • trunk/wp-admin/includes/ajax-actions.php

    r23699 r23729  
    20202020        $title = ''; // We no longer insert title tags into <img> tags, as they are redundant.
    20212021        $html = get_image_send_to_editor( $id, $caption, $title, $align, $url, (bool) $rel, $size, $alt );
     2022    } elseif ( 'video' === substr( $post->post_mime_type, 0, 5 ) || 'audio' === substr( $post->post_mime_type, 0, 5 )  ) {
     2023        $html = stripslashes_deep( $_POST['html'] );
    20222024    }
    20232025
  • trunk/wp-includes/functions.php

    r23637 r23729  
    40214021</div>' ) );
    40224022}
     4023
     4024/**
     4025 * Return RegEx body to liberally match an opening HTML tag that:
     4026 * 1. Is self-closing or
     4027 * 2. Has no body but has a closing tag of the same name or
     4028 * 3. Contains a body and a closing tag of the same name
     4029 *
     4030 * Note: this RegEx does not balance inner tags and does not attempt to produce valid HTML
     4031 *
     4032 * @since 3.6.0
     4033 *
     4034 * @param string $tag An HTML tag name. Example: 'video'
     4035 * @return string
     4036 */
     4037function get_tag_regex( $tag ) {
     4038    if ( empty( $tag ) )
     4039        return;
     4040
     4041    return sprintf( '(<%1$s[^>]*(?:/?>$|>[\s\S]*?</%1$s>))', tag_escape( $tag ) );
     4042}
  • trunk/wp-includes/js/media-editor.js

    r23298 r23729  
    6767                    captionId: 'attachment_' + attachment.id
    6868                });
    69 
     69            } else if ( 'video' === attachment.type || 'audio' === attachment.type ) {
     70                _.extend( props, _.pick( attachment, 'title', 'type', 'icon', 'mime' ) );
    7071            // Format properties for non-images.
    7172            } else {
     
    9495
    9596            return wp.html.string( options );
     97        },
     98
     99        audio: function( props, attachment ) {
     100            var shortcode, html;
     101
     102            props = wp.media.string.props( props, attachment );
     103
     104            shortcode = {};
     105
     106            if ( props.mime ) {
     107                switch ( props.mime ) {
     108                case 'audio/mpeg':
     109                    if ( props.linkUrl.indexOf( 'mp3' ) )
     110                        shortcode.mp3 = props.linkUrl;
     111                    else if ( props.linkUrl.indexOf( 'm4a' ) )
     112                        shortcode.m4a = props.linkUrl;
     113                    break;
     114                case 'audio/mp3':
     115                    shortcode.mp3 = props.linkUrl;
     116                    break;
     117                case 'audio/m4a':
     118                    shortcode.m4a = props.linkUrl;
     119                    break;
     120                case 'audio/wav':
     121                    shortcode.wav = props.linkUrl;
     122                    break;
     123                case 'audio/ogg':
     124                    shortcode.ogg = props.linkUrl;
     125                    break;
     126                case 'audio/x-ms-wma':
     127                case 'audio/wma':
     128                    shortcode.wma = props.linkUrl;
     129                    break;
     130                }
     131            }
     132
     133            html = wp.shortcode.string({
     134                tag:     'audio',
     135                attrs:   shortcode
     136            });
     137
     138            return html;
     139        },
     140
     141        video: function( props, attachment ) {
     142            var shortcode, html;
     143
     144            props = wp.media.string.props( props, attachment );
     145
     146            shortcode = {};
     147
     148            if ( props.mime ) {
     149                switch ( props.mime ) {
     150                case 'video/mp4':
     151                    shortcode.mp4 = props.linkUrl;
     152                    break;
     153                case 'video/m4v':
     154                    shortcode.m4v = props.linkUrl;
     155                    break;
     156                case 'video/webm':
     157                    shortcode.webm = props.linkUrl;
     158                    break;
     159                case 'video/ogg':
     160                    shortcode.ogv = props.linkUrl;
     161                    break;
     162                case 'video/x-ms-wmv':
     163                case 'video/wmv':
     164                case 'video/asf':
     165                    shortcode.wmv = props.linkUrl;
     166                    break;
     167                case 'video/flv':
     168                case 'video/x-flv':
     169                    shortcode.flv = props.linkUrl;
     170                    break;
     171                }
     172            }
     173
     174            html = wp.shortcode.string({
     175                tag:     'video',
     176                attrs:   shortcode
     177            });
     178
     179            return html;
    96180        },
    97181
     
    576660                            options[ option ] = props[ prop ];
    577661                    });
    578 
     662                } else if ( 'video' === attachment.type ) {
     663                    html = wp.media.string.video( props );
     664                } else if ( 'audio' === attachment.type ) {
     665                    html = wp.media.string.audio( props );
    579666                } else {
    580667                    html = wp.media.string.link( props );
  • trunk/wp-includes/media.php

    r23714 r23729  
    805805    return $output;
    806806}
     807
     808/**
     809 * Provide a No-JS Flash fallback as a last resort for audio / video
     810 *
     811 * @since 3.6.0
     812 *
     813 * @param string $url
     814 * @return string Fallback HTML
     815 */
     816function wp_mediaelement_fallback( $url ) {
     817    return apply_filters( 'wp_mediaelement_fallback', sprintf( '<a href="%1$s">%1$s</a>', esc_url( $url ) ), $url );
     818}
     819
     820/**
     821 * Return a filtered list of WP-supported audio formats
     822 *
     823 * @since 3.6.0
     824 * @return array
     825 */
     826function wp_get_audio_extensions() {
     827    return apply_filters( 'wp_audio_extensions', array( 'mp3', 'ogg', 'wma', 'm4a', 'wav' ) );
     828}
     829
     830/**
     831 * The Audio shortcode.
     832 *
     833 * This implements the functionality of the Audio Shortcode for displaying
     834 * WordPress mp3s in a post.
     835 *
     836 * @since 3.6.0
     837 *
     838 * @param array $attr Attributes of the shortcode.
     839 * @return string HTML content to display audio.
     840 */
     841function wp_audio_shortcode( $attr ) {
     842    $post_id = get_post() ? get_the_ID() : 0;
     843
     844    static $instances = 0;
     845    $instances++;
     846
     847    $audio = null;
     848
     849    $default_types = wp_get_audio_extensions();
     850    $defaults_atts = array( 'src' => '' );
     851    foreach ( $default_types as $type  )
     852        $defaults_atts[$type] = '';
     853
     854    $atts = shortcode_atts( $defaults_atts, $attr );
     855    extract( $atts );
     856
     857    $primary = false;
     858    if ( ! empty( $src ) ) {
     859        $type = wp_check_filetype( $src );
     860        if ( ! in_array( $type['ext'], $default_types ) ) {
     861            printf( '<a class="wp-post-format-link-audio" href="%1$s">%1$s</a>', $src );
     862            return;
     863        }
     864        $primary = true;
     865        array_unshift( $default_types, 'src' );
     866    } else {
     867        foreach ( $default_types as $ext ) {
     868            if ( ! empty( $$ext ) ) {
     869                $type = wp_check_filetype( $$ext );
     870                if ( $type['ext'] === $ext )
     871                    $primary = true;
     872            }
     873        }
     874    }
     875
     876    if ( ! $primary ) {
     877        $audios = get_post_audio( $post_id );
     878        if ( empty( $audios ) )
     879            return;
     880
     881        $audio = reset( $audios );
     882        $src = wp_get_attachment_url( $audio->ID );
     883        if ( empty( $src ) )
     884            return;
     885
     886        array_unshift( $default_types, 'src' );
     887    }
     888
     889    $library = apply_filters( 'wp_audio_shortcode_library', 'mediaelement' );
     890    if ( 'mediaelement' === $library ) {
     891        wp_enqueue_style( 'wp-mediaelement' );
     892        wp_enqueue_script( 'wp-mediaelement' );
     893    }
     894
     895    $atts = array(
     896        sprintf( 'class="%s"', apply_filters( 'wp_audio_shortcode_class', 'wp-audio-shortcode' ) ),
     897        sprintf( 'id="audio-%d-%d"', $post_id, $instances ),
     898    );
     899
     900    $html = sprintf( '<audio %s controls="controls" preload="none">', join( ' ', $atts ) );
     901
     902    $fileurl = '';
     903    $source = '<source type="%s" src="%s" />';
     904    foreach ( $default_types as $fallback ) {
     905        if ( ! empty( $$fallback ) ) {
     906            if ( empty( $fileurl ) )
     907                $fileurl = $$fallback;
     908            $type = wp_check_filetype( $$fallback );
     909            $html .= sprintf( $source, $type['type'], $$fallback );
     910        }
     911    }
     912
     913    if ( 'mediaelement' === $library )
     914        $html .= wp_mediaelement_fallback( $fileurl );
     915    $html .= '</audio>';
     916
     917    return apply_filters( 'wp_audio_shortcode', $html, $atts, $audio, $post_id );
     918}
     919add_shortcode( 'audio', apply_filters( 'wp_audio_shortcode_handler', 'wp_audio_shortcode' ) );
     920
     921/**
     922 * Return a filtered list of WP-supported video formats
     923 *
     924 * @since 3.6.0
     925 * @return array
     926 */
     927function wp_get_video_extensions() {
     928    return apply_filters( 'wp_video_extensions', array( 'mp4', 'm4v', 'webm', 'ogv', 'wmv', 'flv' ) );
     929}
     930
     931/**
     932 * The Video shortcode.
     933 *
     934 * This implements the functionality of the Video Shortcode for displaying
     935 * WordPress mp4s in a post.
     936 *
     937 * @since 3.6.0
     938 *
     939 * @param array $attr Attributes of the shortcode.
     940 * @return string HTML content to display video.
     941 */
     942function wp_video_shortcode( $attr ) {
     943    global $content_width;
     944    $post_id = get_post() ? get_the_ID() : 0;
     945
     946    static $instances = 0;
     947    $instances++;
     948
     949    $video = null;
     950
     951    $default_types = wp_get_video_extensions();
     952    $defaults_atts = array(
     953        'src' => '',
     954        'poster' => '',
     955        'height' => 360,
     956        'width' => empty( $content_width ) ? 640 : $content_width,
     957    );
     958    foreach ( $default_types as $type  )
     959        $defaults_atts[$type] = '';
     960
     961    $atts = shortcode_atts( $defaults_atts, $attr );
     962    extract( $atts );
     963
     964    $primary = false;
     965    if ( ! empty( $src ) ) {
     966        $type = wp_check_filetype( $src );
     967        if ( ! in_array( $type['ext'], $default_types ) ) {
     968            printf( '<a class="wp-post-format-link-video" href="%1$s">%1$s</a>', $src );
     969            return;
     970        }
     971        $primary = true;
     972        array_unshift( $default_types, 'src' );
     973    } else {
     974        foreach ( $default_types as $ext ) {
     975            if ( ! empty( $$ext ) ) {
     976                $type = wp_check_filetype( $$ext );
     977                if ( $type['ext'] === $ext )
     978                    $primary = true;
     979            }
     980        }
     981    }
     982
     983    if ( ! $primary ) {
     984        $videos = get_post_video( $post_id );
     985        if ( empty( $videos ) )
     986            return;
     987
     988        $video = reset( $videos );
     989        $src = wp_get_attachment_url( $video->ID );
     990        if ( empty( $src ) )
     991            return;
     992
     993        array_unshift( $default_types, 'src' );
     994    }
     995
     996    $library = apply_filters( 'wp_video_shortcode_library', 'mediaelement' );
     997    if ( 'mediaelement' === $library ) {
     998        wp_enqueue_style( 'wp-mediaelement' );
     999        wp_enqueue_script( 'wp-mediaelement' );
     1000    }
     1001
     1002    $atts = array(
     1003        sprintf( 'class="%s"', apply_filters( 'wp_video_shortcode_class', 'wp-video-shortcode' ) ),
     1004        sprintf( 'id="video-%d-%d"', $post_id, $instances ),
     1005        sprintf( 'width="%d"', $width ),
     1006        sprintf( 'height="%d"', $height ),
     1007    );
     1008
     1009    if ( ! empty( $poster ) )
     1010        $atts[] = sprintf( 'poster="%s"', esc_url( $poster ) );
     1011
     1012    $html = sprintf( '<video %s controls="controls" preload="none">', join( ' ', $atts ) );
     1013
     1014    $fileurl = '';
     1015    $source = '<source type="%s" src="%s" />';
     1016    foreach ( $default_types as $fallback ) {
     1017        if ( ! empty( $$fallback ) ) {
     1018            if ( empty( $fileurl ) )
     1019                $fileurl = $$fallback;
     1020            $type = wp_check_filetype( $$fallback );
     1021            // m4v sometimes shows up as video/mpeg which collides with mp4
     1022            if ( 'm4v' === $type['ext'] )
     1023                $type['type'] = 'video/m4v';
     1024            $html .= sprintf( $source, $type['type'], $$fallback );
     1025        }
     1026    }
     1027    if ( 'mediaelement' === $library )
     1028        $html .= wp_mediaelement_fallback( $fileurl, $width, $height );
     1029    $html .= '</video>';
     1030
     1031    return apply_filters( 'wp_video_shortcode', $html, $atts, $video, $post_id );
     1032}
     1033add_shortcode( 'video', apply_filters( 'wp_video_shortcode_handler', 'wp_video_shortcode' ) );
    8071034
    8081035/**
     
    15461773    do_action( 'wp_enqueue_media' );
    15471774}
     1775
     1776/**
     1777 * Retrieve audio attached to the passed post
     1778 *
     1779 * @since 3.6.0
     1780 *
     1781 * @param int $post_id  Post ID
     1782 * @return array Found audio attachments
     1783 */
     1784function get_post_audio( $post_id = 0 ) {
     1785    $post = empty( $post_id ) ? get_post() : get_post( $post_id );
     1786    if ( empty( $post ) )
     1787        return;
     1788
     1789    $children = get_children( array(
     1790        'post_parent' => $post->ID,
     1791        'post_type' => 'attachment',
     1792        'post_mime_type' => 'audio',
     1793        'posts_per_page' => -1
     1794    ) );
     1795
     1796    if ( ! empty( $children ) )
     1797        return $children;
     1798}
     1799
     1800/**
     1801 * Retrieve video attached to the passed post
     1802 *
     1803 * @since 3.6.0
     1804 *
     1805 * @param int $post_id  Post ID
     1806 * @return array Found video attachments
     1807 */
     1808function get_post_video( $post_id = 0 ) {
     1809    $post = empty( $post_id ) ? get_post() : get_post( $post_id );
     1810    if ( empty( $post ) )
     1811        return;
     1812
     1813    $children = get_children( array(
     1814        'post_parent' => $post->ID,
     1815        'post_type' => 'attachment',
     1816        'post_mime_type' => 'video',
     1817        'posts_per_page' => -1
     1818    ) );
     1819
     1820    if ( ! empty( $children ) )
     1821        return $children;
     1822}
     1823
     1824/**
     1825 * Audio embed handler callback.
     1826 *
     1827 * @param array $matches The regex matches from the provided regex when calling {@link wp_embed_register_handler()}.
     1828 * @param array $attr Embed attributes.
     1829 * @param string $url The original URL that was matched by the regex.
     1830 * @param array $rawattr The original unmodified attributes.
     1831 * @return string The embed HTML.
     1832 */
     1833function wp_audio_embed( $matches, $attr, $url, $rawattr ) {
     1834    $audio = $url;
     1835    if ( shortcode_exists( 'audio' ) )
     1836        $audio = do_shortcode( '[audio src="' . $url . '" /]' );
     1837    return apply_filters( 'wp_audio_embed', $audio, $attr, $url, $rawattr );
     1838}
     1839wp_embed_register_handler( 'wp_audio_embed', '#https?://.+?\.(' . join( '|', wp_get_audio_extensions() ) . ')#i', apply_filters( 'wp_audio_embed_handler', 'wp_audio_embed' ), 9999 );
     1840
     1841/**
     1842 * Video embed handler callback.
     1843 *
     1844 * @param array $matches The regex matches from the provided regex when calling {@link wp_embed_register_handler()}.
     1845 * @param array $attr Embed attributes.
     1846 * @param string $url The original URL that was matched by the regex.
     1847 * @param array $rawattr The original unmodified attributes.
     1848 * @return string The embed HTML.
     1849 */
     1850function wp_video_embed( $matches, $attr, $url, $rawattr ) {
     1851    $dimensions = '';
     1852    $video = $url;
     1853    if ( shortcode_exists( 'video' ) ) {
     1854        if ( ! empty( $rawattr['width'] ) && ! empty( $rawattr['height'] ) ) {
     1855            $dimensions .= sprintf( 'width="%d" ', (int) $rawattr['width'] );
     1856            $dimensions .= sprintf( 'height="%d" ', (int) $rawattr['height'] );
     1857        }
     1858        $video = do_shortcode( '[video ' . $dimensions . 'src="' . $url . '" /]' );
     1859    }
     1860    return apply_filters( 'wp_video_embed', $video, $attr, $url, $rawattr );
     1861}
     1862wp_embed_register_handler( 'wp_video_embed', '#https?://.+?\.(' . join( '|', wp_get_video_extensions() ) . ')#i', apply_filters( 'wp_video_embed_handler', 'wp_video_embed' ), 9999 );
  • trunk/wp-includes/post-formats.php

    r23655 r23729  
    309309    $format_output = '';
    310310    $meta = get_post_format_meta( $post->ID );
     311    // passed by ref in preg_match()
     312    $matches = array();
    311313
    312314    switch ( $format ) {
     
    366368
    367369        case 'gallery':
    368             preg_match_all( '/' . get_shortcode_regex() . '/s', $content, $matches );
    369             if ( ! empty( $matches ) && isset( $matches[2] ) ) {
    370                 foreach ( (array) $matches[2] as $match ) {
    371                     if ( 'gallery' === $match )
    372                         break 2; // foreach + case
    373                 }
    374             }
    375 
    376             if ( ! empty( $meta['gallery'] ) ) {
     370            if ( ! has_shortcode( $post->post_content, $format ) && ! empty( $meta['gallery'] ) )
    377371                $format_output .= $meta['gallery'];
    378             }
    379372            break;
    380373
    381374        case 'video':
    382375        case 'audio':
    383             $shortcode_regex = '/' . get_shortcode_regex() . '/s';
    384             $matches = preg_match( $shortcode_regex, $content );
    385             if ( ! $matches || $format !== $matches[2] ) {
    386                 if ( ! empty( $meta['media'] ) ) {
    387                     // the metadata is a shortcode or an embed code
    388                     if ( preg_match( $shortcode_regex, $meta['media'] ) || preg_match( '#<[^>]+>#', $meta['media'] ) ) {
    389                         $format_output .= $meta['media'];
    390                     } elseif ( ! stristr( $content, $meta['media'] ) ) {
    391                         // attempt to embed the URL
    392                         $format_output .= sprintf( '[embed]%s[/embed]', $meta['media'] );
    393                     }
     376            if ( ! has_shortcode( $post->post_content, $format ) && ! empty( $meta['media'] ) ) {
     377                // the metadata is a shortcode or an embed code
     378                if ( preg_match( '/' . get_shortcode_regex() . '/s', $meta['media'] ) || preg_match( '#<[^>]+>#', $meta['media'] ) ) {
     379                    $format_output .= $meta['media'];
     380                } elseif ( ! stristr( $content, $meta['media'] ) ) {
     381                    // attempt to embed the URL
     382                    $format_output .= sprintf( '[embed]%s[/embed]', $meta['media'] );
    394383                }
    395384            }
  • trunk/wp-includes/script-loader.php

    r23683 r23729  
    278278    $scripts->add( 'imgareaselect', "/wp-includes/js/imgareaselect/jquery.imgareaselect$suffix.js", array('jquery'), '0.9.8', 1 );
    279279
     280    $scripts->add( 'mediaelement', "/wp-includes/js/mediaelement/mediaelement-and-player$suffix.js", array('jquery'), '2.10.1', 1 );
     281    $scripts->add( 'wp-mediaelement', "/wp-includes/js/mediaelement/wp-mediaelement.js", array('mediaelement'), false, 1 );
     282
    280283    $scripts->add( 'password-strength-meter', "/wp-admin/js/password-strength-meter$suffix.js", array('jquery'), false, 1 );
    281284    did_action( 'init' ) && $scripts->localize( 'password-strength-meter', 'pwsL10n', array(
     
    542545    $styles->add( 'buttons', "/wp-includes/css/buttons$suffix.css" );
    543546
     547    $styles->add( 'mediaelement', "/wp-includes/js/mediaelement/mediaelementplayer$suffix.css" );
     548    $styles->add( 'wp-mediaelement', "/wp-includes/js/mediaelement/wp-mediaelement.css", array( 'mediaelement' ) );
     549
    544550    foreach ( $rtl_styles as $rtl_style ) {
    545551        $styles->add_data( $rtl_style, 'rtl', true );
  • trunk/wp-includes/shortcodes.php

    r23626 r23729  
    126126
    127127    $shortcode_tags = array();
     128}
     129
     130/**
     131 * Whether a registered shortcode exists named $tag
     132 *
     133 * @since 3.6.0
     134 *
     135 * @global array $shortcode_tags
     136 * @param string $tag
     137 * @return boolean
     138 */
     139function shortcode_exists( $tag ) {
     140    global $shortcode_tags;
     141    return array_key_exists( $tag, $shortcode_tags );
     142}
     143
     144/**
     145 * Whether the passed content contains the specified shortcode
     146 *
     147 * @since 3.6.0
     148 *
     149 * @global array $shortcode_tags
     150 * @param string $tag
     151 * @return boolean
     152 */
     153function has_shortcode( $content, $tag ) {
     154    if ( shortcode_exists( $tag ) ) {
     155        $matches = array();
     156        preg_match_all( '/' . get_shortcode_regex() . '/s', $content, $matches, PREG_SET_ORDER );
     157        if ( empty( $matches ) )
     158            return false;
     159
     160        foreach ( $matches as $shortcode ) {
     161            if ( $tag === $shortcode[2] )
     162                return true;
     163        }
     164    }
     165    return false;
    128166}
    129167
Note: See TracChangeset for help on using the changeset viewer.