WordPress函数add_user_meta详细用法教程解析

WordPress函数add_user_meta用于在用户的元数据中添加一个键-值对。

语法：

add_user_meta( int $user_id, string $meta_key, mixed $meta_value, bool $unique = false )

参数说明：

$user_id (int) (必需)：要添加元数据的用户ID。

$meta_key (string) (必需)：要添加的元数据键。

$meta_value (mixed) (必需)：要添加的元数据值。

$unique (bool) (可选)：如果为true，则确保元数据键唯一。默认为false。

返回值：

如果成功添加元数据，则返回true，否则返回false。

使用示例：

1. 添加一个简单的元数据：

$user_id = 123; // 用户ID
$meta_key = 'twitter_handle'; // 元数据键
$meta_value = '@example'; // 元数据值

$result = add_user_meta( $user_id, $meta_key, $meta_value );

if ( $result ) {
echo '元数据添加成功！';
} else {
echo '元数据添加失败！';
}

2. 添加一个唯一的元数据：

$user_id = 123; // 用户ID
$meta_key = 'email'; // 元数据键
$meta_value = 'test@example.com'; // 元数据值

$result = add_user_meta( $user_id, $meta_key, $meta_value, true );

if ( $result ) {
echo '元数据添加成功！';
} else {
echo '元数据添加失败！';
}

注意事项：

- $user_id必须是一个有效的用户ID。
- $meta_key和$meta_value可以是任意类型的数据，如字符串、数组、对象等。
- 默认情况下，可以为同一个用户添加相同的元数据键。如果想确保元数据键的唯一性，可以将$unique参数设置为true。