WP_Customize_Manager::_validate_header_video() WordPress Method

The WP_Customize_Manager::_validate_header_video() method is used to validate a header video for a WordPress site. This method is called when the video is first uploaded or when the video URL is changed.

WP_Customize_Manager::_validate_header_video( WP_Error $validity, mixed $value ) #

Callback for validating the header_video value.


Description

Ensures that the selected video is less than 8MB and provides an error message.


Top ↑

Parameters

$validity

(WP_Error)(Required)

$value

(mixed)(Required)


Top ↑

Return

(mixed)


Top ↑

Source

File: wp-includes/class-wp-customize-manager.php

	public function _validate_header_video( $validity, $value ) {
		$video = get_attached_file( absint( $value ) );
		if ( $video ) {
			$size = filesize( $video );
			if ( $size > 8 * MB_IN_BYTES ) {
				$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',
					sprintf(
						/* translators: 1: .mp4, 2: .mov */
						__( 'Only %1$s or %2$s 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.' ),
						'<code>.mp4</code>',
						'<code>.mov</code>'
					)
				);
			}
		}
		return $validity;
	}


Top ↑

Changelog

Changelog
VersionDescription
4.7.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.

Show More