説明
パラメータ
- $post投稿情報(オブジェクト)または投稿IDを指定。
- $widthリクエストされた幅を指定。
返り値
投稿情報が公開済みの場合はoEmbedレスポンス情報として連想配列を返す。投稿情報が無効か、公開されていない場合はfalseを返す。キー | 内容 | 有無 |
---|---|---|
'version' | バージョン番号('1.0') | 〇 |
'provider_name' | サイト名 | 〇 |
'provider_url' | サイトのホームURL | 〇 |
'author_name' | 投稿者名(display_name) | 〇 |
'author_url' | 投稿者アーカイブURL | 〇 |
'title' | 投稿タイトル | 〇 |
'type' | レスポンスタイプ('rich'、'link'、'video'など) | 〇 |
'width' | 幅 | 〇 |
'height' | 高さ | 〇 |
'html' | 出力用のHTML | 〇 |
'thumbnail_url' | サムネイル画像のURL | 設定時のみ |
'thumbnail_width' | サムネイル画像の幅 | 設定時のみ |
'thumbnail_height' | サムネイル画像の高さ | 設定時のみ |
注意
投稿者情報が取得できなかった場合、キー'author_name'にはサイト名が、'author_url'にはサイトのホームURLが格納される。
幅の値は標準('oembed_min_max_width'フィルターで変更可能)で200~600の範囲となり、高さは幅の16:9の比率で算出された値(200未満の場合は200)となる。
キー'html'以降の内容は、標準で'oembed_response_data'フィルターとして優先度10で指定されているget_oembed_response_data_rich関数によって格納される。キー'thumbnail_url'、'thumbnail_width'、'thumbnail_height'は投稿情報にサムネイル画像が設定されている場合のみとなる。
使用例
- oEmbedレスポンス情報を取得する。<?php wp_check_for_changed_dates( $post, 600 ); ?>
フィルター
[4.4.0]幅と高さを決定する前に'oembed_min_max_width'フィルターを呼び出す。パラメータには幅の上限と下限を含んだ連想配列が格納される。$min_max_width = apply_filters( 'oembed_min_max_width', array(
'min' => 200,
'max' => 600
) );
return apply_filters( 'oembed_response_data', $data, $post, $width, $height );
アクション
実行するアクションはありません。ソースファイル
/wp-includes/embed.php最終更新 : 2018年12月07日 10:02
関連
お勧め
Login rebuilder:プラグイン作ってみました(2024年11月7日 更新)
昨年投稿した「ログインページを変える」をプラグイン化。ログインページを独自の名前のページ変更し、標準のログインページwp-login.phpを使用できないようにするプラグインです。部外者によるwp-login.phpのアクセスにお悩みの方にお勧めします。また2.0.0では「XML-RPCリクエストの管理機能」を追加。2.2.0では管理者のログイン時にメールで通知する機能を追加しました。管理画面の'アイキャッチ画像'を'写真'に変える(2013年1月23日 更新)
クライアント向けに専用のテーマを提供する際、稀に管理画面内の用語の変更を依頼されることがある。今回は、'アイキャッチ画像'だとわかりにくいので'写真'に変えてほしいということだった。カスタムフィールド関連関数のおさらい(2012年6月22日 更新)
カスタムフィールドは、投稿記事の拡張情報としてよく利用されている。投稿ページで登録した情報をアーカイブや投稿ページで表示しているが、投稿ページを表示する際にカスタムフィールドの値を更新して、サイドバーのようなページ内要素に利用したりしている。5.3への準備:投稿写真を使っているサイトは準備しておこう(2019年10月10日 更新)
この記事は先日公開した「5.3の新機能:JPEG画像の向きを調整」の続きのようなものになる。高解像度の投稿写真を扱っているサイトは、5.3のリリースに合わせて対応を検討しておくべきことをまとめてみた。
ブロックエディターで現在の「ロケール」を取得した時のメモ(2024年8月10日 更新)
ブロックエディター向けのプラグインで日本語固有の機能を実装する際、現在のロケール(言語)を取得したい。ブロックエディターの編集時、投稿を編集しているユーザーの言語が優先され、それをどうやって取得するかを「ChatGPT」に聞いてみたのだが。。。