メディア・画像の記事一覧|WordPressの専門家が作る教科書 https://wordpress.ks-product.com WordPressを活用したウェブサイトの制作方法を教えます Thu, 08 Oct 2026 14:27:53 +0000 ja hourly 1 https://wordpress.org/?v=7.1.5 アイキャッチ画像をコードで設定する方法|取り込みと set_post_thumbnail https://wordpress.ks-product.com/3063/ Mon, 05 Oct 2026 15:16:00 +0000 https://wordpress.ks-product.com/3063/ 結論

画像を取り込んでアイキャッチにする流れは、3段階です。

  1. 画像をメディアライブラリに登録して、添付ファイルIDを得る。
  2. set_post_thumbnail( $post_id, $attachment_id ) でアイキャッチに設定する(内部では _thumbnail_id というメタが保存される)。
  3. 表示側で has_post_thumbnail() と the_post_thumbnail() を使う。

1 の方法は、入力元で選びます。

入力元 使う関数 備考
フォームからのアップロード($_FILES) media_handle_upload() multipart/form-data の form が必要
サーバー上の一時ファイルや、配列で渡せるファイル media_handle_sideload() name と tmp_name を持つ配列
外部 URL の画像 media_sideload_image() 戻り値の形式を id にできる

フロントエンドや CLI から使う場合は、wp-admin/includes/ の3ファイル(file.php、image.php、media.php)の読み込みが必要です。

原因・仕組み

公式リファレンスによると、media_handle_upload() は $_FILES の指定キーのファイルを処理して添付ファイルを作り、成功時は添付ファイルID、失敗時は WP_Error を返します。第2引数は親投稿のID(未添付なら 0)です。media_sideload_image() は URL を受け取り、第4引数で html、src、id のいずれかを返せます。失敗時は WP_Error です。いずれも、フロントエンドで使う前に上記3ファイルを読み込みます。

どの関数も、WordPress が許可する MIME タイプ・拡張子のチェックを通ります。許可されないファイルは WP_Error になるため、任意の PHP ファイルなどはアップロードできません。

手順(サンプルコード)

ファイル配列を受け取って取り込み、アイキャッチに設定する関数です。

function ks_set_featured_from_file( $post_id, array $file ) {
    require_once ABSPATH . 'wp-admin/includes/image.php';
    require_once ABSPATH . 'wp-admin/includes/file.php';
    require_once ABSPATH . 'wp-admin/includes/media.php';

    if ( ! current_user_can( 'edit_post', $post_id ) ) {
        return new WP_Error( 'ks_cap', '権限がありません' );
    }
    $attachment_id = media_handle_sideload( $file, $post_id, null, array( 'post_title' => 'ks featured' ) );
    if ( is_wp_error( $attachment_id ) ) {
        return $attachment_id;
    }
    if ( ! set_post_thumbnail( $post_id, $attachment_id ) ) {
        return new WP_Error( 'ks_thumb', 'アイキャッチを設定できませんでした' );
    }
    return $attachment_id;
}

フォームから受け取る場合は、$_FILES['ks_image'] を使い、media_handle_upload( 'ks_image', $post_id ) を呼びます。このとき nonce の検証と、current_user_can( 'upload_files' ) などの権限確認を行ってください。

// フォーム側(nonce 付き)
// <form method="post" enctype="multipart/form-data"> ... wp_nonce_field( 'ks_upload', 'ks_nonce' ) ... </form>
if ( isset( $_POST['ks_nonce'] ) && wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['ks_nonce'] ) ), 'ks_upload' ) && current_user_can( 'upload_files' ) && current_user_can( 'edit_post', $post_id ) ) {
    $id = media_handle_upload( 'ks_image', $post_id );
}

動作確認(検証環境と結果)

WordPress 7.1.2、PHP 8.2.12(GD 拡張を有効化)、MariaDB 10.4.32 で、上の関数を実行しました(php -d extension=gd run.php featured-image-set-by-code.php)。

  • 設定前の has_post_thumbnail() は false、設定後は true。
  • get_post_thumbnail_id() と、メタ _thumbnail_id の値が、取り込んだ添付ファイルIDと一致した。
  • get_the_post_thumbnail_url( $post_id, 'full' ) は、.../uploads/2026/10/feat.png を返した。get_the_post_thumbnail( $post_id, 'medium' ) は、feat-300x225.png を指す img タグ(wp-post-image クラス付き)を返した。
  • 拡張子 .php のファイルを渡すと、「このファイルタイプをアップロードする権限がありません。」の WP_Error になり、受理されなかった。

media_handle_upload() の実フォーム経由の動作($_FILES は CLI では再現できない)と、media_sideload_image() による外部 URL からの取得は、この環境では実行しておらず、未検証です。公式リファレンスの記載に基づいて記述しています。

アイキャッチ画像をコードで設定する方法の注意点

  • 外部 URL から取り込む場合、URL が信頼できるものか確認します。ユーザー入力の URL をそのまま渡すと、意図しない通信の原因になります。
  • 大量の画像を一括で取り込むと、タイムアウトします。WP-CLI や、分割処理を使います。
  • set_post_thumbnail() は、投稿タイプが thumbnail をサポートしていないと、表示側で使えません。
  • 公式リファレンスによると、set_post_thumbnail() は、失敗時だけでなく、すでに同じIDが設定済みのときも false を返します。上のコードのように false をエラー扱いにすると、再実行時に誤って失敗と判定されるため、必要なら get_post_thumbnail_id() で先に確認します。true や初回のメタIDなど、成功時の戻り値は一定でないことにも注意してください。`n- 取り込んだ画像のサイズ別ファイルは、そのときに登録されているサイズで作られます(add_image_size が反映されない原因と再生成)。
  • 画像の alt は、update_post_meta( $id, '_wp_attachment_image_alt', $text ) で設定できます。

アイキャッチ画像をコードで設定する方法でよくあるミス

  • wp-admin/includes/ の3ファイルを読み込まず、「undefined function」の致命的エラーになる。
  • $_FILES のキー名と、media_handle_upload() に渡す名前が一致していない。
  • form に enctype="multipart/form-data" が無く、$_FILES が空。
  • 戻り値の WP_Error を確認せずに、そのまま set_post_thumbnail() に渡す。
  • nonce と権限の確認を省略する。

アイキャッチ画像をコードで設定する方法のチェックリスト

  • 3つの include を入れたか。
  • 戻り値を is_wp_error() で確認したか。
  • nonce と権限(upload_files、edit_post)を確認したか。
  • 投稿タイプが thumbnail をサポートしているか。
  • 取り込み後、メディアライブラリと表示を確認したか。

アイキャッチ画像をコードで設定する方法のFAQ(よくある質問)

Q. 既存のメディアを、別の投稿のアイキャッチにするには?
A. 取り込みは不要です。添付ファイルIDで set_post_thumbnail() を呼びます(set_post_thumbnail() の使い方|説明・引数・注意点)。

Q. アイキャッチを外すには?
A. delete_post_thumbnail( $post_id ) を使います。本検証では実行していません。

Q. 取り込みに失敗する理由は?
A. ファイル種別の制限、容量、権限、ディスク容量などが考えられます。WP_Error のメッセージを確認してください。

筆者の見解(アイキャッチ画像をコードで設定する方法)

画像の取り込み処理は、成功のコードより、失敗時の扱いに品質の差が出ると考えます。WP_Error をログに残し、ユーザーには簡潔なメッセージを返す設計にしておくと、運用中の原因調査が楽になります。また、権限とnonce は、アップロード系の処理では最初に書くべき部分だと思います。

アイキャッチ画像をコードで設定する方法の関連項目

出典(一次情報)

]]>
add_image_size を追加しても反映されない原因と対処|サムネイル再生成の方法 https://wordpress.ks-product.com/3062/ Mon, 05 Oct 2026 15:15:00 +0000 https://wordpress.ks-product.com/3062/ 結論

add_image_size() で追加したサイズの画像ファイルは、画像を「アップロードしたとき」に生成されます。すでにアップロード済みの画像には、新しいサイズのファイルは作られません。反映させるには、既存画像のサムネイルを再生成します。

  • WP-CLI が使える: wp media regenerate --yes(特定サイズだけなら --image_size=ks_card)
  • 管理画面で行いたい: 再生成系のプラグインを使う
  • コードで行いたい: wp_generate_attachment_metadata() と wp_update_attachment_metadata() を呼ぶ

公式リファレンスにも、新しいカスタムサイズには既存画像の再生成が必要で、WP-CLI の wp media regenerate や再生成プラグインを使うよう記載されています。また、元画像と同じかそれより小さいサイズは作られない、削除したサイズの既存ファイルは自動で消えない、という注意もあります。

原因・仕組み

画像をアップロードすると、WordPress は登録済みの画像サイズごとにファイルを作り、その情報を添付ファイルのメタデータ(_wp_attachment_metadata)に保存します。add_image_size() は「今後作るサイズの登録」であり、既存のメタデータを書き換えません。そのため、既存画像で ks_card を要求すると、該当ファイルがなく、元のサイズの画像が返ります。

$crop の指定は、false(比例縮小)、true(中央から切り抜き)、array( 'left', 'top' ) のような位置指定の3種類です。false だと、指定した幅と高さに収まるように縮小され、指定した寸法ぴったりにならないことがあります。

手順(サンプルコード)

// functions.php または、after_setup_theme で登録
add_action( 'after_setup_theme', function () {
    add_theme_support( 'post-thumbnails' );
    add_image_size( 'ks_card', 400, 300, true ); // 400x300 に切り抜き
} );

// 1枚だけコードで再生成する例(管理者のみ実行する処理に組み込む)
function ks_regenerate_one( $attachment_id ) {
    require_once ABSPATH . 'wp-admin/includes/image.php';
    $file = get_attached_file( $attachment_id );
    if ( ! $file || ! file_exists( $file ) ) {
        return new WP_Error( 'ks_nofile', '元ファイルがありません' );
    }
    $meta = wp_generate_attachment_metadata( $attachment_id, $file );
    if ( empty( $meta ) ) {
        return new WP_Error( 'ks_nometa', 'メタデータを生成できませんでした' );
    }
    wp_update_attachment_metadata( $attachment_id, $meta );
    return true;
}

表示は、wp_get_attachment_image_src( $id, 'ks_card' ) で [ URL, 幅, 高さ, 中間サイズ(リサイズ済み)の画像かどうか ] が得られます(4番目は公式リファレンスの is_intermediate。切り抜きの有無ではありません)。投稿のアイキャッチなら the_post_thumbnail( 'ks_card' ) です(wp_get_attachment_image_src() の使い方|説明・引数・注意点)。

動作確認(検証環境と結果)

WordPress 7.1.2、PHP 8.2.12(GD 拡張を有効化: php -d extension=gd run.php ...)、MariaDB 10.4.32 で実行しました。1200×800 の JPEG を media_handle_sideload() で取り込んで検証しています(ログは tests フォルダ)。

  • アップロード直後の sizes: medium(300x200)、large(1024x683)、thumbnail(150x150)、medium_large(768x512)。
  • add_image_size( 'ks_card', 400, 300, true ) を呼んだ直後: sizes に変化なし。
  • この時点で wp_get_attachment_image_src( $id, 'ks_card' ) を呼ぶと、元画像のURLと 400x267(元画像の比率で縮小した値)、4番目の値は false が返った。
  • wp_generate_attachment_metadata() と wp_update_attachment_metadata() で再生成すると、sizes に ks_card(400x300) が追加され、同じ呼び出しで ...-400x300.jpg、400x300、4番目の値は true になった。
  • 元画像(1200×800)より大きい ks_huge(3000×2000)を追加して再生成しても、sizes に追加されなかった。

WP-CLI の wp media regenerate と、再生成プラグインは、この環境では実行していません。

add_image_size を追加しても反映されないときの注意点

  • 再生成は、画像枚数が多いと時間とサーバー負荷がかかります。バックアップを取り、アクセスの少ない時間帯に、WP-CLI で実行するのが安全です。
  • 再生成しても、古い名前のサイズのファイルは削除されません。ディスクを整理したい場合は、専用の処理が必要です。
  • 画像サイズ名は、他のプラグインと重複しないよう接頭辞を付けます。
  • 比率の異なる画像を crop = true で切り抜くと、被写体が切れることがあります。位置指定の配列で調整します。
  • 管理画面のメディア選択肢にサイズ名を出したい場合は、image_size_names_choose フィルターを使います(本検証では実行していません)。

add_image_size を追加しても反映されない原因と対処でよくあるミス

  • add_image_size() を追加しただけで、既存の記事の画像が変わると期待する。
  • 元画像が小さく、指定サイズ以上のファイルが作られないことに気づかない。
  • 実際のテンプレートが別のサイズ名('large' など)を指していて、追加したサイズを使っていない。
  • add_theme_support( 'post-thumbnails' ) を忘れ、アイキャッチ自体が使えない。
  • 再生成前にバックアップを取らない。

add_image_size を追加しても反映されない原因と対処のチェックリスト

  • サイトの画像が、再生成の対象か。
  • 追加したサイズ名とテンプレートの指定が一致しているか。
  • 元画像が指定サイズより大きいか。
  • バックアップを取ったか。
  • 再生成後、表示とファイル(wp-content/uploads)を確認したか。

add_image_size を追加しても反映されない原因と対処のFAQ(よくある質問)

Q. 再生成すると、画像の URL は変わりますか。
A. 元画像の URL は変わりません。サイズ別のファイル名(-400x300 が付くもの)が増えます。本文に埋め込み済みの画像は、再生成だけでは差し替わらない場合があります。

Q. サイズを削除するには?
A. remove_image_size() で今後の生成を止められます(remove_image_size() の使い方|説明・引数・注意点)。既存ファイルは別途削除が必要です。

Q. 画像が荒く見えます。
A. 表示サイズより小さいファイルが使われている可能性があります。Retina 向けには、2倍のサイズも用意します。

筆者の見解(add_image_size を追加しても反映されない原因と対処)

画像サイズの追加は、デザイン変更の中でもよく起きる作業であり、「再生成が必要」という点は事前に見積もりに入れておくべきだと考えます。サイトの規模が大きい場合は、再生成を後回しにして、新しい画像から先に反映する運用も選択肢です。私見では、サイズ名はデザインの用途(card、hero など)で付けると、あとから見直しやすいです。

add_image_size を追加しても反映されない原因と対処の関連項目

出典(一次情報)

]]>
get_allowed_mime_types() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/2936/ https://wordpress.ks-product.com/2936/#respond Sat, 03 Oct 2026 12:29:16 +0000 https://wordpress.ks-product.com/?p=2936 説明

get_allowed_mime_types() は、アップロードできるファイルの種類(拡張子とMIMEタイプ)の一覧を取得する関数です。

基本構文

get_allowed_mime_types( int|WP_User $user = null ): string[]

引数

  • $user:ユーザーのIDまたはオブジェクト(省略すると、現在のユーザー)

戻り値

「拡張子(正規表現)=> MIMEタイプ」の配列。

使い方(サンプル)

$mimes = get_allowed_mime_types();
if ( isset( $mimes['pdf'] ) ) {
	// PDFが許可されている
}

注意点

  • 配列のキーは、jpg|jpeg|jpe のように、複数の拡張子を、正規表現で並べた形です。
  • 一覧は、upload_mimes フィルターで変更できます。

実務での使いどころ

  • アップロードを受け付ける前に、許可された種類かを、確認するとき。
  • 許可されている種類の一覧を、画面に表示するとき。

よくあるミスと対策

  • 配列のキーを、1つの拡張子だと考えている(jpg|jpeg|jpe の形)。
  • 一覧を、自分で決め打ちしている。

NG例

if ( isset( $mimes['jpg'] ) ) { // キーは jpg|jpeg|jpe のため、一致しない
	// ...
}

OK例

$type = wp_check_filetype( $name, get_allowed_mime_types() );
if ( $type['type'] ) {
	// 許可された種類
}

使い分け早見表

関数 役割
get_allowed_mime_types() 許可された種類の一覧を、返す
wp_check_filetype() ファイル名から、MIMEタイプを判定する
upload_mimes 許可する種類を、変更するフィルター

関連項目

wp_check_filetype()、wp_handle_upload()

公式リファレンス:get_allowed_mime_types() | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/2936/feed/ 0
wp_get_audio_extensions() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/2934/ https://wordpress.ks-product.com/2934/#respond Sat, 03 Oct 2026 12:29:14 +0000 https://wordpress.ks-product.com/?p=2934 説明

wp_get_audio_extensions() は、WordPressが音声として扱う、拡張子の一覧を取得する関数です。

基本構文

wp_get_audio_extensions(): string[]

引数

引数はありません。

戻り値

拡張子の配列。

使い方(サンプル)

$ext = strtolower( pathinfo( $file, PATHINFO_EXTENSION ) );
if ( in_array( $ext, wp_get_audio_extensions(), true ) ) {
	// 音声ファイル
}

注意点

  • 一覧は、wp_audio_extensions フィルターで変更されることがあります。
  • 動画の拡張子は、wp_get_video_extensions()。

実務での使いどころ

  • アップロードされたファイルが、音声かを、拡張子で判断するとき。

よくあるミスと対策

  • 一覧を、自分で決め打ちしている。
  • 拡張子だけで、音声かどうかを判断している。

NG例

if ( in_array( $ext, array( 'mp3', 'wav' ), true ) ) { // 一覧を、決め打ちしている
	// ...
}

OK例

if ( in_array( $ext, wp_get_audio_extensions(), true ) ) {
	// ...
}

使い分け早見表

関数 返すもの
wp_get_audio_extensions() 音声の拡張子の一覧
wp_get_video_extensions() 動画の拡張子の一覧
wp_check_filetype() 拡張子から、MIMEタイプを判定する

関連項目

wp_get_video_extensions()、wp_check_filetype()

公式リファレンス:wp_get_audio_extensions() | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/2934/feed/ 0
wp_get_video_extensions() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/333/ https://wordpress.ks-product.com/333/#respond Fri, 02 Oct 2026 15:49:15 +0000 https://wordpress.ks-product.com/333/ 説明

wp_get_video_extensions() は、WordPressが対応している動画の拡張子一覧を返す関数です。

基本構文

wp_get_video_extensions(): string[]

引数

引数はありません。

戻り値

拡張子の配列。

使い方(サンプル)

$exts = wp_get_video_extensions();

注意点

  • フィルターで拡張子を追加できます。

実務での使いどころ

  • 動画として扱える、拡張子の一覧を取得するとき。
  • アップロードされた動画ファイルの、拡張子を確認するとき。

よくあるミスと対策

  • 一覧が、固定だと考えている。wp_video_extensions フィルターで、変更されることがある。
  • ファイル名の拡張子だけで、動画かどうかを判断している。
  • 一覧にない拡張子の動画を、アップロードできると考えている。

NG例

if ( in_array( $ext, array( 'mp4', 'mov' ), true ) ) { // 一覧を、自分で決め打ちしている
	// ...
}

OK例

$ext = strtolower( pathinfo( $file, PATHINFO_EXTENSION ) );
if ( in_array( $ext, wp_get_video_extensions(), true ) ) {
	// WordPressが動画として扱う拡張子
}

使い分け早見表

やりたいこと 使うもの
動画の拡張子の一覧 wp_get_video_extensions()
拡張子から、MIMEタイプを判定 wp_check_filetype()
画像の中身から、MIMEタイプを判定 wp_get_image_mime()

関連項目

wp_get_audio_extensions()、wp_check_filetype()

公式リファレンス:wp_get_video_extensions() | Function | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/333/feed/ 0
wp_prepare_attachment_for_js() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/332/ https://wordpress.ks-product.com/332/#respond Fri, 02 Oct 2026 15:49:14 +0000 https://wordpress.ks-product.com/332/ 説明

wp_prepare_attachment_for_js() は、添付ファイルのデータを、メディアモーダル用のJavaScriptデータに整形する関数です。

基本構文

wp_prepare_attachment_for_js( int|WP_Post $attachment ): array|void

引数

  • $attachment:添付ファイルのIDまたはオブジェクト

戻り値

JS向けのデータ配列。

使い方(サンプル)

$data = wp_prepare_attachment_for_js( 45 );

注意点

  • 管理画面で独自のメディア選択UIを作るときに使われます。

実務での使いどころ

  • メディアライブラリの画面(wp.media)が使う形式の、データを用意するとき。
  • 独自のメディア選択画面に、添付ファイルの情報をJavaScriptへ渡すとき。

よくあるミスと対策

  • 添付ファイルでない投稿のIDを渡している。何も返らない。
  • 返る配列の項目を、確認せずに使っている。バージョンやファイルの種類によって、項目が違う。

NG例

$data = wp_prepare_attachment_for_js( $post_id ); // 添付ファイルでない投稿のIDで、何も返らない

OK例

$data = wp_prepare_attachment_for_js( $attachment_id );
if ( $data ) {
	wp_send_json_success( $data );
}

使い分け早見表

関数 役割
wp_prepare_attachment_for_js() JavaScript用に整えた、メディアのデータを返す
wp_get_attachment_metadata() メディアのメタデータを返す
wp_get_attachment_url() メディアのURLを返す

関連項目

wp_enqueue_media()、wp_get_attachment_url()

公式リファレンス:wp_prepare_attachment_for_js() | Function | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/332/feed/ 0
wp_get_attachment_thumb_url() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/331/ https://wordpress.ks-product.com/331/#respond Fri, 02 Oct 2026 15:49:12 +0000 https://wordpress.ks-product.com/331/ 説明

wp_get_attachment_thumb_url() は、添付画像のサムネイルURLを返す関数です(非推奨)。

基本構文

wp_get_attachment_thumb_url( int $post_id = 0 ): string|false

引数

  • $post_id:添付ファイルのID

戻り値

サムネイルのURL。

使い方(サンプル)

// 代わりにこちらを使う
$img = wp_get_attachment_image_src( 45, 'thumbnail' );

注意点

  • 非推奨ではないが、サイズを選べない。wp_get_attachment_image_src() や wp_get_attachment_image_url() を使うのが、一般的。

実務での使いどころ

  • メディアの、サムネイルのURLを取得するとき。

よくあるミスと対策

  • サイズが thumbnail に固定される。別のサイズが欲しいときは、wp_get_attachment_image_src() を使う。
  • サムネイルがないときは、フルサイズのURLが返る。false になるのは、添付ファイルがないなど、URLを取得できないとき。

NG例

echo wp_get_attachment_thumb_url( $id ); // サイズを選べず、false のときも出力される

OK例

$src = wp_get_attachment_image_src( $id, 'medium' );
if ( $src ) {
	echo esc_url( $src[0] );
}

使い分け早見表

やりたいこと 使うもの
サムネイルのURL wp_get_attachment_thumb_url()
サイズを指定したURL wp_get_attachment_image_src()
元のファイルのURL wp_get_attachment_url()

関連項目

wp_get_attachment_image_src()

公式リファレンス:wp_get_attachment_thumb_url() | Function | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/331/feed/ 0
get_the_post_thumbnail_caption() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/330/ https://wordpress.ks-product.com/330/#respond Fri, 02 Oct 2026 15:49:11 +0000 https://wordpress.ks-product.com/330/ 説明

get_the_post_thumbnail_caption() は、アイキャッチ画像のキャプションを返す関数です。

基本構文

get_the_post_thumbnail_caption( int|WP_Post $post = null ): string

引数

  • $post:投稿IDまたはオブジェクト

戻り値

キャプションの文字列。

使い方(サンプル)

echo esc_html( get_the_post_thumbnail_caption() );

注意点

  • キャプションが未設定の場合は空文字です。

実務での使いどころ

  • アイキャッチ画像の「キャプション」を取得して、表示するとき。

よくあるミスと対策

  • キャプションが未入力のとき、空文字が返る。確認せずに、空の枠を出力する。
  • 出力するときに、エスケープしていない。
  • アイキャッチ画像でないメディアのキャプションなら、wp_get_attachment_caption() を使う。

NG例

echo '<figcaption>' . get_the_post_thumbnail_caption() . '</figcaption>'; // 空のときも枠が出る

OK例

$caption = get_the_post_thumbnail_caption();
if ( $caption ) {
	echo '<figcaption>' . esc_html( $caption ) . '</figcaption>';
}

使い分け早見表

関数 対象
get_the_post_thumbnail_caption() アイキャッチ画像のキャプション
wp_get_attachment_caption() 指定したメディアのキャプション
the_post_thumbnail() アイキャッチ画像を出力する

関連項目

wp_get_attachment_caption()、get_the_post_thumbnail()

公式リファレンス:get_the_post_thumbnail_caption() | Function | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/330/feed/ 0
wp_get_attachment_caption() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/329/ https://wordpress.ks-product.com/329/#respond Fri, 02 Oct 2026 15:49:10 +0000 https://wordpress.ks-product.com/329/ 説明

wp_get_attachment_caption() は、添付ファイルのキャプションを返す関数です。

基本構文

wp_get_attachment_caption( int $post_id = 0 ): string|false

引数

  • $post_id:添付ファイルのID

戻り値

キャプション。なければ空文字。

使い方(サンプル)

echo esc_html( wp_get_attachment_caption( 45 ) );

注意点

  • アイキャッチ画像のキャプションは get_the_post_thumbnail_caption() でも取得できます。

実務での使いどころ

  • メディアの「キャプション」を取得して、画像の下に表示するとき。

よくあるミスと対策

  • キャプションが未入力のとき、空文字が返る。確認せずに、空の枠を出力する。
  • 出力するときに、エスケープしていない。
  • アイキャッチ画像のキャプションなら、get_the_post_thumbnail_caption() が簡単。

NG例

echo '<figcaption>' . wp_get_attachment_caption( $id ) . '</figcaption>'; // 空のときも枠が出る。エスケープがない

OK例

$caption = wp_get_attachment_caption( $id );
if ( $caption ) {
	echo '<figcaption>' . esc_html( $caption ) . '</figcaption>';
}

使い分け早見表

関数 対象
wp_get_attachment_caption() 指定したメディアのキャプション
get_the_post_thumbnail_caption() アイキャッチ画像のキャプション
wp_get_attachment_image() imgタグのHTML

関連項目

wp_get_attachment_image()、get_the_post_thumbnail()、get_the_post_thumbnail_caption()

公式リファレンス:wp_get_attachment_caption() | Function | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/329/feed/ 0
wp_check_filetype() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/328/ https://wordpress.ks-product.com/328/#respond Fri, 02 Oct 2026 15:49:08 +0000 https://wordpress.ks-product.com/328/ 説明

wp_check_filetype() は、ファイル名の拡張子から、MIMEタイプを調べる関数です。

基本構文

wp_check_filetype( string $filename, string[] $mimes = null ): array

引数

  • $filename:ファイル名
  • $mimes:許可するMIMEタイプの連想配列

戻り値

ext と type を含む配列。

使い方(サンプル)

$info = wp_check_filetype( 'photo.jpg' );
var_dump( $info['type'] );

注意点

  • 拡張子ベースの簡易判定です。ファイルの中身までは検証しません。

実務での使いどころ

  • ファイル名の拡張子から、許可されたMIMEタイプかを判定するとき。
  • アップロードの前に、拡張子が許可されているかを確認するとき。

よくあるミスと対策

  • ファイル名の拡張子だけで判定している。拡張子は偽装できる。アップロードされたファイルの検証には、中身も確認する(wp_check_filetype_and_ext() や wp_get_image_mime())。
  • 許可されていない拡張子では、ext と type が false になる。確認せずに使う。

NG例

$type = wp_check_filetype( $name );
echo $type['type']; // 拡張子が許可されていないと false

OK例

$type = wp_check_filetype( $name );
if ( $type['type'] ) {
	// 許可された拡張子
}

使い分け早見表

関数 判定の方法
wp_check_filetype() ファイル名の拡張子から判定する
wp_get_image_mime() ファイルの中身(画像)から判定する
wp_handle_upload() アップロードを処理する

関連項目

wp_get_image_mime()、get_allowed_mime_types()

公式リファレンス:wp_check_filetype() | Function | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/328/feed/ 0