W3cubDocs

/WordPress

wp_embed_register_handler( string $id, string $regex, callable $callback, int $priority = 10 )

Registers an embed handler.

Description

Should probably only be used for sites that do not support oEmbed.

Parameters

$idstringrequired
An internal ID/name for the handler. Needs to be unique.
$regexstringrequired
The regex that will be used to see if this handler should be used for a URL.
$callbackcallablerequired
The callback function that will be called if the regex is matched.
$priorityintoptional
Used to specify the order in which the registered handlers will be tested.

Default:10

Source

function wp_embed_register_handler( $id, $regex, $callback, $priority = 10 ) {
	global $wp_embed;
	$wp_embed->register_handler( $id, $regex, $callback, $priority );
}

Changelog

Version Description
2.9.0 Introduced.

© 2003–2024 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_embed_register_handler