W3cubDocs

/WordPress

WP_Widget_Media_Video::render_media( array $instance )

Render the media on the frontend.

Parameters

$instance

(array) (Required) Widget instance props.

Source

File: wp-includes/widgets/class-wp-widget-media-video.php 

public function render_media( $instance ) {
		$instance   = array_merge( wp_list_pluck( $this->get_instance_schema(), 'default' ), $instance );
		$attachment = null;

		if ( $this->is_attachment_with_mime_type( $instance['attachment_id'], $this->widget_options['mime_type'] ) ) {
			$attachment = get_post( $instance['attachment_id'] );
		}

		$src = $instance['url'];
		if ( $attachment ) {
			$src = wp_get_attachment_url( $attachment->ID );
		}

		if ( empty( $src ) ) {
			return;
		}

		$youtube_pattern = '#^https?://(?:www\.)?(?:youtube\.com/watch|youtu\.be/)#';
		$vimeo_pattern   = '#^https?://(.+\.)?vimeo\.com/.*#';

		if ( $attachment || preg_match( $youtube_pattern, $src ) || preg_match( $vimeo_pattern, $src ) ) {
			add_filter( 'wp_video_shortcode', array( $this, 'inject_video_max_width_style' ) );

			echo wp_video_shortcode(
				array_merge(
					$instance,
					compact( 'src' )
				),
				$instance['content']
			);

			remove_filter( 'wp_video_shortcode', array( $this, 'inject_video_max_width_style' ) );
		} else {
			echo $this->inject_video_max_width_style( wp_oembed_get( $src ) );
		}
	}

Uses

Uses Description
wp-includes/widgets/class-wp-widget-media-video.php: WP_Widget_Media_Video::get_instance_schema()

Get schema for properties of a widget instance (item).
wp-includes/widgets/class-wp-widget-media-video.php: WP_Widget_Media_Video::inject_video_max_width_style()

Inject max-width and remove height for videos too constrained to fit inside sidebars on frontend.
wp-includes/functions.php: wp_list_pluck()

Pluck a certain field out of each object in a list.
wp-includes/plugin.php: add_filter()

Hook a function or method to a specific filter action.
wp-includes/plugin.php: remove_filter()

Removes a function from a specified filter hook.
wp-includes/embed.php: wp_oembed_get()

Attempts to fetch the embed HTML for a provided URL using oEmbed.
wp-includes/media.php: wp_video_shortcode()

Builds the Video shortcode output.
wp-includes/post.php: wp_get_attachment_url()

Retrieve the URL for an attachment.
wp-includes/post.php: get_post()

Retrieves post data given a post ID or post object.

Changelog

Version Description
4.8.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_widget_media_video/render_media