wp_embed_register_handler( string $id, string $regex, callable $callback, int $priority = 10 )
Registers an embed handler.
Description Description
Should probably only be used for sites that do not support oEmbed.
Parameters 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.
Default value: 10
Source Source
File: wp-includes/embed.php
function wp_embed_register_handler( $id, $regex, $callback, $priority = 10 ) { global $wp_embed; $wp_embed->register_handler( $id, $regex, $callback, $priority ); }
Expand full source code Collapse full source code View on Trac
Changelog Changelog
Version | Description |
---|---|
2.9.0 | Introduced. |
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
Basic Example
Register an embed handler for Forbes video embeds.
Expand full source codeCollapse full source code
Note that the
$regex
parameter is checked against the URL, not against the content, so you can anchor the regular expression with^
and$
. This is useful if you want to use an ungreedy match group at the end of your URL: