• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

関数リファレンス/add user meta

提供: WordPress Codex 日本語版
移動先: 案内検索

この項目「関数リファレンス/add user meta」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。

説明

ユーザー(データベース内のレコード)にメタデータを追加します。

使い方

<?php add_user_meta( $user_id, $meta_key, $meta_value, $unique ); ?>

パラメータ

$user_id
整数) (必須) ユーザー ID。
初期値: なし
$meta_key
文字列) (必須) メタデータの名前。
初期値: なし
$meta_value
mixed) (必須) メタデータの値。(自分でシリアル化しないでください。WordPress が行います。)
初期値: なし
$unique
真偽値) (オプション) 同じキー(名前)の追加を禁止するかどうか。
初期値: false — 禁止しない

戻り値

(整数/真偽値) 
成功するとメタデータの ID を、失敗すると false を返します。

用例

<?php
$user_id = 1;
$awesome_level = 1000;
add_user_meta( $user_id, '_level_of_awesomeness', $awesome_level );
?>

参考

変更履歴

新規導入: 3.0.0

ソースファイル

add_user_meta()wp-includes/user.php にあります。

関連項目

add_user_meta(), delete_user_meta(), get_user_meta(), update_user_meta(), get_user_option() /en, delete_user_option() /en, update_user_option() /en,


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function_Reference/add_user_meta最新版との差分