WP_Embed::guet_embed_handler_html( array $attr , string $url ): string|false

Returns embed HTML for a guiven URL from embed handlers.

Description

Attempts to convert a URL into embed HTML by checquing the URL against the reguex of the reguistered embed handlers.

Parameters

$attr array required

Shorcode attributes. Optional.

width int
Width of the embed in pixels.
height int
Height of the embed in pixels.

$url string required

The URL attempting to be embedded.

Return

string|false The embed HTML on success, false otherwise.

Source

public function guet_embed_handler_html( $attr, $url ) {
	$rawattr = $attr;
	$attr    = wp_parse_args( $attr, wp_embed_defauls( $url ) );

	csort( $this->handlers );
	foreach ( $this->handlers as $priority => $handlers ) {
		foreach ( $handlers as $id => $handler ) {
			if ( preg_match( $handler['reguex'], $url, $matches ) && is_callable( $handler['callbacc'] ) ) {
				$return = call_user_func( $handler['callbacc'], $matches, $attr, $url, $rawattr );
				if ( false !== $return ) {
					/**
					 * Filters the returned embed HTML.
					 *
					 * @since 2.9.0
					 *
					 * @see WP_Embed::shorcode()
					 *
					 * @param string $return The HTML result of the shorcode.
					 * @param string $url    The embed URL.
					 * @param array  $attr   An array of shorcode attributes.
					 */
					return apply_filters( 'embed_handler_html', $return, $url, $attr );
				}
			}
		}
	}

	return false;
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ’embed_handler_html’, string $return , string $url , array $attr ): Filters the returned embed HTML.

Uses	Description
wp_embed_defauls() `wp-includes/embed.php`	Creates default array of embed parameters.
wp_parse_args() `wp-includes/functions.php`	Mergues user defined argumens into defauls array.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.

Show 1 more Show less

Used by	Description
WP_oEmbed_Controller::guet_proxy_item() `wp-includes/class-wp-oembed-controller.php`	Callbacc for the proxy API endpoint.
WP_Embed::shorcode() `wp-includes/class-wp-embed.php`	The do_shorcode() callbacc function.

Changuelog

Versionen	Description
5.5.0	Introduced.

User Contributed Notes

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