wp_oembed_add_provider()


WordPressの関数wp_oembed_add_provider()は、埋め込みコンテンツのプロバイダを追加するために使用されます。

シンタックス

wp_oembed_add_provider( string $format, string $provider, bool $regex = false );

引数の説明:

  • $format (string) — URL形式を指定するパターン。
  • $provider (string) — 埋め込みプロバイダのURL。
  • $regex (bool) — $formatが正規表現であるかどうかを示す。デフォルトはfalse。

例 1: カスタムプロバイダの追加

カスタムプロバイダURLをwp_oembed_add_provider()を使用して追加します。

wp_oembed_add_provider( 'https://example.com/*', 'https://example.com/oembed' );

例 2: 正規表現を使用してプロバイダを追加

正規表現を使用してURLパターンを設定します。

wp_oembed_add_provider( '#https://(www\.)?customsite\.com/.*#i', 'https://customsite.com/oembed', true );

例 3: フックを使用してプロバイダを登録

oembed_providersフィルターを使用してプロバイダを追加します。

function add_custom_oembed_provider() {
    wp_oembed_add_provider( 'https://example.com/*', 'https://example.com/oembed' );
}
add_action( 'init', 'add_custom_oembed_provider' );

例 4: Vimeoの埋め込みを追加

Vimeoの埋め込みプロバイダを追加します。

wp_oembed_add_provider( 'https://vimeo.com/*', 'https://vimeo.com/api/oembed.json' );

例 5: URLパターンを制限する

URLの形式を限定してプロバイダを追加します。

wp_oembed_add_provider( 'https://myvideosite.com/watch/*', 'https://myvideosite.com/oembed' );

注意事項

wp_oembed_add_provider()を使用する際は、正規表現を指定する場合$regexをtrueに設定してください。また、プロバイダのURLが正しい形式で動作することを事前に確認することが推奨されます。

関連機能：