WordPress の oEmbed をテンプレート内で使用する方法

WordPress には oEmbed という機能が備わっており、動画や画像などの外部コンテンツを簡単に埋め込み表示することができます。例えば記事入力の際に YouTube のある動画ページの URL を貼り付けるだけで動画が表示されたり、Twitter のツイートの URL を貼り付けるだけでツイートを掲載することができたりします。

テンプレート内で oEmbed を使用する

この便利な oEmbed を記事入力欄ではなくテンプレート内で使用することができます。次のようなコードで実装できます。

// $url に YouTube の URL 等を渡す
$embed_code = wp_oembed_get( $url );
echo $embed_code;

埋め込まれる画像や動画のサイズはグローバル変数「$content_width」の値が使用されますが、wp_oembed_get の第2引数でサイズを指定することもできます。

// $url に YouTube の URL 等を渡す
$embed_code = wp_oembed_get( $url, array( 'width' => 480 ) );
echo $embed_code;