set_post_thumbnail_size()


WordPressのset_post_thumbnail_size()関数は、投稿サムネイル（アイキャッチ画像）のデフォルトサイズを設定するために使用されます。

構文

set_post_thumbnail_size( int $width, int $height, bool $crop = false );

引数の説明

  • $width (int) — サムネイルの幅をピクセル単位で指定します。
  • $height (int) — サムネイルの高さをピクセル単位で指定します。
  • $crop (bool) — トリミングを有効にする場合はtrue、しない場合はfalseを指定します。デフォルトはfalseです。

例1: 固定サイズのサムネイル設定

サムネイルのサイズを幅200px、高さ150pxに設定します。

<?php set_post_thumbnail_size( 200, 150 ); ?>

例2: トリミング付きのサムネイル設定

トリミングを有効にして幅300px、高さ200pxのサムネイルを設定します。

<?php set_post_thumbnail_size( 300, 200, true ); ?>

例3: テーマのサムネイルサイズを指定

テーマのfunctions.phpファイル内でデフォルトのサムネイルサイズを設定します。

<?php
function my_theme_setup() {
    set_post_thumbnail_size( 150, 150 );
}
add_action( 'after_setup_theme', 'my_theme_setup' );
?>

例4: 条件付きでサムネイルサイズを設定

特定の投稿タイプに対して異なるサムネイルサイズを設定します。

<?php
if ( is_post_type_archive( 'custom_post_type' ) ) {
    set_post_thumbnail_size( 400, 300 );
} else {
    set_post_thumbnail_size( 200, 150 );
}
?>

例5: トリミングなしでサムネイルを設定

幅300px、高さ200pxのトリミングなしのサムネイルを設定します。

<?php set_post_thumbnail_size( 300, 200, false ); ?>

注意事項

  • set_post_thumbnail_size()を使用する場合、テーマやプラグインによる設定の競合を避けるために、適切なフックを使用してください。
  • 既存のサムネイルに変更を適用するには、画像を再生成する必要があります。プラグインRegenerate Thumbnailsを使用すると便利です。

関連機能：