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

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

$regex

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

$callback

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

$priority

(Optional) Used to specify the order in which the registered handlers will be tested (default: 10). 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,
		);
	}