wp_oembed_get

(2.9.0以降)
wp_oembed_get - oEmbedに対応したページの埋め込み用コンテンツを取得する

説明

mixed wp_oembed_get( string $url [ , mixed $args = '' ] )
oEmbedに対応したページの埋め込み用コンテンツを取得する。

パラメータ

  • $url
    oEmbedに対応したページのURLを指定。
  • $args
    URLへ付与するパラメータの配列を指定（省略時は''）。

返り値

URLで指定したコンテンツを取得できた場合はそのHTML文字列を返す。取得できなかった場合はfalseを返す。

注意

Twitter対応は3.4.0以降。表示用のスタイルとしてembed.cssを読み込んでいるが、これはコンテンツに含まれるwidgets.jsによって組み込まれており、サイト側で意識する必要はない。

使用例

  • ツイートの埋め込み用コンテンツを取得する。
    <?php $twit = wp_oembed_get( 'https://twitter.com/jawordpressorg/status/210582615336554497' ); ?>
    取得した$twitの内容は次の通り（ここでは多少見やすくするために改行しているが、実際の内容は改行していない）。 
    <blockquote class="twitter-tweet" width="550" lang="ja">
<p>[東京] 第3回ゼロからはじめるWordPress勉強会 <a href="http://t.co/23cDIlVx" title="http://t.co/23cDIlVx">t.co/23cDIlVx</a> <a  href="https://twitter.com/search/%2523wordpressjp">#wordpressjp</a></p>
&mdash; WordPress.org 日本語さん (@jawordpressorg) <a href="https://twitter.com/jawordpressorg/status/210582615336554497" data-datetime="2012-06-07T04:03:02+00:00">6月 7, 2012</a>
</blockquote>
<script src="//platform.twitter.com/widgets.js" charset="utf-8"></script>

フィルター

実行するフィルターはありません。

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/media.php

関連

参考

Code Reference: wp_oembed_get

お勧めコンテンツ

3.2標準テーマ「Twenty Eleven」は投稿フォーマットに着目（2011年7月6日 登録）

新テーマ「Twenty Eleven」のトップページでは、投稿フォーマットに応じて表示を切り替える仕組みが提案されている。ここでは、その投稿フォームの活用方法を簡単に紹介する。

WordPressの鼓動（2013年10月1日 登録）

WordPressでは、Ajaxを利用する方法の1つとしてadd_action関数を利用することができる。この方法を調べている過程で、'heartbeat'というおもしろそうなAjaxアクションがあったので、紹介しておく。

開発環境（Windows 8）にimagickを入れる（2012年12月23日 登録）

WordPress 3.5のイメージエディタ（WP_Image_Editor）は、GDだけでなく、imagick（ImageMagick）にも対応している。そんなわけでWindows 8の開発環境にimagickをインストールしてみた。

ホームディレクトリから過去のファイルを削除する（2013年1月27日 登録）

WordPressで構築したサイトのホームディレクトリには、現在使われていないファイルが残っている時がある。3.5.1もリリースされたことだし、これを機にホームディレクトリを整理整頓した。

Emojin：プラグイン作ってみました（2014年8月23日 登録）

ちょっと前のTLでiOSの絵文字を含んだ投稿を保存すると、絵文字以降の文章がすべて消えた状態で保存されるといったツイートを見かけた。少し検索してみると、MySQLのデータベースの文字セットが「utf8」の場合、iOSの絵文字のような4バイトの文字を正常に保存できず、それ以降の文章も保存されないというものらしい。対処方法としてデータベースの文字セットを「utf8mb4」に変更するのが有効らしいのだが、他に回避策がないか考えてみた。

最終更新日時 : 2014-11-16 17:40