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

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

「oEmbed」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(英語版ハンドブックのリンク差し替え)
(HelpHub 転送リンクに修正。)
 
1行目: 1行目:
__TOC__
+
このページは https://ja.wordpress.org/support/article/embeds/ へ移動しました。
 
+
簡単な[[ショートコード API|ショートコード]]を使うことで、 WordPress サイトに動画・画像・ツイート・音楽などのコンテンツを、とても簡単に '''埋め込む'''(embed)ことができます。この機能は [https://wordpress.org/news/2009/12/wordpress-2-9/ WordPress 2.9] で追加されました。
+
 
+
== 使い方 ==
+
 
+
[[Writing Posts|投稿]]や[[Pages|固定ページ]]にメディアを埋め込むには、本文欄に URL を書くだけです。URL は独立した行に書くこと、(投稿表示時にクリックできるような)[[Wikipedia:ja:ハイパーリンク|ハイパーリンク]]にしないこと、の2点に注意してください。
+
 
+
例えば、
+
 
+
<pre>この動画を見てみてください。
+
 
+
<nowiki>http://www.youtube.com/watch?v=dQw4w9WgXcQ</nowiki>
+
 
+
すごいでしょう?</pre>
+
 
+
 
+
のように入力すれば、URL を YouTube 埋め込みコード自動変換して、ビジュアルエディタのプレビューで表示できます。
+
 
+
また、オプションとして <code>[embed]</code> [[ショートコード API|ショートコード]]で URL を囲むことも可能です。
+
 
+
[embed width="123" height="456"]...[/embed]
+
 
+
WordPress が URL を使ってメディアを埋め込むことができなかった場合、URL のハイパーリンクが表示されます。
+
 
+
== oEmbed ==
+
 
+
簡単なメディア埋め込み機能のほとんどは、oEmbed によって提供されています。oEmbed は、A というサイト(例えばあなたのブログ)が B というサイト(例えば YouTube)に、コンテンツ(例えば動画)を埋め込むために必要な HTML を問い合せるためのプロトコルです。
+
 
+
oEmbed は、メディアを埋め込みたいサイトから HTML コードをコピー&ペーストしたりしなくて済むように設計されています。動画、画像、テキストなどに対応しています。
+
 
+
== どんな URL でもこの機能を使えますか? ==
+
 
+
デフォルトでは限られたサイトからの URL のみに有効です。安全対策のため、WordPress は内部のホワイトリストに一致する URL のみを埋め込みます。
+
 
+
== メディア埋め込み元として使えるサイト ==
+
 
+
'''[https://wordpress.org/support/article/embeds/#okay-so-what-sites-can-i-embed-from 英語版ハンドブックのリスト]'''をご覧ください。
+
 
+
'''注'''
+
* Twitter - 古いバージョンの WordPress では HTTPS 埋め込みに問題が発生することがありますが、URL を HTTPS HTTP に変更すれば修正できます。
+
* YouTube - 公開済み、または限定公開の動画およびプレイリストのみに対応しています。「非公開」動画は埋め込めません。
+
* Tumblr - 投稿 (name.tumblr.com/post/etc) のみが認識されます。個別の画像 (name.tumblr.com/image) は埋め込めません。
+
 
+
== 他のサイトに対応する方法 ==
+
 
+
他のサイトへの対応を追加する方法は、そのサイトが oEmbed に対応しているかどうかによって異なります。
+
 
+
=== oEmbed 対応サイト ===
+
 
+
サイトが oEmbed に対応している場合は、[[関数リファレンス/wp_oembed_add_provider|<code>wp_oembed_add_provider()</code>]]/[[:en:Function Reference/wp_oembed_add_provider|en]] を呼び出し、そのサイトの URL 形式を内部のホワイトリストに追加します。
+
 
+
=== oEmbed 非対応サイト ===
+
 
+
[[関数リファレンス/wp_embed_register_handler|<code>wp_embed_register_handler()</code>]]/[[:en:Function Reference/wp_embed_register_handler|en]] を使ってハンドラーを登録します。その後、HTML を生成するコールバック関数が必要になります。
+
 
+
=== oEmbed 対応サイトの埋め込みを無効化する ===
+
 
+
対応済みの oEmbed プロバイダを無効化したい場合は、[[関数リファレンス/wp_oembed_add_provider|<code>wp_oembed_add_provider()</code>]]/[[:en:Function Reference/wp_oembed_add_provider|en]] を呼び出してください。
+
 
+
=== コアでの oEmbed プロバイダのホワイトリスト化 ===
+
 
+
コアに含める oEmbed プロバイダに対しては一定の基準があります。既存のホワイトリストに新しいものを追加するには、[https://make.wordpress.org/core/handbook/contribute/design-decisions/#whitelisting-oembed-providers 一定の条件]を満たす必要があります。
+
 
+
== oEmbed 自動探知 ==
+
 
+
バージョン4.4時点で WordPress は oEmbed 自動探知 (discovery) をサポートしていますが、ホワイトリストに登録されていないサイトから埋め込めるコンテンツの種類には厳しい制限があります。
+
 
+
具体的には、HTML および動画コンテンツはフィルタリングされ、リンク、ブロッククォート、iframe のみが許可されます。これらをさらにフィルタリングして、悪質なコンテンツの挿入を防止しています。その後、HTML はサンドボックス化され、そこへ追加のセキュリティ制限が加えられます。
+
 
+
しかし、十分に知識があり、そのような防衛策が必要ないなら、<code>unfiltered_html</code> 権限を持つユーザー(管理者と編集者)に対し、<code>&lt;head&gt;</code> に oEmbed 探知タグを持つサイトからの埋め込みを許可することはできます。[http://wordpress.org/extend/plugins/enable-oembed-discovery/ oEmbed Discovery プラグイン]を有効化するだけです。これは一般的には推奨しません。
+
 
+
「リンク」と「写真」タイプの oEmbed 探知コンテンツはこのように幅広くフィルタリングされているわけではありませんが、セキュリティのために適切にエスケープされ、悪質なコンテンツがサイトに表示されないようになっています。
+
 
+
== 外部資料 ==
+
 
+
=== 日本語記事 ===
+
* [http://webos-goodies.jp/archives/getting_started_with_oembed.html oEmbed でメディア共有サイトのコンテンツを簡単埋め込み]
+
* [https://support.google.com/youtube/answer/171780?hl=ja YouTube ヘルプ | 動画と再生リストを埋め込む]
+
 
+
=== 英語記事 ===
+
 
+
* [http://oembed.com/ oEmbed.com] -  技術的仕様を含む oEmbed 公式サイト oEmbed website with technical details of the spec
+
* [http://www.webmonkey.com/2010/02/get_started_with_oembed/ Get Started With OEmbed] - by Webmonkey.com
+
* [http://generatewp.com/oembed/ WordPress oEmbed Providers Registration Generator] - by GenerateWP.com
+
* [http://www.viper007bond.com/2009/10/13/easy-embeds-for-wordpress-2-point-9/ Easy Embeds For WordPress 2.9] - by Alex Mills (Viper007Bond)
+
 
+
== 更新履歴 ==
+
 
+
'''[[:en:Embeds#Changelog|英語版の更新履歴]]'''をご覧ください。
+
 
+
'''注:''' [[Version 3.5|WordPress 3.5]] で埋め込みオプションがメディア設定画面から削除されました。
+
 
+
{{原文|Embeds|162273}}<!-- 07:46, 24 March 2018 Typoholic01 -->
+
 
+
<!-- {{DEFAULTSORT:}}ページ名日本語にしたら書く -->
+
[[Category:上級トピック]]
+
[[en:Embeds]]
+
[[fr:Contenus Intégrés]]
+
[[hr:Ugradnje]]
+
[[it:Embed]]
+
[[nl:Insluiten]]
+
[[pt-br:Embutidos]]
+
[[ru:Вставка объектов]]
+
[[zh-cn:嵌入]]
+

2019年11月15日 (金) 16:01時点における最新版

このページは https://ja.wordpress.org/support/article/embeds/ へ移動しました。