2024年06月28日
WP関数:update_post_meta()
この関数の説明
WP関数の update_post_meta() は、指定した投稿や固定ページのカスタムフィールドを新規追加/更新する関数です。
・指定したキーが無ければ新規追加
・指定してキーがある場合は更新を実行します。
関数
update_post_meta( $id, $meta_key, $meta_value )
パラメータ
$id (整数) (必須)
投稿 IDを指定します。
$meta_key (文字列) (必須)
カスタムフィールドのキーを指定します
$meta_value (文字列 | 整数) (必須)
キーのデータを指定します
戻り値
更新に成功すれば true、失敗すれば false を返します。
事例
カスタムフィールドに下記のデータをプログラムで登録する例です。
<?php update_post_meta(get_the_ID(),'price',100); // price キーの新設及び更新 $size = "80\n82\n84"; // size は改行で登録します update_post_meta(get_the_ID(),'size',$size);// sizeデータの新設及び更新 ?>
■2行目:priceデータを新設又は更新します。
■3行目:sizeデータを改行コードと共に設定します。
\nを指定する時は"(ダブルクオーテーション)で括る必要があります。
■4行目:sizeデータを新設又は更新します。
関連情報
①関連関数は カスタムフィールド関連関数 を参照してください
②カスタムフィールドを文書更新時にデフォルト設定したい場合は アクションフック:save_post を参照してください。