2024年06月14日

WP関数:set_post_thumbnail_size()


この関数の説明

WP関数の set_post_thumbnail_size() は、アイキャッチ画像のデフォルトの画像サイズを指定する関数です。

 


関数

set_post_thumbnail_size( $width, $height, $crop )

 


パラメータ

$width(整数) (オプション)

アイキャッチ画像の幅。単位はピクセル。

初期値: 0

 

$height(整数) (オプション)

アイキャッチ画像の高さ。単位はピクセル。

初期値: 0

 

$crop(真偽値 | 配列) (オプション)

画像を切り出すかどうか。

false : 切り出さなくて縦横比を維持して縮小します(デフォルト)

true  : 指定した幅と高さで切り出します。

また、trueではなく、配列で切り出す位置を指定する事ができます。

例えば array( 'top', 'left' ) のように指定すると、左上から指定した幅と高さで切り出します。

 


事例

①functions.phpの中にアイキャッチ画像のONとデフォルトサムネールサイズの設定を行う

function add_thumbnails() {
	add_theme_support( 'post-thumbnails' );	// アイキャッチ画像のON
	set_post_thumbnail_size( 150, 150 );		    // デフォルトサムネールサイズの設定
	}
add_action( 'after_setup_theme', 'add_thumbnails' );

 


参考情報

この関数でサムネールサイズを変更しても、設定済みのアイキャッチ画像の大きさは変わりません。

設定済みの画像を再生成するには「Regenerate Thumbnails」 などのプラグインを使います。

 


アクションフック&関数
  • admin_init
  • admin_menu
  • after_setup_theme
  • customize_register
  • manage_pages_custom_column
  • manage_posts_custom_column
  • pre_get_posts
  • save_post
  • widgets_init
  • wp_enqueue_scripts
  • wp_head
  • add_editor_style()
  • add_post_type_support()
  • add_theme_support()
  • do_action()
  • get_post()
  • get_theme_mod()
  • register_nav_menu()
  • register_post_type()
  • register_sidebar()
  • register_taxonomy()
  • register_widget()
  • remove_action()
  • remove_editor_styles()
  • remove_theme_support()
  • set_post_thumbnail_size()
  • set_query_var()
  • show_admin_bar()
  • unregister_nav_menu()
  • unregister_widget()
  • wp_enqueue_script()
  • wp_enqueue_style()