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

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

「oEmbed」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(4.1でサポートされたVineを追加)
(HelpHub 転送リンクに修正。)
 
(4人の利用者による、間の11版が非表示)
1行目: 1行目:
{{Rename|E}}
+
このページは https://ja.wordpress.org/support/article/embeds/ へ移動しました。
__TOC__
+
動画・画像・ツイート・音楽などコンテンツを WordPress サイトに'''埋め込む'''(embed)のはとても簡単です。
+
 
+
== 概要 ==
+
 
+
[[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 を囲むことも可能です。表示結果は同じですが、URL を独立した行に書かなくてもよくなります。また、(固定値ではなく)最大幅・高さを以下のように設定することもできます。
+
 
+
[embed width="123" height="456"]...[/embed]
+
 
+
WordPress が URL を使ってメディアを埋め込むことができなかった場合、URL のハイパーリンクが表示されます。
+
 
+
== oEmbed ==
+
 
+
簡単なメディア埋め込み機能のほとんどは、oEmbed によって提供されています。oEmbed は、A というサイト(例えばあなたのブログ)が B というサイト(例えば YouTube)に、コンテンツ(例えば動画)を埋め込むために必要な HTML を問い合せるためのプロトコルです。
+
 
+
oEmbed は、メディアを埋め込みたいサイトから HTML コードをコピー&ペーストしたりしなくて済むように設計されています。動画、画像、テキストなどに対応しています。
+
 
+
== どんな URL でもこの機能を使えますか? ==
+
 
+
デフォルトでは限られたサイトからの URL のみに有効です。安全対策のため、WordPress は内部のホワイトリストに一致する URL のみを埋め込みます。
+
 
+
=== このメディア埋め込み機能を使えるサイトは? ===
+
 
+
以下のサイトを利用できます。
+
 
+
{| class="widefat"
+
|- style="background:#464646; color:#d7d7d7;"
+
! '''サービス'''
+
! '''埋め込みの種類'''
+
! '''追加時'''
+
|-
+
| [http://animoto.com Animoto]
+
| 動画
+
| [[Version 4.0|WordPress 4.0]]
+
|
+
|-
+
| [http://blip.tv/ Blip]
+
| 動画
+
| [[Version 2.9|WordPress 2.9]]
+
|
+
|-
+
| [http://collegehumor.com CollegeHumor]
+
| 動画
+
| [[Version 4.0|WordPress 4.0]]
+
|
+
|-
+
| [http://www.dailymotion.com/ DailyMotion]
+
| 動画
+
| [[Version 2.9|WordPress 2.9]]
+
|
+
|-
+
| [http://www.flickr.com/ Flickr]
+
| 動画 & 画像
+
| [[Version 2.9|WordPress 2.9]]
+
|
+
|-
+
| [http://www.funnyordie.com/ FunnyOrDie.com]
+
| 動画
+
| [[Version 3.0|WordPress 3.0]]
+
|
+
|-
+
| [http://www.hulu.com/ Hulu]
+
| 動画
+
| [[Version 2.9|WordPress 2.9]]
+
|
+
|-
+
| [http://imgur.com Imgur]
+
| 画像
+
| [[Version 3.9|WordPress 3.9]]
+
|
+
|-
+
| [http://instagram.com Instagram]
+
| 画像
+
| [[Version 3.5|WordPress 3.5]]
+
|
+
|-
+
| [http://www.isnare.com/ iSnare]
+
| 記事
+
| [[Version 2.9|WordPress 2.9]]
+
|
+
|-
+
| [http://issuu.com Issuu]
+
| ドキュメント
+
| [[Version 4.0|WordPress 4.0]]
+
|
+
|-
+
| [http://meetup.com Meetup.com]
+
| 各種コンテンツ
+
| [[Version 3.9|WordPress 3.9]]
+
|
+
|-
+
| [http://embedarticles.com EmbedArticles]
+
| 各種コンテンツ
+
| [[Version 3.9|WordPress 3.9]]
+
|
+
|-
+
| [http://mixcloud.com Mixcloud]
+
| 音楽
+
| [[Version 4.0|WordPress 4.0]]
+
|
+
|-
+
| [http://photobucket.com/ Photobucket]
+
| 画像
+
| [[Version 2.9|WordPress 2.9]]
+
|
+
|-
+
| [http://www.polldaddy.com/ PollDaddy]
+
| 投票・アンケート
+
| [[Version 3.0|WordPress 3.0]]
+
|
+
|-
+
| [http://www.rdio.com/ Rdio]
+
| 音楽
+
| [[Version 3.6|WordPress 3.6]]
+
|
+
|-
+
| [http://revision3.com/ Revision3]
+
| TV shows
+
| [[Version 2.9|WordPress 2.9]]
+
|
+
|-
+
| [http://www.scribd.com/ Scribd]
+
| ドキュメント
+
| [[Version 2.9|WordPress 2.9]]
+
|
+
|-
+
| [http://www.slideshare.net SlideShare]
+
| プレゼンスライド
+
| [[Version 3.5|WordPress 3.5]]
+
|
+
|-
+
| [http://www.smugmug.com/ SmugMug]
+
| 写真
+
| [[Version 3.0|WordPress 3.0]]
+
|
+
|-
+
| [http://soundcloud.com/ SoundCloud]
+
| 音楽
+
| [[Version 3.5|WordPress 3.5]]
+
|
+
|-
+
| [http://www.spotify.com/ Spotify]
+
| 音楽
+
| [[Version 3.6|WordPress 3.6]]
+
|
+
|-
+
| [http://www.ted.com/ TED]
+
| 動画
+
| [[Version 4.0|WordPress 4.0]]
+
|
+
|-
+
| [http://twitter.com Twitter]
+
| ソーシャルメディア
+
| [[Version 3.4|WordPress 3.4]]
+
|
+
|-
+
| [http://www.viddler.com/ Viddler]
+
| 動画
+
| (4.0 で非推奨)
+
|
+
|-
+
| [http://vimeo.com/ Vimeo]
+
| 動画
+
| [[Version 2.9|WordPress 2.9]]
+
|
+
|-
+
| [https://vine.co/ Vine]
+
| 動画
+
| [[Version 4.1|WordPress 4.1]]
+
|
+
|-
+
| [http://wordpress.tv/ WordPress.tv]
+
| 動画
+
| [[Version 2.9|WordPress 2.9]]
+
|
+
|-
+
| [http://www.youtube.com/ YouTube]
+
| 動画
+
| [[Version 2.9|WordPress 2.9]]
+
|
+
|}
+
 
+
'''注'''
+
* Twitter - 古いバージョンの WordPress では HTTPS 埋め込みに問題が発生することがありますが、URL を HTTP に変更すれば修正できます。
+
* YouTube - 公開済み、または限定公開の動画およびプレイリストのみに対応しています。「非公開」動画は埋め込めません。
+
 
+
== 他のサイトに対応するには? ==
+
 
+
他のサイトへの対応を追加する方法は、そのサイトが 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 プロバイダを無効化したい場合は、[[関数リファレンス/wp_oembed_add_provider|<code>wp_oembed_add_provider()</code>]]/[[:en:Function Reference/wp_oembed_add_provider|en]] を呼び出してください。
+
 
+
== oEmbed 自動探知は使えますか? ==
+
 
+
WordPress の oEmbed 実装では、自動探知は無効化されています。デフォルトでは、内部のホワイトリストに挙げられた、安全とみなされたサイトからのメディアのみを埋め込むことができます。これは、悪意のあるサイトのメディアを間違って埋め込んでしまうことがないようにするためです。
+
 
+
しかし、十分に知識があり、そのような防衛策が必要ないなら、<code>unfiltered_html</code> 権限を持つユーザー(管理者と編集者)は oEmbed 探知(ディスカバリー)タグが <code>&lt;head&gt;</code> にあるすべてのサイトからのメディアを埋め込むようにもできます。これには、[http://wordpress.org/extend/plugins/enable-oembed-discovery/ Enable oEmbed Discovery] プラグインを使うだけです。
+
 
+
== 外部資料 ==
+
 
+
=== 日本語記事 ===
+
* [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://bono.s206.xrea.com/2010/01/1017-wp29/ power source* » WP: WordPress 2.9 新機能・仕様変更まとめ] - <code>[embed]</code> ショートコードで利用できるパラメータ
+
 
+
=== 英語記事 ===
+
* [http://www.wpbeginner.com/wp-themes/how-to-set-oembed-max-width-in-wordpress-3-5-with-content_width/ How do I resize my oEmbeds?] <tt>$content_width</tt> 値の設定方法の説明
+
* [http://www.viper007bond.com/2009/10/13/easy-embeds-for-wordpress-2-point-9/ Summary of this feature] - コード作者による機能のまとめ
+
* [http://www.webmonkey.com/2010/02/get_started_with_oembed/ Webmonkey guide to oEmbed]
+
* [http://oembed.com/ Official oEmbed website] - oEmbed の技術的仕様
+
* [http://web-profile.com.ua/wordpress/useful/embed-video-into-post/ Other ways to insert video into post on WordPress site]
+
* [http://yoast.com/wordpress/video-seo/ Video SEO Plugin] - 埋め込まれた動画を自動的に検知し、動画 XML サイトマップを追加するプラグイン
+
* [http://wordpress.org/plugins/simple-youtube-embed/ Simple YouTube Embed Plugin] YouTube を (embedded by URLでの埋め込み もしくは ショートコード埋め込みで) レスポンシブで美しい見た目で埋め込む。
+
 
+
== 更新履歴 ==
+
 
+
* [[Version 2.9|2.9]] :
+
** ビルトイン埋め込みに対応。
+
* [[Version 3.0|3.0]] :
+
** SmugMug と FunnyOrDie.com に対応。
+
* [[Version 3.4|3.4]] :
+
** Twitter を追加。
+
* [[Version 3.5|3.5]] :
+
** Instagram、SoundCloud、SlideShare を追加。
+
* [[Version 3.6|3.6]] :
+
** Rdio、Spotify を追加。
+
* [[Version 3.9|3.9]] :
+
** Qik サービスが2014年4月に終了したため対応削除。
+
* [[Version 4.0|4.0]] :
+
** Major reworking of the preview code showing embeds within the editor wp-views.
+
** Added: CollegeHumor, Issuu, Mixcloud, YouTube playlists, TED talks
+
** Removed: Viddler (removed due to the service shutting down their oEmbed endpoint)
+
 
+
'''注:''' [[Version 3.5|WordPress 3.5]] で埋め込みオプションがメディア設定画面から削除されました。
+
 
+
{{Stub}}
+
 
+
{{原文|Embeds|144013}}<!-- 2014-09-18T06:51:10 DrewAPicture -->
+
 
+
<!-- {{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/ へ移動しました。