万が一、当サイトで重大な問題を発見した際などは、フォーラムや WordSlack #docs チャンネルでお知らせください。</p>
「oEmbed」の版間の差分
細 (和訳完了。日本語の外部リソースリンクを追加。) |
(補足、embed ショートコードパラメータ（外部リンク）を追加) |
||
| 1行目: | 1行目: | ||
{{Rename|E}} | {{Rename|E}} | ||
__TOC__ | __TOC__ | ||
| − | [[Version 2.9|WordPress 2.9]] | + | [[Version 2.9|WordPress 2.9]] 以降、動画・画像・その他のコンテンツを WordPress サイトに'''埋め込む'''（embed）のがとても簡単になりました。 |
| − | + | ||
== 概要 == | == 概要 == | ||
| − | + | [[Writing Posts|投稿]]や[[Pages|固定ページ]]にメディアを埋め込むには、本文欄に URL を書くだけです。URL は独立した行に書くこと、（投稿表示時にクリックできるような）[[Wikipedia:ja:ハイパーリンク|ハイパーリンク]]にしないこと、の2点に注意してください。 | |
例えば、 | 例えば、 | ||
| − | + | この動画を見てみて！ | |
| − | + | <nowiki>http://www.youtube.com/watch?v=nTDNLUzjkpg</nowiki> | |
すごいでしょう？ | すごいでしょう？ | ||
| − | + | のように入力すれば、投稿が表示される際、URLの位置に自動的に YouTube 動画が埋め込まれます（[[管理パネル]] > [[管理パネル#Settings|設定]] > [[Settings Media SubPanel|メディア設定]]画面の「Auto-embeds」にチェック）。 | |
| − | また、URL を<code>[embed]</code> | + | また、URL を <code>[embed]</code> [[ショートコード API|ショートコード]]で囲むこともできます。表示結果は同じですが、URL は独立した行に書かれていなくてもよく、「Auto-embeds」設定も不要です。（利用できるパラメータは[[#外部資料|外部資料]]を参照） |
== oEmbed == | == oEmbed == | ||
| 55行目: | 54行目: | ||
=== oEmbed 対応サイト === | === oEmbed 対応サイト === | ||
| − | サイトが oEmbed に対応している場合は、 | + | サイトが oEmbed に対応している場合は、[[関数リファレンス/wp_oembed_add_provider|<code>wp_oembed_add_provider()</code>]]/[[:en:Function Reference/wp_oembed_add_provider|en]] を呼び出し、そのサイトの URL 形式を内部のホワイトリストに追加します。 |
=== oEmbed 非対応サイト === | === oEmbed 非対応サイト === | ||
| − | + | [[関数リファレンス/wp_embed_register_handler|<code>wp_embed_register_handler()</code>]]/[[:en:Function Reference/wp_embed_register_handler|en]] を使ってハンドラーを登録します。その後、HTML を生成するコールバック関数が必要になります。 | |
== oEmbed 自動探知は使えますか？ == | == oEmbed 自動探知は使えますか？ == | ||
| 67行目: | 66行目: | ||
しかし、十分に知識があり、そのような防衛策が必要ないなら、<code>unfiltered_html</code> 権限を持つユーザー（管理者と編集者）は oEmbed 探知（ディスカバリー）タグが <code><head></code> にあるすべてのサイトからのメディアを埋め込むようにもできます。これには、[http://wordpress.org/extend/plugins/enable-oembed-discovery/ Enable oEmbed Discovery] プラグインを使うだけです。 | しかし、十分に知識があり、そのような防衛策が必要ないなら、<code>unfiltered_html</code> 権限を持つユーザー（管理者と編集者）は oEmbed 探知（ディスカバリー）タグが <code><head></code> にあるすべてのサイトからのメディアを埋め込むようにもできます。これには、[http://wordpress.org/extend/plugins/enable-oembed-discovery/ Enable oEmbed Discovery] プラグインを使うだけです。 | ||
| − | == | + | == 外部資料 == |
=== 日本語記事 === | === 日本語記事 === | ||
* [http://webos-goodies.jp/archives/getting_started_with_oembed.html oEmbed でメディア共有サイトのコンテンツを簡単埋め込み] | * [http://webos-goodies.jp/archives/getting_started_with_oembed.html oEmbed でメディア共有サイトのコンテンツを簡単埋め込み] | ||
* [http://www.google.com/support/youtube/bin/answer.py?hl=jp&answer=164669 YouTube ヘルプ | 詳細: oEmbed による動画の埋め込み] | * [http://www.google.com/support/youtube/bin/answer.py?hl=jp&answer=164669 YouTube ヘルプ | 詳細: oEmbed による動画の埋め込み] | ||
| + | * [http://bono.s206.xrea.com/2010/01/1017-wp29/ power source* » WP: WordPress 2.9 新機能・仕様変更まとめ] - <code>[embed]</code> ショートコードで利用できるパラメータ | ||
=== 英語記事 === | === 英語記事 === | ||
| 81行目: | 81行目: | ||
{{CheckTrans}} | {{CheckTrans}} | ||
| − | {{原文|Embeds| | + | {{原文|Embeds|82535}}<!-- 07:27, 1 February 2010 Viper 版 --> |
<!-- {{DEFAULTSORT:}}ページ名日本語にしたら書く --> | <!-- {{DEFAULTSORT:}}ページ名日本語にしたら書く --> | ||
2010年2月8日 (月) 23:14時点における版
目次
WordPress 2.9 以降、動画・画像・その他のコンテンツを WordPress サイトに埋め込む（embed）のがとても簡単になりました。
概要
投稿や固定ページにメディアを埋め込むには、本文欄に URL を書くだけです。URL は独立した行に書くこと、（投稿表示時にクリックできるような）ハイパーリンクにしないこと、の2点に注意してください。
例えば、
この動画を見てみて！ http://www.youtube.com/watch?v=nTDNLUzjkpg すごいでしょう？
のように入力すれば、投稿が表示される際、URLの位置に自動的に YouTube 動画が埋め込まれます（管理パネル > 設定 > メディア設定画面の「Auto-embeds」にチェック）。
また、URL を [embed] ショートコードで囲むこともできます。表示結果は同じですが、URL は独立した行に書かれていなくてもよく、「Auto-embeds」設定も不要です。（利用できるパラメータは外部資料を参照）
oEmbed
簡単なメディア埋め込み機能のほとんどは、oEmbed によって提供されています。oEmbed は、A というサイト（例えばあなたのブログ）が B というサイト（例えば YouTube）に、コンテンツを埋め込むために必要な HTML を問い合せるためのプロトコルです。
oEmbed は、メディアを埋め込みたいサイトから HTML コードをコピー＆ペーストしたりしなくて済むように設計されています。動画、画像、テキストなどに対応しています。
どんな URL でもこの機能を使えますか？
デフォルトでは限られたサイトからの URL のみに有効です。安全対策のため、WordPress は内部のホワイトリストに一致する URL のみを埋め込みます。
このメディア埋め込み機能を使えるサイトは？
以下のサイトを利用できます。
- YouTube
- Vimeo
- DailyMotion
- blip.tv
- Flickr (both videos and images)
- Viddler
- Hulu
- Qik
- Revision3
- Scribd
- Photobucket
- PollDaddy
- Google Video
- WordPress.tv（現在は VideoPress 形式の動画のみ）
他のサイトに対応するには？
他のサイトへの対応を追加する方法は、そのサイトが oEmbed に対応しているかどうかによって異なります。
oEmbed 対応サイト
サイトが oEmbed に対応している場合は、wp_oembed_add_provider()/en を呼び出し、そのサイトの URL 形式を内部のホワイトリストに追加します。
oEmbed 非対応サイト
wp_embed_register_handler()/en を使ってハンドラーを登録します。その後、HTML を生成するコールバック関数が必要になります。
oEmbed 自動探知は使えますか？
WordPress の oEmbed 実装では、自動探知は無効化されています。デフォルトでは、内部のホワイトリストに挙げられた、安全とみなされたサイトからのメディアのみを埋め込むことができます。これは、悪意のあるサイトのメディアを間違って埋め込んでしまうことがないようにするためです。
しかし、十分に知識があり、そのような防衛策が必要ないなら、unfiltered_html 権限を持つユーザー（管理者と編集者）は oEmbed 探知（ディスカバリー）タグが <head> にあるすべてのサイトからのメディアを埋め込むようにもできます。これには、Enable oEmbed Discovery プラグインを使うだけです。
外部資料
日本語記事
- oEmbed でメディア共有サイトのコンテンツを簡単埋め込み
- YouTube ヘルプ | 詳細: oEmbed による動画の埋め込み
- power source* » WP: WordPress 2.9 新機能・仕様変更まとめ -
[embed]ショートコードで利用できるパラメータ
英語記事
- Summary of this feature - コード作者による機能のまとめ
- Webmonkey guide to oEmbed
- Official oEmbed website - oEmbed の技術的仕様
この項目「oEmbed」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。
最新英語版： WordPress Codex » Embeds （最新版との差分）
