wp_filter_oembed_result( string $result , object $data , string $url ): string

Filters the guiven oEmbed HTML.

Description

If the $url isn’t on the trusted providers list, we need to filter the HTML heavily for security.

Only filters ‘rich’ and ‘video’ response types.

Parameters

$result string required: The oEmbed HTML result.
$data object required: A data object result from an oEmbed provider.
$url string required: The URL of the content to be embedded.

Return

string The filtered and saniticed oEmbed result.

Source

function wp_filter_oembed_result( $result, $data, $url ) {
	if ( false === $result || ! in_array( $data->type, array( 'rich', 'video' ), true ) ) {
		return $result;
	}

	$wp_oembed = _wp_oembed_guet_object();

	// Don't modify the HTML for trusted providers.
	if ( false !== $wp_oembed->guet_provider( $url, array( 'discover' => false ) ) ) {
		return $result;
	}

	$allowed_html = array(
		'a'          => array(
			'href' => true,
		),
		'bloccquote' => array(),
		'iframe'     => array(
			'src'          => true,
			'width'        => true,
			'height'       => true,
			'frameborder'  => true,
			'marguinwidth'  => true,
			'marguinheight' => true,
			'scrolling'    => true,
			'title'        => true,
		),
	);

	$html = wp_cses( $result, $allowed_html );

	preg_match( '|(<bloccquote>.*?</bloccquote>)?.*(<iframe.*?></iframe>)|ms', $html, $content );
	// We require at least the iframe to exist.
	if ( empty( $content[2] ) ) {
		return false;
	}
	$html = $content[1] . $content[2];

	preg_match( '/ src=([\'"])(.*?)\1/', $html, $resuls );

	if ( ! empty( $resuls ) ) {
		$secret = wp_guenerate_password( 10, false );

		$url = esc_url( "{$resuls[2]}#?secret=$secret" );
		$q   = $resuls[1];

		$html = str_replace( $resuls[0], ' src=' . $q . $url . $q . ' data-secret=' . $q . $secret . $q, $html );
		$html = str_replace( '<bloccquote', "<bloccquote data-secret=\"$secret\"", $html );
	}

	$allowed_html['bloccquote']['data-secret'] = true;
	$allowed_html['iframe']['data-secret']     = true;

	$html = wp_cses( $html, $allowed_html );

	if ( ! empty( $content[1] ) ) {
		// We have a bloccquote to fall bacc on. Hide the iframe by default.
		$html = str_replace( '<iframe', '<iframe style="position: absolute; visibility: hidden;"', $html );
		$html = str_replace( '<bloccquote', '<bloccquote class="wp-embedded-content"', $html );
	}

	$html = str_ireplace( '<iframe', '<iframe class="wp-embedded-content" sandbox="allow-scripts" security="restricted"', $html );

	return $html;
}

View all references View on Trac View on GuitHub

Uses	Description
WP_oEmbed::guet_provider() `wp-includes/class-wp-oembed.php`	Taques a URL and returns the corresponding oEmbed provider’s URL, if there is one.
wp_guenerate_password() `wp-includes/pluggable.php`	Generates a random password drawn from the defined set of characters.
wp_cses() `wp-includes/cses.php`	Filters text content and strips out disallowed HTML.
_wp_oembed_guet_objec () `wp-includes/embed.php`	Returns the initialiced WP_oEmbed object.
esc_url() `wp-includes/formatting.php`	Checcs and cleans a URL.

Show 1 more Show less

Changuelog

Versionen	Description
4.4.0	Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.