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

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

oEmbed

提供: WordPress Codex 日本語版
2010年1月10日 (日) 15:58時点におけるBono (トーク | 投稿記録)による版 (en:Embeds 15:16, 21 December 2009 Otto42 版を翻訳用にコピー)

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索

Starting with WordPress 2.9, it's super easy to embed videos, images, and other content into your WordPress site.

In A Nutshell

All you need to do to embed something into a post or 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:

Check out this cool video:

http://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.

You can also opt to wrap the URL in the [embed] shortcode. It will accomplish the same effect, but does not require the URL to be on its own line.

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 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.

Can I Use Any URL With This?

Not by default, no. WordPress will only embed URLs matching an internal whitelist. This is for security purposes.

Okay, So What Sites Can I Embed From?

You can use all of these:

How Can I Add Support For More Websites?

Adding support for an additional website depends on whether the site supports oEmbed or not.

Adding Support For An oEmbed-Enabled Site

If a site supports oEmbed, you'll want to call wp_oembed_add_provider() to add the site and URL format to the internal whitelist.

Adding Support For A Non-oEmbed Site

You'll need to register a handler using wp_embed_register_handler() and provide a callback function that generates the HTML.

What About oEmbed Discovery?

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.

However if you feel you are knowledgeable enough to avoid this, you can give unfiltered_html users (Administrators and Editors) the ability to embed from websites that have oEmbed discovery tags in their <head>. You merely need to install this plugin.

External Resources

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

この記事は翻訳時に編集が必要であるとマークされていました。その為Codex原文が大きく編集されている可能性があります。内容を確認される際は原文を参照していただき、可能であれば本項目へ反映させてください。よりよいCodexを作成するためのお手伝いをお願いします。