オプション・メタデータの記事一覧|WordPressの専門家が作る教科書 https://wordpress.ks-product.com WordPressを活用したウェブサイトの制作方法を教えます Mon, 12 Oct 2026 23:00:00 +0000 ja hourly 1 https://wordpress.org/?v=7.1.5 transient で外部APIの結果をキャッシュする方法|get_transient が false のとき https://wordpress.ks-product.com/3070/ Mon, 12 Oct 2026 23:00:00 +0000 https://wordpress.ks-product.com/?p=3070 結論
  • 外部APIなど時間のかかる処理は、get_transient() で確認し、false なら取得し直して set_transient() で保存する、という形が基本です。
  • transient の有効期限は「最大の寿命」で、最低保証はありません。公式にも、期限前に消えることがあると書かれています。消えても動く(再取得できる)コードにします。
  • 取得結果が false や空文字になりうる場合は、そのまま保存すると「キャッシュなし」と区別できません。配列に包んで保存します。
  • transient の名前は172文字以内にします(公式の記載)。

原因・仕組み

transient は、有効期限付きの一時データです。外部オブジェクトキャッシュ(Memcached など)が無い環境では、wp_options テーブルに _transient_名前 と _transient_timeout_名前 の2行で保存されます。外部オブジェクトキャッシュがあると、DBではなくメモリに保存され、wp_options には現れません。

項目 内容
保存 set_transient( $name, $value, $expiration_seconds )
取得 get_transient( $name )(期限切れ・未保存は false)
削除 delete_transient( $name )
保存先 オブジェクトキャッシュがなければ wp_options
期限 最大寿命。最低保証なし

期限切れの行は、取得されたタイミングなどで削除されます。大量に溜まるとオプションテーブルを圧迫するため、不要になったら delete_transient() を呼びます。

手順(サンプルコード)

function myplug_get_rates() {
    $key  = 'myplug_rates_v1';
    $data = get_transient( $key );
    if ( false !== $data ) {
        return $data['rates'];                    // キャッシュあり
    }

    $res = wp_remote_get( 'https://api.example.com/rates', array( 'timeout' => 5 ) );
    if ( is_wp_error( $res ) || 200 !== wp_remote_retrieve_response_code( $res ) ) {
        return array();                           // 失敗は短時間だけ保存してもよい
    }
    $rates = json_decode( wp_remote_retrieve_body( $res ), true );
    if ( ! is_array( $rates ) ) {
        return array();
    }

    // 配列に包んで保存(false・空でもキャッシュと区別できる)
    set_transient( $key, array( 'rates' => $rates ), 15 * MINUTE_IN_SECONDS );
    return $rates;
}

出力する値は、キャッシュから取り出した後でも、必ずエスケープします(esc_html( $rates['USD'] ) など)。外部の値は信頼できないデータです。

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

WordPress 7.1.2(ja)、PHP 8.2.12、MariaDB 10.4.32。php run.php transient-vs-option.php を実行しました。外部API呼び出し(wp_remote_get)自体はネットワークを使うため実行していません(未検証)。

ext object cache: NULL
array(1) { ["a"]=> int(1) }
_transient_timeout_t_demo autoload=off
_transient_t_demo autoload=off
missing: bool(false)
stored false: string(0) ""
after expiry: bool(false)
len 172: set=true get='v'
len 180: set=true get='v'
len 200: set=true get='v'
  • 外部オブジェクトキャッシュがない環境では、_transient_t_demo と _transient_timeout_t_demo の2行が wp_options に作られ、autoload は off でした。
  • 未保存のキーは false でした。
  • false を保存して取得すると、空文字 '' が返りました。false !== $data で判定すると「キャッシュあり」と見なされ、空文字を返してしまいます。配列で包む理由はここです。
  • 1秒で期限切れにして2秒待つと、false に戻りました。
  • 180文字、200文字の名前でも、この環境では保存・取得できました。ただし公式は172文字までとしているため、長い名前に依存しないでください。レビュー時の再実行では、172文字超の名前の行が option_name(191文字)で切り詰められたまま delete_transient() で消えずに残り、その状態で同じスクリプトを再実行すると、172文字の名前の取得が false になることがありました(切り詰められた行と名前が衝突したためと考えられます)。

transient で外部APIの結果をキャッシュする方法の注意点

  • 名前に $_GET の値などを使うと、transient が無限に増えます。キー数に上限を設けるか、使わない設計にします。
  • ユーザーごとに内容が違うデータは、get_current_user_id() をキーに含めるか、キャッシュしません。
  • 期限を 0 にすると、期限なし(オプションと同様に自動読み込み)になります。大きなデータでは避けます。
  • 外部APIが落ちたときに、毎回リクエストを投げ続けないよう、失敗も短い期限で保存する方法もあります。ただし、その場合は成功時のキャッシュと区別できるキー・値にします。
  • プラグインを削除するとき、delete_transient() で後始末をします。

transient で外部APIの結果をキャッシュする方法でよくあるミス

  • get_transient() の結果を if ( $data ) で判定し、空配列や 0 をキャッシュなしとして扱う。
  • 取得失敗の結果(エラー)を、長時間キャッシュしてしまう。
  • 「期限までは必ず残る」と考え、再取得のコードを書かない。
  • 名前に日付や変数を入れ続け、古いtransientが溜まる。

transient で外部APIの結果をキャッシュする方法のチェックリスト

  • キャッシュが無い場合の再取得処理が書かれているか。
  • false・空値のケースで、正しく判定できるか。
  • 名前は固定の接頭辞付きで、172文字以内か。
  • 取得した外部データを、出力時にエスケープしているか。

transient で外部APIの結果をキャッシュする方法のFAQ(よくある質問)

Q. transient とオプションはどちらを使うべき?
A. 消えても再生成できるデータは transient、消えると困る設定値はオプションです。

Q. 期限が来る前に更新したいときは?
A. delete_transient() で削除するか、set_transient() で上書きします。

Q. マルチサイトで共有するには?
A. set_site_transient() を使います。

筆者の見解(transient で外部APIの結果をキャッシュする方法)

transient は「速くするための一時的なメモ」であって、「データの置き場」ではないと考えます。消える前提で、再生成の処理を先に書き、そのあとでキャッシュを足すと、バグの少ない作りになります。false を保存しない、という一点だけでも、守る価値があると思います。

transient で外部APIの結果をキャッシュする方法の関連項目

出典(一次情報)

]]>
get_option の既定値が効かない原因|空文字・false・0 の扱い https://wordpress.ks-product.com/3069/ Sat, 10 Oct 2026 23:00:00 +0000 https://wordpress.ks-product.com/?p=3069 結論
  • get_option( $name, $default ) の $default は、オプションがデータベースに存在しないときだけ返ります(公式の記載)。空文字 '' や 0 が保存されていれば、その値が返り、既定値にはなりません。
  • 「空なら既定値」にしたいときは、$value = get_option( 'x' ); if ( '' === $value || false === $value ) { ... } のように、自分で判定します。
  • 値が false かどうかで「存在しない」を判断するのは危険です。false を保存すると、空文字として保存・取得される場合があります。
  • 設定を register_setting() で登録するなら、default 引数で既定値を一元化できます。

原因・仕組み

get_option() は、キャッシュ(alloptions など)を確認し、なければDBを読みます。DBに行がなければ、$default(省略時は false)を返します。行があれば、保存された値を返します。

状態 get_option( 'x', 'D' ) の結果
行がない 'D'
''(空文字)が保存済み ''
false が保存済み 空文字または false(保存方法による)
0 が保存済み 0

特に初心者が詰まるのは、「保存した空文字が既定値に戻らない」ことと、「|| や ?: で 0 を既定値に置き換えてしまう」ことです。

手順(サンプルコード)

「存在しない」と「空」を区別したい場合は、センチネル(目印)値を使います。

// 1) 存在しないときだけ既定値
$limit = get_option( 'myplug_limit', 10 );

// 2) 空文字・0 も「未設定」とみなして既定値にしたい(0 を許可しない場合)
$limit = (int) get_option( 'myplug_limit', 10 );
if ( $limit <= 0 ) {
    $limit = 10;
}

// 3) 0 や false も有効な値として扱いたい → 存在確認にセンチネルを使う
$raw = get_option( 'myplug_flag', '__none__' );
if ( '__none__' === $raw ) {
    // まだ一度も保存されていない
}

設定の既定値を複数箇所に書くと、ズレます。register_setting() の default か、既定値を返す専用の関数にまとめます。

function myplug_get_options() {
    $defaults = array( 'title' => '', 'count' => 10 );
    return wp_parse_args( (array) get_option( 'myplug_opts', array() ), $defaults );
}

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

WordPress 7.1.2(ja)、PHP 8.2.12。php run.php get-option-default.php で確認しました(テスト用のオプションは最後に削除)。

missing, default 'x': string(1) "x"
missing, no default: bool(false)
stored '', default 'x': string(0) ""
stored false, default 'x': bool(false)
stored 0 -> int(0)
?: with 0 -> int(5)
stored true -> bool(true)
missing -> uses sentinel: bool(true)
  • 存在しないオプションは、既定値 'x' が返りました。
  • 空文字 '' を add_option() で保存した場合は、既定値を渡しても '' が返りました。
  • add_option( 't_false', false ) の後、既定値 'x' を渡しても bool(false) が返りました(既定値は使われません)。
  • 0 を保存した場合は int(0) が返りますが、?: で受けると 5 に化けました。
  • 保存したばかりの値の型は、保存時の型のままでした。ただし、別のリクエストでDBから読むと、数値や真偽値は文字列で返る場合があります(レビュー時に別々の実行で確認したところ、0 を保存→次のリクエストで string(1) "0"、true を保存→string(1) "1" でした)。このため (int) や (bool) の変換をしてから使います。

get_option の既定値が効かない原因の注意点

  • 公式は、オプションを初期化せずに false を戻り値として使うのは悪い実践としています。未設定のたびにDBアクセスが発生することがあるためです。有効化時に add_option() で初期値を入れておく方法が安定します。
  • 保存した直後と別リクエストで型が変わりうるため、=== による比較には注意が必要です。
  • pre_option_{$option} フィルターで値を差し替えられるため、他のプラグインが影響している可能性があります。
  • 配列は、一部のキーだけが欠けることがあります。wp_parse_args() で既定値とマージします。

get_option の既定値が効かない原因でよくあるミス

  • get_option( 'x', 'default' ) と書いて、空欄で保存したのに既定値に戻らないと悩む。
  • if ( ! get_option( 'x' ) ) で、0 や空文字を「未設定」にしてしまう。
  • 既定値を、読む箇所ごとに別の値で書いてしまう。
  • 文字列の '0' と整数の 0 を === で比較して、不一致になる。

get_option の既定値が効かない原因のチェックリスト

  • 「存在しない」と「空」を区別する必要があるか決めたか。
  • 既定値の定義は、1箇所にまとまっているか。
  • 数値・真偽値は、読んだ後に型変換しているか。
  • 有効化時に、初期値を add_option() で入れているか。

get_option の既定値が効かない原因のFAQ(よくある質問)

Q. get_option が毎回DBを読むのは遅くないですか?
A. 自動読み込み(autoload)されるオプションは、起動時にまとめて取得されキャッシュされます。サイズの大きな値は autoload を false にします。

Q. get_option と get_site_option の違いは?
A. 後者はマルチサイトのネットワーク全体の設定です(get_site_option() の使い方|説明・引数・注意点)。

Q. 既定値を変えたら、既存のサイトにも反映されますか?
A. 保存済みの値には反映されません。保存されていないサイトだけが新しい既定値になります。

筆者の見解(get_option の既定値が効かない原因)

get_option() の既定値は、「未設定」と「空」を混ぜない設計をする、という前提で使う関数だと考えます。使う側で毎回既定値を書くより、1つの取得関数に包んでしまう方が、後から既定値を変えるときも楽です。

get_option の既定値が効かない原因の関連項目

出典(一次情報)

]]>
update_term_meta() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/253/ https://wordpress.ks-product.com/253/#respond Fri, 02 Oct 2026 15:45:57 +0000 https://wordpress.ks-product.com/253/ 説明

update_term_meta() は、タームのメタデータを更新する関数です。

基本構文

update_term_meta( int $term_id, string $meta_key, mixed $meta_value, mixed $prev_value = '' ): int|bool|WP_Error

引数

  • $term_id:タームID
  • $meta_key:メタキー
  • $meta_value:値
  • $prev_value:旧値(省略可)

戻り値

メタIDまたは true。失敗時は false か WP_Error。

使い方(サンプル)

update_term_meta( 5, 'color', 'red' );

注意点

  • WordPress 4.4 以降で利用できます。
  • 保存前に値をサニタイズします。

実務での使いどころ

  • カテゴリーやタームごとの、追加情報(色、アイコン、並び順など)を保存するとき。
  • タームの編集画面に追加したフィールドの値を、保存するとき。

よくあるミスと対策

  • 戻り値が false のとき、失敗したと考える。値が変わらないときも false が返る。
  • 権限や入力値の確認をしていない。
  • WordPress 4.4より前のバージョンでは、使えない。

NG例

update_term_meta( $term_id, 'color', $_POST['color'] ); // 検証・サニタイズがない

OK例

if ( current_user_can( 'manage_categories' ) && isset( $_POST['color'] ) ) {
	update_term_meta( $term_id, 'color', sanitize_hex_color( wp_unslash( $_POST['color'] ) ) );
}

使い分け早見表

関数 役割
update_term_meta() 値を保存する(なければ作成、あれば更新)
get_term_meta() 値を取得する
delete_term_meta() 値を削除する

関連項目

get_term_meta()、delete_term_meta()

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

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

wp_cache_get() は、オブジェクトキャッシュからデータを取得する関数です。

基本構文

wp_cache_get( int|string $key, string $group = '', bool $force = false, bool &$found = null ): mixed|false

引数

  • $key:キャッシュキー
  • $group:グループ名
  • $force:キャッシュを無視して再取得するか
  • $found:見つかったかどうかを受け取る変数

戻り値

キャッシュされた値。なければ false。

使い方(サンプル)

$value = wp_cache_get( 'my_key', 'my_group' );

注意点

  • 既定ではリクエストの間だけ有効なキャッシュです。Redisなどの永続オブジェクトキャッシュを導入すると、リクエストをまたいで保持されます。

実務での使いどころ

  • 同じリクエストの中で、同じ処理の結果を、使い回すとき(重複したクエリの削減)。
  • 永続的なオブジェクトキャッシュ(RedisやMemcachedなど)を使うサイトで、値をキャッシュするとき。

よくあるミスと対策

  • 保存した値が、次のリクエストでも残ると考えている。永続的なオブジェクトキャッシュがない環境では、リクエストごとに消える。
  • 見つからないときは false が返る。値が false のときと区別したいなら、第4引数 $found を使う。
  • キーのグループを指定せず、他の処理とキーが重なる。

NG例

$value = wp_cache_get( 'my_key' ); // 次のリクエストでも残ると思っている

OK例

$found = false;
$value = wp_cache_get( 'my_key', 'my_group', false, $found );
if ( ! $found ) {
	$value = my_heavy_query();
	wp_cache_set( 'my_key', $value, 'my_group' );
}

使い分け早見表

関数 永続性
wp_cache_get() 永続的なオブジェクトキャッシュがあれば、リクエストをまたぐ。なければ、そのリクエストの間だけ
get_transient() データベース(または永続キャッシュ)に保存される。期限が来るまで、残ることが多い(期限前でも、消える場合がある)
get_option() データベースに保存され、恒久的

関連項目

wp_cache_set()、get_transient()

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

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

delete_transient() は、トランジェントを削除する関数です。

基本構文

delete_transient( string $transient ): bool

引数

  • $transient:トランジェント名

戻り値

削除できたら true。

使い方(サンプル)

delete_transient( 'my_api_cache' );

注意点

  • キャッシュの手動クリアに使います。

実務での使いどころ

  • 元のデータを更新したときに、キャッシュを消して、作り直させるとき。
  • 保存した値を、手動で無効にするとき。

よくあるミスと対策

  • 存在しない名前の削除では、false が返る。
  • 元のデータを更新しても、キャッシュを消さず、古い値が使われ続ける。save_post などで削除する。

NG例

update_option( 'my_source', $new ); // キャッシュが残り、古い値が使われる

OK例

update_option( 'my_source', $new );
delete_transient( 'my_data' );

使い分け早見表

関数 役割
delete_transient() 削除する
set_transient() 有効期限つきで保存する
get_transient() 保存した値を取得する

関連項目

get_transient()、set_transient()

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

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

set_transient() は、データを一定時間だけ保存する(トランジェント)関数です。外部APIの結果のキャッシュによく使います。

基本構文

set_transient( string $transient, mixed $value, int $expiration = 0 ): bool

引数

  • $transient:トランジェント名
  • $value:保存する値
  • $expiration:有効期間(秒)。0 は無期限

戻り値

保存できたら true。

使い方(サンプル)

set_transient( 'my_api_cache', $data, HOUR_IN_SECONDS );

注意点

  • HOUR_IN_SECONDS や DAY_IN_SECONDS などの定数が使えます。
  • 期限切れは、アクセス時に削除されます。確実に永続化したいデータには向きません。
  • トランジェント名は172文字以内にします。

実務での使いどころ

  • 外部APIの結果や、重い処理の結果を、有効期限つきで保存するとき。

よくあるミスと対策

  • 有効期限を省略している。省略(0)すると、期限がなくなる。
  • 保存したデータが、必ず残ると考えている。期限前でも消える場合があるため、get_transient() の結果を確認する。
  • 名前が長すぎる。名前は172文字以内にする。

NG例

set_transient( 'my_data', $data ); // 期限がない

OK例

set_transient( 'my_data', $data, 12 * HOUR_IN_SECONDS );

使い分け早見表

関数 役割
set_transient() 有効期限つきで保存する
get_transient() 保存した値を取得する
delete_transient() 削除する

関連項目

get_transient()、delete_transient()

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

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

get_transient() は、一時的に保存したデータ(トランジェント)を取得する関数です。有効期限が切れていれば false を返します。

基本構文

get_transient( string $transient ): mixed

引数

  • $transient:トランジェント名

戻り値

保存した値。存在しない・期限切れなら false。

使い方(サンプル)

$data = get_transient( 'my_api_cache' );
if ( false === $data ) {
	// 取得し直して保存
}

注意点

  • 保存した値自体が false の場合と区別がつかないため、厳密比較(false ===)で判定します。
  • オブジェクトキャッシュが有効な環境では、データベースではなくメモリに保存されます。

実務での使いどころ

  • 外部APIの結果や、重い処理の結果を、一時的に保存して使い回すとき。
  • 有効期限つきで、データをキャッシュするとき。

よくあるミスと対策

  • 保存されていない、または期限切れのときは false が返る。保存した値が false だと区別できない。=== で比べる。
  • トランジェントは、期限前でも消える場合がある。消えても動くように、作り直す処理を用意する。
  • 外部の応答などを、保存せずに毎回取得している。

NG例

$data = get_transient( 'my_data' );
echo $data['title']; // 無い場合に、エラーになる

OK例

$data = get_transient( 'my_data' );
if ( false === $data ) {
	$data = my_fetch_data();
	set_transient( 'my_data', $data, HOUR_IN_SECONDS );
}

使い分け早見表

関数 役割
get_transient() 保存した値を取得する
set_transient() 有効期限つきで保存する
delete_transient() 削除する

関連項目

set_transient()、delete_transient()

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

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

register_post_meta() は、特定の投稿タイプのメタデータを登録する関数です。

基本構文

register_post_meta( string $post_type, string $meta_key, array $args ): bool

引数

  • $post_type:投稿タイプ(空文字で全タイプ)
  • $meta_key:メタキー
  • $args:register_meta() と同じ設定

戻り値

登録できたら true。

使い方(サンプル)

register_post_meta( 'book', 'isbn', array(
	'type'         => 'string',
	'single'       => true,
	'show_in_rest' => true,
) );

注意点

  • init フックで呼びます。

実務での使いどころ

  • 特定の投稿タイプの、カスタムフィールドを登録するとき。
  • メタを、REST APIやブロックエディターから扱えるようにするとき。

よくあるミスと対策

  • show_in_rest を指定せず、REST APIやブロックエディターで、メタが使えない。
  • 投稿タイプが custom-fields をサポートしておらず、REST APIにメタが出ない。
  • init フックの外で登録している。

NG例

register_post_meta( 'news', 'price', array( 'type' => 'integer' ) ); // REST API に出ない

OK例

add_action( 'init', function () {
	register_post_meta( 'news', 'price', array(
		'type'         => 'integer',
		'single'       => true,
		'show_in_rest' => true,
	) );
} );

使い分け早見表

関数 対象
register_post_meta() 特定の投稿タイプのメタ
register_meta() 投稿・ユーザー・ターム・コメントのメタ
update_post_meta() メタの値を保存する

関連項目

register_meta()、get_post_meta()

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

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

register_meta() は、メタデータを登録し、型・REST API・サニタイズなどを設定する関数です。

基本構文

register_meta( string $object_type, string $meta_key, array $args, string|array $deprecated = null ): bool

引数

  • $object_type:post / user / term / comment
  • $meta_key:メタキー
  • $args:type、single、show_in_rest、sanitize_callback など

戻り値

登録できたら true。

使い方(サンプル)

register_meta( 'post', 'price', array(
	'type'         => 'integer',
	'single'       => true,
	'show_in_rest' => true,
) );

注意点

  • REST APIやブロックエディターでカスタムフィールドを扱うには show_in_rest を true にします。
  • 投稿タイプごとに登録する場合は register_post_meta() が便利です。

実務での使いどころ

  • カスタムフィールドの型や、サニタイズの規則を、あらかじめ決めておくとき。
  • メタの値を、REST APIやブロックエディターから扱えるようにするとき(show_in_rest)。

よくあるミスと対策

  • show_in_rest を指定せず、REST APIやブロックエディターで、メタが使えない。
  • type を指定しない、または実際の値と型が合っていない。
  • single の指定を間違える。false(既定)では、値が配列として扱われる。
  • init フックの外で登録している。

NG例

register_meta( 'post', 'price', array( 'type' => 'integer' ) ); // REST API に出ない

OK例

add_action( 'init', function () {
	register_meta( 'post', 'price', array(
		'type'              => 'integer',
		'single'            => true,
		'show_in_rest'      => true,
		'sanitize_callback' => 'absint',
	) );
} );

使い分け早見表

関数 対象
register_meta() 投稿・ユーザー・ターム・コメントのメタ
register_post_meta() 投稿(投稿タイプを指定)のメタ

関連項目

register_post_meta()、get_post_meta()

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

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

delete_term_meta() は、タームのメタデータを削除する関数です。

基本構文

delete_term_meta( int $term_id, string $meta_key, mixed $meta_value = '' ): bool

引数

  • $term_id:タームID
  • $meta_key:メタキー
  • $meta_value:値(省略可)

戻り値

削除できたら true。

使い方(サンプル)

delete_term_meta( 5, 'color' );

注意点

  • 値を省略するとそのキーが全て消えます。

実務での使いどころ

  • タームのメタを、削除するとき。

よくあるミスと対策

  • $meta_value を指定せず、同じキーのすべての値を削除してしまう。
  • 存在しないキーの削除では、false が返る。

NG例

delete_term_meta( $term_id, 'color' ); // 同じキーのすべての値が、削除される

OK例

delete_term_meta( $term_id, 'color', 'red' ); // 'red' の値だけを削除

使い分け早見表

関数 役割
delete_term_meta() 値を削除する
update_term_meta() 値を保存する
get_term_meta() 値を取得する

関連項目

get_term_meta()、update_term_meta()

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

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