.mp4 format and minimize its file size for best results. Your theme recommends dimensions of %s pixels.' ),
+ sprintf( '%s × %s', $width, $height )
+ );
+ } elseif ( $width ) {
+ /* translators: %s: header width in pixels */
+ $control_description = sprintf( __( 'Upload your video in .mp4 format and minimize its file size for best results. Your theme recommends a width of %s pixels.' ),
+ sprintf( '%s', $width )
+ );
+ } else {
+ /* translators: %s: header height in pixels */
+ $control_description = sprintf( __( 'Upload your video in .mp4 format and minimize its file size for best results. Your theme recommends a height of %s pixels.' ),
+ sprintf( '%s', $height )
+ );
+ }
+ } else {
+ $title = __( 'Header Image' );
+ $description = '';
+ $control_description = '';
+ }
+
$this->add_section( 'header_image', array(
- 'title' => __( 'Header Image' ),
+ 'title' => $title,
+ 'description' => $description,
'theme_supports' => 'custom-header',
'priority' => 60,
) );
+ $this->add_setting( 'header_video', array(
+ 'theme_supports' => array( 'custom-header', 'video' ),
+ 'transport' => 'postMessage',
+ 'sanitize_callback' => 'absint',
+ 'validate_callback' => array( $this, '_validate_header_video' ),
+ ) );
+
+ $this->add_setting( 'external_header_video', array(
+ 'theme_supports' => array( 'custom-header', 'video' ),
+ 'transport' => 'postMessage',
+ 'sanitize_callback' => 'esc_url',
+ 'validate_callback' => array( $this, '_validate_external_header_video' ),
+ ) );
+
$this->add_setting( new WP_Customize_Filter_Setting( $this, 'header_image', array(
'default' => get_theme_support( 'custom-header', 'default-image' ),
'theme_supports' => 'custom-header',
@@ -3265,8 +3310,30 @@ final class WP_Customize_Manager {
'theme_supports' => 'custom-header',
) ) );
+ $this->add_control( new WP_Customize_Media_Control( $this, 'header_video', array(
+ 'theme_supports' => array( 'custom-header', 'video' ),
+ 'label' => __( 'Header Video' ),
+ 'description' => $control_description,
+ 'section' => 'header_image',
+ 'mime_type' => 'video',
+ ) ) );
+
+ $this->add_control( 'external_header_video', array(
+ 'theme_supports' => array( 'custom-header', 'video' ),
+ 'type' => 'url',
+ 'description' => __( 'Or, enter a YouTube or Vimeo URL:' ),
+ 'section' => 'header_image',
+ ) );
+
$this->add_control( new WP_Customize_Header_Image_Control( $this ) );
+ $this->selective_refresh->add_partial( 'header_video', array(
+ 'selector' => '#wp-custom-header',
+ 'render_callback' => 'the_custom_header',
+ 'settings' => array( 'header_video', 'external_header_video', 'header_image' ), // The image is used as a video fallback here.
+ 'container_inclusive' => true,
+ ) );
+
/* Custom Background */
$this->add_section( 'background_image', array(
@@ -3705,6 +3772,71 @@ final class WP_Customize_Manager {
}
/**
+ * Export header video settings to facilitate selective refresh.
+ *
+ * @since 4.7.0
+ *
+ * @param array $response Response.
+ * @param WP_Customize_Selective_Refresh $selective_refresh Selective refresh component.
+ * @param array $partials Array of partials.
+ * @return array
+ */
+ public function export_header_video_settings( $response, $selective_refresh, $partials ) {
+ if ( isset( $partials['header_video'] ) || isset( $partials['external_header_video'] ) ) {
+ $response['custom_header_settings'] = get_header_video_settings();
+ }
+
+ return $response;
+ }
+
+ /**
+ * Callback for validating the header_video value.
+ *
+ * Ensures that the selected video is less than 8MB and provides an error message.
+ *
+ * @since 4.7.0
+ *
+ * @param WP_Error $validity
+ * @param mixed $value
+ * @return mixed
+ */
+ public function _validate_header_video( $validity, $value ) {
+ $video = get_attached_file( absint( $value ) );
+ if ( $video ) {
+ $size = filesize( $video );
+ if ( 8 < $size / pow( 1024, 2 ) ) { // Check whether the size is larger than 8MB.
+ $validity->add( 'size_too_large', __( 'This video file is too large to use as a header video. Try a shorter video or optimize the compression settings and re-upload a file that is less than 8MB. Or, upload your video to YouTube and link it with the option below.' ) );
+ }
+ if ( '.mp4' !== substr( $video, -4 ) && '.mov' !== substr( $video, -4 ) ) { // Check for .mp4 or .mov format, which (assuming h.264 encoding) are the only cross-browser-supported formats.
+ $validity->add( 'invalid_file_type', __( 'Only .mp4 or .mov files may be used for header video. Please convert your video file and try again, or, upload your video to YouTube and link it with the option below.' ) );
+ }
+ }
+ return $validity;
+ }
+
+ /**
+ * Callback for validating the external_header_video value.
+ *
+ * Ensures that the provided URL is for YouTube or Vimeo.
+ *
+ * @since 4.7.0
+ *
+ * @param WP_Error $validity
+ * @param mixed $value
+ * @return mixed
+ */
+ public function _validate_external_header_video( $validity, $value ) {
+ $video = esc_url( $value );
+ if ( $video ) {
+ if ( ! preg_match( '#^https?://(?:www\.)?(?:youtube\.com/watch|youtu\.be/)#', $video )
+ && ! preg_match( '#^https?://(.+\.)?vimeo\.com/.*#', $video ) ) {
+ $validity->add( 'invalid_url', __( 'Please enter a valid YouTube or Vimeo video URL.' ) );
+ }
+ }
+ return $validity;
+ }
+
+ /**
* Callback for rendering the custom logo, used in the custom_logo partial.
*
* This method exists because the partial object and context data are passed
diff --git src/wp-includes/customize/class-wp-customize-header-image-control.php src/wp-includes/customize/class-wp-customize-header-image-control.php
index 16ebae7..baf12c8 100644
--- src/wp-includes/customize/class-wp-customize-header-image-control.php
+++ src/wp-includes/customize/class-wp-customize-header-image-control.php
@@ -166,9 +166,14 @@ class WP_Customize_Header_Image_Control extends WP_Customize_Image_Control {
$height = absint( get_theme_support( 'custom-header', 'height' ) );
?>
+ ' . $this->label . ''; + } ?> +
Add new image, we recommend matching the size of your video.' ); + } elseif ( $width && $height ) { /* translators: %s: header size in pixels */ printf( __( 'While you can crop images to your liking after clicking Add new image, your theme recommends a header size of %s pixels.' ), sprintf( '%s × %s', $width, $height ) diff --git src/wp-includes/js/wp-custom-header.js src/wp-includes/js/wp-custom-header.js new file mode 100644 index 0000000..d18eccd --- /dev/null +++ src/wp-includes/js/wp-custom-header.js @@ -0,0 +1,145 @@ +(function( window, settings ) { + + function wpCustomHeader() { + var handlers = { + native: { + test: function( settings ) { + var video = document.createElement( 'video' ); + return video.canPlayType( settings.mimeType ); + }, + callback: nativeHandler + }, + youtube: { + test: function( settings ) { + return 'video/x-youtube' === settings.mimeType; + }, + callback: youtubeHandler + } + }; + + function initialize() { + settings.container = document.getElementById( 'wp-custom-header' ); + + if ( supportsVideo() ) { + for ( id in handlers ) { + var handler = handlers[ id ]; + + if ( handlers.hasOwnProperty( id ) && handler.test( settings ) ) { + handler.callback( settings ); + break; + } + } + } + } + + function supportsVideo() { + // Don't load video on small screens. @todo: consider bandwidth and other factors. + if ( 900 > window.innerWidth || 500 > window.innerHeight ) { + return false; + } + + return true; + } + + return { + handlers: handlers, + initialize: initialize, + supportsVideo: supportsVideo + } + } + + function nativeHandler( settings ) { + var video = document.createElement( 'video' ); + + video.id = 'wp-custom-header-video'; + video.autoplay = 'autoplay'; + video.loop = 'loop'; + video.muted = 'muted'; + video.width = settings.width; + video.height = settings.height; + + video.addEventListener( 'click', function() { + if ( video.paused ) { + video.play(); + } else { + video.pause(); + } + }); + + settings.container.innerHTML = ''; + settings.container.appendChild( video ); + video.src = settings.videoUrl; + } + + function youtubeHandler( settings ) { + // @link http://stackoverflow.com/a/27728417 + var VIDEO_ID_REGEX = /^.*(?:(?:youtu\.be\/|v\/|vi\/|u\/\w\/|embed\/)|(?:(?:watch)?\?v(?:i)?=|\&v(?:i)?=))([^#\&\?]*).*/, + videoId = settings.videoUrl.match( VIDEO_ID_REGEX )[1]; + + function loadVideo() { + YT.ready(function() { + var video = document.createElement( 'div' ); + video.id = 'wp-custom-header-video'; + settings.container.innerHTML = ''; + settings.container.appendChild( video ); + + new YT.Player( video, { + height: settings.height, + width: settings.width, + videoId: videoId, + events: { + onReady: function( e ) { + e.target.mute(); + }, + onStateChange: function( e ) { + if ( YT.PlayerState.ENDED === e.data ) { + e.target.playVideo(); + } + } + }, + playerVars: { + autoplay: 1, + controls: 0, + disablekb: 1, + fs: 0, + iv_load_policy: 3, + loop: 1, + modestbranding: 1, + //origin: '', + playsinline: 1, + rel: 0, + showinfo: 0 + } + }); + }); + } + + if ( 'YT' in window ) { + loadVideo(); + } else { + tag = document.createElement( 'script' ); + tag.src = 'https://www.youtube.com/player_api'; + tag.onload = function () { loadVideo(); }; + document.getElementsByTagName( 'head' )[0].appendChild( tag ); + } + } + + window.wp = window.wp || {}; + window.wp.customHeader = new wpCustomHeader(); + document.addEventListener( 'DOMContentLoaded', window.wp.customHeader.initialize, false ); + + if ( 'customize' in window.wp ) { + wp.customize.selectiveRefresh.bind( 'render-partials-response', function( response ) { + if ( 'custom_header_settings' in response ) { + settings = response.custom_header_settings; + } + }); + + wp.customize.selectiveRefresh.bind( 'partial-content-rendered', function( placement ) { + if ( 'header_video' === placement.partial.id || 'external_header_video' === placement.partial.id ) { + window.wp.customHeader.initialize(); + } + }); + } + +})( window, window._wpCustomHeaderSettings || {} ); diff --git src/wp-includes/script-loader.php src/wp-includes/script-loader.php index 89bcc06..378ce1a 100644 --- src/wp-includes/script-loader.php +++ src/wp-includes/script-loader.php @@ -479,6 +479,8 @@ function wp_default_scripts( &$scripts ) { $scripts->add( 'customize-nav-menus', "/wp-admin/js/customize-nav-menus$suffix.js", array( 'jquery', 'wp-backbone', 'customize-controls', 'accordion', 'nav-menu' ), false, 1 ); $scripts->add( 'customize-preview-nav-menus', "/wp-includes/js/customize-preview-nav-menus$suffix.js", array( 'jquery', 'wp-util', 'customize-preview', 'customize-selective-refresh' ), false, 1 ); + $scripts->add( 'wp-custom-header', "/wp-includes/js/wp-custom-header$suffix.js", array(), false, 1 ); + $scripts->add( 'accordion', "/wp-admin/js/accordion$suffix.js", array( 'jquery' ), false, 1 ); $scripts->add( 'shortcode', "/wp-includes/js/shortcode$suffix.js", array( 'underscore' ), false, 1 ); diff --git src/wp-includes/theme.php src/wp-includes/theme.php index 606e254..dca8874 100644 --- src/wp-includes/theme.php +++ src/wp-includes/theme.php @@ -1264,6 +1264,7 @@ function get_custom_header() { 'thumbnail_url' => '', 'width' => get_theme_support( 'custom-header', 'width' ), 'height' => get_theme_support( 'custom-header', 'height' ), + 'video' => get_theme_support( 'custom-header', 'video' ), ); return (object) wp_parse_args( $data, $default ); } @@ -1311,6 +1312,137 @@ function unregister_default_headers( $header ) { } /** + * Check whether a header video is set or not. + * + * @since 4.7.0 + * + * @see get_header_video_url() + * + * @return bool Whether a header video is set or not. + */ +function has_header_video() { + return (bool) get_header_video_url(); +} + +/* Retrieve header video URL for custom header. + * + * Uses a local video if present, or falls back to an external video. Returns false if there is no video. + * + * @since 4.7.0 + * + * @return string|false + */ +function get_header_video_url() { + $id = absint( get_theme_mod( 'header_video' ) ); + $url = esc_url( get_theme_mod( 'external_header_video' ) ); + + if ( ! $id && ! $url ) { + return false; + } + + if ( $id ) { + // Get the file URL from the attachment ID. + $url = wp_get_attachment_url( $id ); + } + + return esc_url_raw( set_url_scheme( $url ) ); +} + +/** + * Display header video URL. + * + * @since 4.7.0 + */ +function the_header_video_url() { + $video = get_header_video_url(); + if ( $video ) { + echo esc_url( $video ); + } +} + +/** + * Retrieve header video settings. + * + * @since 4.7.0 + * + * @return array + */ +function get_header_video_settings() { + $header = get_custom_header(); + $video_url = get_header_video_url(); + $video_type = wp_check_filetype( $video_url, wp_get_mime_types() ); + + $settings = array( + 'mimeType' => '', + 'posterUrl' => get_header_image(), + 'videoUrl' => $video_url, + 'width' => absint( $header->width ), + 'height' => absint( $header->height ), + ); + + if ( preg_match( '#^https?://(?:www\.)?(?:youtube\.com/watch|youtu\.be/)#', $video_url ) ) { + $settings['mimeType'] = 'video/x-youtube'; + } elseif ( preg_match( '#^https?://(.+\.)?vimeo\.com/.*#', $video_url ) ) { + $settings['mimeType'] = 'video/x-vimeo'; + } elseif ( ! empty( $video_type['type'] ) ) { + $settings['mimeType'] = $video_type['type']; + } + + return $settings; +} + +/** + * Retrieve the markup for a custom header. + * + * @since 4.7.0 + * + * @retrun bool True if a custom header is set. False if not. + */ +function has_custom_header() { + if ( has_header_image() || ( is_front_page() && has_header_video() ) ) { + return true; + } + + return false; +} + +/** + * Retrieve the markup for a custom header. + * + * @since 4.7.0 + * + * @return string|false The markup for a custom header on success. False if not. + */ +function get_custom_header_html() { + if ( ! has_custom_header() ) { + return false; + } + + return sprintf( + '