image_downsize

（2.5.0以降）
image_downsize - アイキャッチ画像の縮小イメージ情報を取得する

説明

mixed image_downsize( int $id [ , mixed $size = 'medium' ] )

アイキャッチ画像の縮小イメージ情報を取得する。

$id
メディア投稿（attachment）の投稿IDを指定する。
$size
取得したいサイズ名（'thumbnail'、'post-thumbnail'、'medium'、'large'、'full'）または幅と高さの配列を指定する（省略時は'medium'）。

アイキャッチ画像の指定されたサイズのイメージ情報を配列で返す。アイキャッチ画像でない場合はfalseを返す。イメージ情報の配列内容は次の通り。

配列添え字	データタイプ	意味
0	string	縮小イメージのURL
1	int	幅（ピクセル数）
2	int	高さ（ピクセル数）
3	bool	縮小イメージの場合はtrue、オリジナルサイズの場合はfalse

標準のサイズ名とその意味は次の通り。'thumbnail'と'post-thumbnail'は正方形になり、'medium'と'large'はオリジナルの縦横比が維持される。

取得できるのはあくまで縮小イメージになり、オリジナルサイズよりも大きなサイズは取得できない。例えば、オリジナルサイズが640×480ピクセルの場合、パラメータ$sizeに'large'を指定しても取得できるのはオリジナルサイズになる。

変数$attachment_idの'medium'サイズのイメージ情報を取得する。
<?php image_downsize( $attachment_id ); ?>
変数$attachment_idの'large'サイズのイメージ情報を取得する。
<?php image_downsize( $attachment_id, 'large' ); ?>
変数$attachment_idの300×300ピクセル以下のイメージ情報を取得する。
<?php image_downsize( $attachment_id, array( 300, 300 ) ); ?>

[2.5.0]パラメータ$idがアイキャッチ画像投稿かを判定し、アイキャッチ画像投稿の場合は'image_downsize'フィルターを呼び出す。パラメータの$idと$sizeは、本関数が受け取ったパラメータの値となる。フィルター関数を使用することで独自処理後に有効な情報を返すことができる。

$out = apply_filters( 'image_downsize', false, $id, $size )

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

/wp-includes/media.php

最終更新 : 2014年07月13日 20:26

いつも何気なくfunctions.phpで使っているafter_setup_themeアクションやinitアクション。普段はあまり意識していなかったが、ふとしたことからどんな順番に呼び出されるのか気になってしまい、ちょっと調べてみた。

投稿記事にTwitterやYouTubeのURL（アドレス）を記述したとき、表示されるページにはリンクとしてではなく、埋め込んだURLの内容が表示される。この仕組み（機能）はoEmbedというもので、対応サイトは随時バージョンアップしている。

RSSフィードはデフォルトでは「全文（HTMLタグを含む）」になっているが、管理画面の「表示設定」では「抜粋のみ（HTMLタグは除外）」を選択できる。それでも投稿記事が長いと、その抜粋テキストも長くなってしまう。ここではそんなRSSフィードの抜粋テキストを調整する方法を紹介する。

時代はWP_Queryなのか（2011年8月1日更新）

WordPressのテーマ作成において、メインの投稿記事とは別に特定の条件を指定した投稿内容を表示することが多々ある。つい最近まで get_posts関数を使用することが多かったのだが、最近はWP_Queryクラスを使用することが多くなってきた。

先月末にWordPress 5.2 Beta1が、今日はWordPress 5.2 Beta2（以降5.2Beta2）が公開された。5.2ではブロックエディターの機能が強化され、サイトの安全性とパフォーマンス向上に役立つとされるサイトヘルス機能が追加される。