Question

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

Add meta data field to a user.

---

description

Post meta data is called "Custom Fields" on the Administration Screens.

---

参数

$user_id

(int) (Required) User ID.

$meta_key

(string) (Required) Metadata name.

$meta_value

(mixed) (Required) Metadata value.

$unique

(bool) (Optional) Whether the same key should not be added.

Default value: false

---

返回值

(int|false) Meta ID on success, false on failure.

---

源代码

File: wp-includes/user.php

function add_user_meta($user_id, $meta_key, $meta_value, $unique = false) {
	return add_metadata('user', $user_id, $meta_key, $meta_value, $unique);
}

---

更新日志

Version	description
3.0.0	Introduced.

---

相关函数

Uses

• wp-includes/meta.php: add_metadata()

---

Used By

• wp-admin/includes/class-wp-internal-pointers.php: WP_Internal_Pointers::dismiss_pointers_for_new_users()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Examples

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