W3cubDocs

/WordPress

WP_Embed::register_handler( string $id, string $regex, callable $callback, int $priority = 10 )

Registers an embed handler.

Description

Do not use this function directly, use wp_embed_register_handler() instead.

This function should probably also only be used for sites that do not support oEmbed.

Parameters

$id

(string) (Required) An internal ID/name for the handler. Needs to be unique.

$regex

(string) (Required) The regex that will be used to see if this handler should be used for a URL.

$callback

(callable) (Required) The callback function that will be called if the regex is matched.

$priority

(int) (Optional) Used to specify the order in which the registered handlers will be tested. Lower numbers correspond with earlier testing, and handlers with the same priority are tested in the order in which they were added to the action.

Default value: 10

Source

File: wp-includes/class-wp-embed.php

public function register_handler( $id, $regex, $callback, $priority = 10 ) {
		$this->handlers[ $priority ][ $id ] = array(
			'regex'    => $regex,
			'callback' => $callback,
		);
	}

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