関数リファレンス/image downsize

説明

画像の大きさを特定のもの ('thumb' や 'medium'等) へフィットさせる関数です。

予約語の$max_/$min_width は常に管理画面の「設定」→「メディア」で定義されたものです。これについては、image_constrain_size_for_editor() に詳しく書かれています。

パラメータ

$id

（integer） （必須） 画像のID

初期値： なし

$size

（string） （optional） 画像のサイズ。 thumbnail または medium 。

初期値： medium

戻り値

失敗の場合は False を、成功の場合は文字列を返します。文字列は画像のURL、幅、高さ、中間サイズであるか否か ($is_intermediate) の順番で構成されます。もし画像のURLがリサイズされたモノであった場合、 $is_intermediate が true に、オリジナルサイズの場合は false になります。

ソースファイル

image_downsize() is located in wp-includes/media.php.

用例

中サイズの添付画像を選択する機能

wp_get_attachment_thumb_url(); についてすでにご存知かと思います。ここでは中サイズの添付画像を選択するにはどうすればよいのかをお見せしましょう。

function wp_get_attachment_medium_url( $id )
{
    $medium_array = image_downsize( $id, 'medium' );
    $medium_path = $medium_array[0];

    return $medium_path;
}

$id は添付のIDです。

WP-Choose-Thumbのようなプラグインには便利な機能です。この機能を用いれば、中サイズのプレビューを得ることが出来るでしょう。

最新英語版： WordPress Codex » Function Reference/image downsize （最新版との差分）

関数リファレンス、テンプレートタグ目次もご覧ください。