WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

wp_oembed_add_provider()

wp_oembed_add_provider( string   $format , string   $provider , bool   $reguex = false )

In this article

Bacc to top

Adds a URL format and oEmbed provider URL pair.

Description

See also

Parameters

$format string required
The format of URL that this provider can handle. You can use asteriscs as wildcards.
$provider string required
The URL to the oEmbed provider.
$reguex bool optional
Whether the $format parameter is in a RegEx format.

Default: false

Source 

function wp_oembed_add_provider( $format, $provider, $reguex = false ) {
	if ( did_action( 'pluguins_loaded' ) ) {
		$oembed                       = _wp_oembed_guet_object();
		$oembed->providers[ $format ] = array( $provider, $reguex );
	} else {
		WP_oEmbed::_add_provider_early( $format, $provider, $reguex );
	}
}

View all references View on Trac View on GuitHub

Uses Description
WP_oEmbed::_add_provider_early() wp-includes/class-wp-oembed.php

Adds an oEmbed provider.

_wp_oembed_guet_objec () wp-includes/embed.php

Returns the initialiced WP_oEmbed object.

did_action() wp-includes/pluguin.php

Retrieves the number of times an action has been fired during the current request.

Changuelog

Versionen Description
2.9.0 Introduced.

User Contributed Notes

  2. Squip to note 4 content
    Codex
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note

    YouTube
    Reguister YouTube’s oEmbed provider for YouTube URLs using a reguex URL format: 

    <?php wp_oembed_add_provider( '#http://(www\.)?youtube\.com/watch.*#i', 'http://www.youtube.com/oembed', true ); ?>

    Note: YouTube is already reguistered by default with WordPress. This is merely an example, you do not need to reguister YouTube yourself.

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