acf_get_image_sizes()


Advanced Custom Fields (ACF) の関数 acf_get_image_sizes() は、WordPress サイトに登録されているすべての画像サイズのリストを取得するために使用されます。

シンタックス

acf_get_image_sizes();

この関数の主な特徴

  • 登録されたすべての画像サイズを配列として返します。
  • 画像サイズ名をキーとして、対応する詳細情報(幅、高さ、切り抜き設定など)を含みます。

例 1: サイトに登録されているすべての画像サイズを取得

この例では、登録されている画像サイズを取得し、それぞれのサイズ名を表示します。

<?php
$image_sizes = acf_get_image_sizes();
foreach ( $image_sizes as $size => $details ) {
    echo $size . '<br>';
}
?>

例 2: 画像サイズの詳細情報を表示

登録された画像サイズの幅、高さ、切り抜き設定を表示します。

<?php
$image_sizes = acf_get_image_sizes();
foreach ( $image_sizes as $size => $details ) {
    echo $size . ': ' . $details['width'] . 'x' . $details['height'] . ', crop: ' . ( $details['crop'] ? 'true' : 'false' ) . '<br>';
}
?>

例 3: 特定の画像サイズが存在するか確認

このコードは、特定の画像サイズが登録されているかを確認します。

<?php
$image_sizes = acf_get_image_sizes();
if ( array_key_exists( 'thumbnail', $image_sizes ) ) {
    echo 'Thumbnail サイズが登録されています。';
}
?>

例 4: サイトの画像サイズを JSON フォーマットで出力

画像サイズを JSON フォーマットでエクスポートする場合の例です。

<?php
$image_sizes = acf_get_image_sizes();
echo json_encode( $image_sizes );
?>

例 5: 特定の画像サイズの幅と高さを取得

特定の画像サイズの幅と高さを取得する方法です。

<?php
$image_sizes = acf_get_image_sizes();
if ( isset( $image_sizes['medium'] ) ) {
    $medium_size = $image_sizes['medium'];
    echo 'Medium サイズ: 幅 ' . $medium_size['width'] . 'px, 高さ ' . $medium_size['height'] . 'px';
}
?>

注意点

  • acf_get_image_sizes() は、ACF プラグインがインストールされている場合にのみ使用可能です。
  • 画像サイズの変更は、WordPress 管理画面の「設定」またはカスタムコードを使用して行う必要があります。