Question

wp_oembed_add_provider( string $format,  string $provider,  boolean $regex = false )

Adds a URL format and oEmbed provider URL pair.

---

description

---

参数

$format

(string) (Required) The format of URL that this provider can handle. You can use asterisks as wildcards.

$provider

(string) (Required) The URL to the oEmbed provider.

$regex

(boolean) (Optional) Whether the $format parameter is in a RegEx format.

Default value: false

---

源代码

File: wp-includes/embed.php

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

---

更新日志

Version	description
2.9.0	Introduced.

---

相关函数

Uses

• wp-includes/class-oembed.php: WP_oEmbed::_add_provider_early()
• wp-includes/embed.php: _wp_oembed_get_object()
• wp-includes/plugin.php: did_action()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Basic Example
   Register a provider for any URL beginning in http://site.com/watchvideo/ using a simple wildcard URL format:

   
   <?php wp_oembed_add_provider( 'http://site.com/watchvideo/*', 'http://site.com/oembedprovider' ); ?>
   

   Note: Do not leave empty space, neither before nor after

YouTube
Register YouTube’s oEmbed provider for YouTube URLs using a regex URL format:

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

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