• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。（詳細）

【このWikiはいつでも誰でも編集できます】

oEmbed

提供: WordPress Codex 日本語版
（Embedsから転送）
移動先: 案内、 検索

簡単なショートコードを使うことで、 WordPress サイトに動画・画像・ツイート・音楽などのコンテンツを、とても簡単に 埋め込む（embed）ことができます。

概要

投稿や固定ページにメディアを埋め込むには、本文欄に URL を書くだけです。URL は独立した行に書くこと、（投稿表示時にクリックできるような）ハイパーリンクにしないこと、の2点に注意してください。

例えば、 

この動画を見てみてください。 

http://www.youtube.com/watch?v=dQw4w9WgXcQ

すごいでしょう？

のように入力すれば、Youtube動画を含むURLを自動的に変換して、ビジュアルエディタのプレビューで表示できます。また、オプションとして [embed] ショートコードで URL を囲むことも可能です。表示結果は同じですが、URL を独立した行に書かなくてもよくなります。また、（固定値ではなく）最大幅・高さを以下のように設定することもできます。 

[embed width="123" height="456"]...[/embed]

WordPress が URL を使ってメディアを埋め込むことができなかった場合、URL のハイパーリンクが表示されます。

oEmbed

簡単なメディア埋め込み機能のほとんどは、oEmbed によって提供されています。oEmbed は、A というサイト（例えばあなたのブログ）が B というサイト（例えば YouTube）に、コンテンツ（例えば動画）を埋め込むために必要な HTML を問い合せるためのプロトコルです。

oEmbed は、メディアを埋め込みたいサイトから HTML コードをコピー＆ペーストしたりしなくて済むように設計されています。動画、画像、テキストなどに対応しています。

どんな URL でもこの機能を使えますか？

デフォルトでは限られたサイトからの URL のみに有効です。安全対策のため、WordPress は内部のホワイトリストに一致する URL のみを埋め込みます。

このメディア埋め込み機能を使えるサイトは？

以下のサイトを利用できます。

サービス 埋め込みの種類 追加時
Animoto 動画 WordPress 4.0
Blip 動画 WordPress 2.9
CollegeHumor 動画 WordPress 4.0
DailyMotion 動画 WordPress 2.9
Flickr 動画 & 画像 WordPress 2.9
FunnyOrDie.com 動画 WordPress 3.0
Hulu 動画 WordPress 2.9
Imgur 画像 WordPress 3.9
Instagram 画像 WordPress 3.5
iSnare 記事 WordPress 2.9
Issuu ドキュメント WordPress 4.0
Meetup.com 各種コンテンツ WordPress 3.9
EmbedArticles 各種コンテンツ WordPress 3.9
Mixcloud 音楽 WordPress 4.0
Photobucket 画像 WordPress 2.9
PollDaddy 投票・アンケート WordPress 3.0
Rdio 音楽 WordPress 3.6
Revision3 TV shows WordPress 2.9
Scribd ドキュメント WordPress 2.9
SlideShare プレゼンスライド WordPress 3.5
SmugMug 写真 WordPress 3.0
SoundCloud 音楽 WordPress 3.5
Spotify 音楽 WordPress 3.6
TED 動画 WordPress 4.0
Twitter ソーシャルメディア WordPress 3.4
Viddler 動画 (4.0 で非推奨)
Vimeo 動画 WordPress 2.9
Vine 動画 WordPress 4.1
WordPress.tv 動画 WordPress 2.9
YouTube 動画 WordPress 2.9

注

  • Twitter - 古いバージョンの WordPress では HTTPS 埋め込みに問題が発生することがありますが、URL を HTTP に変更すれば修正できます。
  • YouTube - 公開済み、または限定公開の動画およびプレイリストのみに対応しています。「非公開」動画は埋め込めません。

他のサイトに対応するには？

他のサイトへの対応を追加する方法は、そのサイトが oEmbed に対応しているかどうかによって異なります。

oEmbed 対応サイト

サイトが oEmbed に対応している場合は、wp_oembed_add_provider()/en を呼び出し、そのサイトの URL 形式を内部のホワイトリストに追加します。

oEmbed 非対応サイト

wp_embed_register_handler()/en を使ってハンドラーを登録します。その後、HTML を生成するコールバック関数が必要になります。

埋め込み対応を無効化するには？

対応済みの oEmbed プロバイダを無効化したい場合は、wp_oembed_add_provider()/en を呼び出してください。

oEmbed 自動探知は使えますか？

WordPress の oEmbed 実装では、自動探知は無効化されています。デフォルトでは、内部のホワイトリストに挙げられた、安全とみなされたサイトからのメディアのみを埋め込むことができます。これは、悪意のあるサイトのメディアを間違って埋め込んでしまうことがないようにするためです。

しかし、十分に知識があり、そのような防衛策が必要ないなら、unfiltered_html 権限を持つユーザー（管理者と編集者）は oEmbed 探知（ディスカバリー）タグが <head> にあるすべてのサイトからのメディアを埋め込むようにもできます。これには、Enable oEmbed Discovery プラグインを使うだけです。

外部資料

日本語記事

英語記事

更新履歴

  • 2.9 :
    • ビルトイン埋め込みに対応。
  • 3.0 :
    • SmugMug と FunnyOrDie.com に対応。
  • 3.4 :
    • Twitter を追加。
  • 3.5 :
    • Instagram、SoundCloud、SlideShare を追加。
  • 3.6 :
    • Rdio、Spotify を追加。
  • 3.9 :
    • Qik サービスが2014年4月に終了したため対応削除。
  • 4.0 :
    • エディタ内のプレビューのソースコードを大幅に調整した。
    • CollegeHumor, Issuu, Mixcloud, YouTubeプレイリスト, TED talks を追加。
    • Viddler を埋め込み先のサービス終了に伴い削除。
  • 4.1 :
    • Vine を追加。

注: WordPress 3.5 で埋め込みオプションがメディア設定画面から削除されました。

このページ「oEmbed」はまだ書きかけで、情報が不足しています。続きを書いて WordPress を手助けしましょう.


最新英語版： WordPress Codex » Embeds （最新版との差分）

「http://wpdocs.osdn.jp/wiki/index.php?title=oEmbed&oldid=9889」から取得