# 使用用户元数据

#### 介绍

WordPress 的`users`表被设计为仅包含有关用户的基本信息。

<div class="callout callout-info" id="bkmrk-%E7%AC%94%E8%AE%B0%EF%BC%9A%E4%BB%8E-wp-4.7-%E5%BC%80%E5%A7%8B%EF%BC%8C%E8%AF%A5%E8%A1%A8%E5%8C%85%E5%90%AB%EF%BC%9A"><span class="screen-reader-text">笔记：</span>从 WP 4.7 开始，该表包含：`ID`、`user_login`、`user_pass`、`user_nicename`、`user_email`、`user_url`、`user_registered`、`user_activation_key`和。`user_status``display_name`  
</div>因此，为了存储额外的数据，`usermeta`引入了表，它可以存储有关用户的任意数量的数据。

`ID`两个表使用基于表中的一对多关系连接在一起`users`。

#### 操纵用户元数据

操作用户元数据有两种主要方法。

1. 用户个人资料屏幕中的表单字段。
2. 以编程方式，通过函数调用。

#### 通过表单字段

表单字段选项适用于用户有权访问 WordPress 管理区域的情况，他可以在其中查看和编辑配置文件。

在我们深入研究示例之前，了解该过程中涉及的钩子以及它们存在的原因非常重要。

#### show\_user\_profile钩

每当用户编辑**其自己的**用户配置文件时，就会触发此操作挂钩。

**请记住，**无法编辑自己的个人资料的用户不会触发此挂钩。

#### edit\_user\_profile钩

每当用户编辑**其他人**的用户配置文件时，就会触发此操作挂钩。

**请记住，**不具备编辑第 3 方配置文件功能的用户不会触发此挂钩。

#### 表单字段示例

在下面的示例中，我们将向所有个人资料屏幕添加生日字段。在配置文件更新时将其保存到数据库中。

<div class="wporg-developer-code-block" id="bkmrk-">  
</div>```php
/**
 * The field on the editing screens.
 *
 * @param $user WP_User user object
 */
function wporg_usermeta_form_field_birthday( $user ) {
    ?>
    <h3>It's Your Birthday</h3>
    <table class="form-table">
        <tr>
            <th>
                <label for="birthday">Birthday</label>
            </th>
            <td>
                <input type="date"
                       class="regular-text ltr"
                       id="birthday"
                       name="birthday"
                       value="<?= esc_attr( get_user_meta( $user->ID, 'birthday', true ) ) ?>"
                       title="Please use YYYY-MM-DD as the date format."
                       pattern="(19[0-9][0-9]|20[0-9][0-9])-(1[0-2]|0[1-9])-(3[01]|[21][0-9]|0[1-9])"
                       required>
                <p class="description">
                    Please enter your birthday date.
                </p>
            </td>
        </tr>
    </table>
    <?php
}
 
/**
 * The save action.
 *
 * @param $user_id int the ID of the current user.
 *
 * @return bool Meta ID if the key didn't exist, true on successful update, false on failure.
 */
function wporg_usermeta_form_field_birthday_update( $user_id ) {
    // check that the current user have the capability to edit the $user_id
    if ( ! current_user_can( 'edit_user', $user_id ) ) {
        return false;
    }
 
    // create/update user meta for the $user_id
    return update_user_meta(
        $user_id,
        'birthday',
        $_POST['birthday']
    );
}
 
// Add the field to user's own profile editing screen.
add_action(
    'show_user_profile',
    'wporg_usermeta_form_field_birthday'
);
 
// Add the field to user profile editing screen.
add_action(
    'edit_user_profile',
    'wporg_usermeta_form_field_birthday'
);
 
// Add the save action to user's own profile editing screen update.
add_action(
    'personal_options_update',
    'wporg_usermeta_form_field_birthday_update'
);
 
// Add the save action to user profile editing screen update.
add_action(
    'edit_user_profile_update',
    'wporg_usermeta_form_field_birthday_update'
);
```

#### 以编程方式

此选项适用于您正在构建自定义用户区域和/或计划禁用对 WordPress 管理区域的访问的情况。

可用于操作用户元数据的函数有：`<a href="https://developer.wordpress.org/reference/functions/add_user_meta/">add_user_meta()</a>`、`<a href="https://developer.wordpress.org/reference/functions/update_user_meta/">update_user_meta()</a>`和。`<a href="https://developer.wordpress.org/reference/functions/delete_user_meta/">delete_user_meta()</a>``<a href="https://developer.wordpress.org/reference/functions/get_user_meta/">get_user_meta()</a>`

#### 添加

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

`<a href="https://developer.wordpress.org/reference/functions/add_user_meta/">add_user_meta()</a>`有关所用参数的完整说明，请参阅函数参考。

#### 更新

```php
update_user_meta(
    int $user_id,
    string $meta_key,
    mixed $meta_value,
    mixed $prev_value = ''
);
```

`<a href="https://developer.wordpress.org/reference/functions/update_user_meta/">update_user_meta()</a>`有关所用参数的完整说明，请参阅函数参考。

#### 删除

```php
delete_user_meta(
    int $user_id,
    string $meta_key,
    mixed $meta_value = ''
);
```

`<a href="https://developer.wordpress.org/reference/functions/delete_user_meta/">delete_user_meta()</a>`有关所用参数的完整说明，请参阅函数参考。

#### 得到

```php
get_user_meta(
    int $user_id,
    string $key = '',
    bool $single = false
);
```

`<a href="https://developer.wordpress.org/reference/functions/get_user_meta/">get_user_meta()</a>`有关所用参数的完整说明，请参阅函数参考。

请注意，如果您仅传递`$user_id`，该函数将以关联数组的形式检索所有元数据。

您可以在插件或主题中的任何位置呈现用户元数据。