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

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

「oEmbed」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(リンク調整等)
(和訳完了。日本語の外部リソースリンクを追加。)
1行目: 1行目:
{{NeedTrans}}
 
 
{{Rename|E}}
 
{{Rename|E}}
 
__TOC__
 
__TOC__
Starting with [[Version 2.9|WordPress 2.9]], it's super easy to embed videos, images, and other content into your WordPress site.
+
[[Version 2.9|WordPress 2.9]] 以降、動画・画像その他のコンテンツを WordPress サイトに埋め込むのがとても簡単になりました。
  
== In A Nutshell ==
 
  
All you need to do to embed something into a post or [[Pages|page]] is to post the URL to it into your content area. Make sure that the URL is on its own line and not hyperlinked (clickable when viewing the post).
+
== 概要 ==
  
For example:
+
投稿や[[Pages|固定ページ]]にメディアを埋め込むには、コンテンツ部分に URL を含めるだけです。URL は独立した行に書くこと、(クリックできるような)リンクを付けないことの2点に注意してください。
  
  Check out this cool video:
+
例えば、
 +
 
 +
  この動画を見てみてください!
 
   
 
   
 
  ht<span></span>tp://www.youtube.com/watch?v=nTDNLUzjkpg
 
  ht<span></span>tp://www.youtube.com/watch?v=nTDNLUzjkpg
 
   
 
   
  That was a cool video.
+
  すごいでしょう?
  
WordPress will automatically turn that into a YouTube embed when the post is viewed.
+
のように入力すれば、投稿が表示された際、リンクは自動的に YouTube の埋め込み動画へ変換されます。
  
You can also opt to wrap the URL in the <code>[embed]</code> shortcode. It will accomplish the same effect, but does not require the URL to be on its own line.
+
また、URL を<code>[embed]</code> ショートコードで囲むこともできます。表示結果は同じですが、こうすれば URL が独立した行に書かれていなくてもよくなります。
  
 
== oEmbed ==
 
== oEmbed ==
  
The easy embedding feature is mostly powered by oEmbed, a protocol for site A (such as your blog) to ask site B (such as YouTube) for the HTML needed to embed content (such as a video) from site B.
+
簡単なメディア埋め込み機能のほとんどは、oEmbed によって提供されています。oEmbed は、A というサイト(例えばあなたのブログ)が B というサイト(例えば YouTube)に、コンテンツを埋め込むために必要な HTML を問い合せるためのプロトコルです。
  
oEmbed was designed to avoid having to copy and paste HTML from the site hosting the media you wish to embed.  It supports videos, images, text, and more.
+
oEmbed は、メディアを埋め込みたいサイトから HTML コードをコピー&ペーストしたりしなくて済むように設計されています。動画、画像、テキストなどに対応しています。
  
== Can I Use Any URL With This? ==
+
== どんな URL でもこの機能を使えますか? ==
  
Not by default, no. WordPress will only embed URLs matching an internal whitelist. This is for security purposes.
+
デフォルトでは限られたサイトからの URL のみに有効です。安全対策のため、WordPress は内部のホワイトリストに一致する URL のみを埋め込みます。
  
=== Okay, So What Sites Can I Embed From? ===
+
=== このメディア埋め込み機能を使えるサイトは? ===
  
You can use all of these:
+
以下のサイトを利用できます。
  
 
* [http://www.youtube.com/ YouTube]
 
* [http://www.youtube.com/ YouTube]
47行目: 47行目:
 
* [http://www.polldaddy.com/ PollDaddy]
 
* [http://www.polldaddy.com/ PollDaddy]
 
* [http://video.google.com/ Google Video]
 
* [http://video.google.com/ Google Video]
* [http://wordpress.tv/ WordPress.tv] (only [http://videopress.com/ VideoPress]-type videos for the time being)
+
* [http://wordpress.tv/ WordPress.tv](現在は [http://videopress.com/ VideoPress] 形式の動画のみ)
 +
 
 +
== 他のサイトに対応するには? ==
  
== How Can I Add Support For More Websites? ==
+
他のサイトへの対応を追加する方法は、そのサイトが oEmbed に対応しているかどうかによって異なります。
  
Adding support for an additional website depends on whether the site supports oEmbed or not.
+
=== oEmbed 対応サイト ===
  
=== Adding Support For An oEmbed-Enabled Site ===
+
サイトが oEmbed に対応している場合は、<code>[[関数リファレンス/wp_oembed_add_provider|wp_oembed_add_provider()]]</code>/[[:en:Function Reference/wp_oembed_add_provider|en]] を呼び出し、そのサイトの URL 形式を内部のホワイトリストに追加します。
  
If a site supports oEmbed, you'll want to call <code>[[関数リファレンス/wp_oembed_add_provider|wp_oembed_add_provider()]]</code>/[[:en:Function Reference/wp_oembed_add_provider|en]] to add the site and URL format to the internal whitelist.
+
=== oEmbed 非対応サイト ===
  
=== Adding Support For A Non-oEmbed Site ===
+
<code>[[関数リファレンス/wp_embed_register_handler|wp_embed_register_handler()]]</code>/[[:en:Function Reference/wp_embed_register_handler|en]] を使ってハンドラーを登録します。その後、HTML を生成するコールバック関数が必要になります。
  
You'll need to register a handler using <code>[[関数リファレンス/wp_embed_register_handler|wp_embed_register_handler()]]</code>/[[:en:Function Reference/wp_embed_register_handler|en]] and provide a callback function that generates the HTML.
+
== oEmbed 自動探知は使えますか? ==
  
== What About oEmbed Discovery? ==
+
WordPress の oEmbed 実装では、自動探知は無効化されています。デフォルトでは、内部のホワイトリストに挙げられた、安全とみなされたサイトからのメディアのみを埋め込むことができます。これは、悪意のあるサイトのメディアを間違って埋め込んでしまうことがないようにするためです。
  
The oEmbed implementation in WordPress has discovery disabled. By default, you can only embed from websites that are listed on the internal whitelist. This is to prevent accidental embedding from malicious websites.
+
しかし、十分に知識があり、そのような防衛策が必要ないなら、<code>unfiltered_html</code> 権限を持つユーザー(管理者と編集者)は oEmbed 探知(ディスカバリー)タグが <code>&lt;head&gt;</code> にあるすべてのサイトからのメディアを埋め込むようにもできます。これには、[http://wordpress.org/extend/plugins/enable-oembed-discovery/ Enable oEmbed Discovery] プラグインを使うだけです。
  
However if you feel you are knowledgeable enough to avoid this, you can give <code>unfiltered_html</code> users (Administrators and Editors) the ability to embed from websites that have oEmbed discovery tags in their <code>&lt;head&gt;</code>. You merely need to install [http://wordpress.org/extend/plugins/enable-oembed-discovery/ this plugin].
+
== 外部リソース ==
  
== External Resources ==
+
=== 日本語記事 ===
 +
* [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.viper007bond.com/2009/10/13/easy-embeds-for-wordpress-2-point-9/ Summary of this feature] by the author of this code
+
=== 英語記事 ===
 +
* [http://www.viper007bond.com/2009/10/13/easy-embeds-for-wordpress-2-point-9/ Summary of this feature] - コード作者による機能のまとめ
 
* [http://www.webmonkey.com/tutorial/Get_Started_With_OEmbed Webmonkey guide to oEmbed]
 
* [http://www.webmonkey.com/tutorial/Get_Started_With_OEmbed Webmonkey guide to oEmbed]
* [http://oembed.com/ Official oEmbed website] (technical details of the spec)
+
* [http://oembed.com/ Official oEmbed website] - oEmbed の技術的仕様
  
 
{{Stub}}
 
{{Stub}}
 +
{{CheckTrans}}
  
 
{{原文|Embeds|81260}}<!-- 15:16, 21 December 2009 Otto42 版 -->
 
{{原文|Embeds|81260}}<!-- 15:16, 21 December 2009 Otto42 版 -->

2010年1月13日 (水) 23:43時点における版

ページ名検討中: このページ名「oEmbed」について改名が提案されています。ご意見をお寄せください。

WordPress 2.9 以降、動画・画像その他のコンテンツを WordPress サイトに埋め込むのがとても簡単になりました。


概要

投稿や固定ページにメディアを埋め込むには、コンテンツ部分に URL を含めるだけです。URL は独立した行に書くこと、(クリックできるような)リンクを付けないことの2点に注意してください。

例えば、

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

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

すごいでしょう?

のように入力すれば、投稿が表示された際、リンクは自動的に YouTube の埋め込み動画へ変換されます。

また、URL を[embed] ショートコードで囲むこともできます。表示結果は同じですが、こうすれば URL が独立した行に書かれていなくてもよくなります。

oEmbed

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

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

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

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

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

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

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

他のサイトへの対応を追加する方法は、そのサイトが 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」はまだ書きかけで、情報が不足しています。続きを書いて WordPress を手助けしましょう.


この項目「oEmbed」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。

最新英語版: WordPress Codex » Embeds最新版との差分