WordPress 用户元信息 get_user_meta() 和 update_user_meta()
像素鱼丸
11-22
229
0

在WordPress中,get_user_meta 和 set_user_meta 是两个重要的函数,用于管理和操作用户相关的元数据(自定义字段)。下面是对这两个函数的详细说明:

get_user_meta() 获取用户元信息

功能:此函数用于从数据库中检索与特定用户关联的元数据值。

语法:

get_user_meta( $user_id, $meta_key, $single );
  • $user_id(必需,整数):要获取其元数据的用户的ID。
  • $meta_key(必需,字符串):元数据的键名,即你想获取的具体元数据字段的标识。
  • $single(可选,布尔值):指定返回类型。如果设置为 true 并且该元数据只有一个值,则直接返回该值;如果为 false 或未设置,则返回包含所有值的数组(即使只有一个值也会封装在数组中)。

示例

获取用户ID为1的用户的电话号码(假设电话号码作为一个元数据项存储):

$phone_number = get_user_meta( 1, 'phone_number', true );
echo '电话号码: ' . $phone_number;

 

update_user_meta() 更新用户元信息

用于更新现有的用户元信息。如果元信息不存在,则会创建一个新的记录。

/**
 * Updates user meta.
 *
 * @param int    $user_id User ID.
 * @param string $meta_key The key of the meta field.
 * @param mixed  $meta_value The value of the meta field.
 * @param mixed  $prev_value Optional. If specified, only update existing metadata entries with the specified value.
 * @return bool|int False on failure, or the meta ID on success.
 */
function update_user_meta( $user_id, $meta_key, $meta_value, $prev_value = '' );

示例:

$user_id = 1;
$meta_key = 'favorite_color';
$new_meta_value = 'red';
$prev_value = 'blue'; // 只有当值为'blue'时才更新

// 更新用户元信息
if ( update_user_meta( $user_id, $meta_key, $new_meta_value, $prev_value ) ) {
    echo "User meta updated successfully.";
} else {
    echo "No changes were made to the user meta.";
}

 

delete_user_meta() 删除用户元信息

用于删除用户元信息。

/**
 * Deletes user meta.
 *
 * @param int    $user_id User ID.
 * @param string $meta_key The key of the meta field.
 * @param mixed  $meta_value Optional. If specified, only delete the entry with the specified value.
 * @return bool True if deleted, false if not.
 */
function delete_user_meta( $user_id, $meta_key, $meta_value = '' );

示例:

$user_id = 1;
$meta_key = 'favorite_color';

// 删除用户元信息
if ( delete_user_meta( $user_id, $meta_key ) ) {
    echo "User meta deleted successfully.";
} else {
    echo "Failed to delete user meta.";
}

如果只指定了用户ID和meta key,则会删除这个用户的这个key下所有的属性值(属性值可能是一个数组);如果还指定了 meta value,则只会删除 和 meta value 匹配的值。

收藏
打赏
WordPress 文章页作者信息 get_the_author() 和 get_the_author_meta()
上一篇
Mirage 主题 v2.56.0 发布
下一篇

发表评论

注册不是必须的

像素鱼丸
149 文章
0 评论
4 喜欢
最新文章

Mirage 主题 v2.93.0 发布

更新内容: refactor 移除图片高宽比开关 refactor 移除全局的TOC生成开关 refactor 优化 header.php 中的seo模块和样式覆盖 feat 主题启用的时候,移除非当前主题注册的小工具 fix 修复分类小工具的bug feat 管理员打开后台,检查最当前设置首页布局的模块,如果缺少最新模块,就添加到隐藏模块列表中 fix 优化链接卡片样式 fix 优化热门文章样式 […]

如何使用 WordPress Setting API

使用 WordPress 的 Setting API 是在插件或主题中创建和管理设置页面的标准方式。它提供了一种结构化、安全的方式来保存和获取用户配置的选项。 ✅ 一、Setting API 简介 WordPress 的 Setting API 允许你: 创建设置页面(Settings Page) 注册设置字段(Settings Field) 验证和保存设置数据 使用表单提交来更新设置 ✅ 二、基 […]

详解 WordPress 的评论设置

好的,我们来详细梳理并总结 WordPress 中关于文章评论的两个核心控制层级:全局设置和单篇设置。理解这两者的关系(优先级)是管理网站评论的关键。 1. 全局设置 (Global Settings) —— 网站的“默认规则” 这是整个网站评论系统的总开关和默认行为准则。它决定了新发布的文章默认是什么样子的。 位置:WordPress 后台仪表盘 -> 设置 (Settings) -> […]

wp_handle_comment_submission 函数

wp_handle_comment_submission() 是 WordPress 中用于处理评论提交的核心函数之一。它通常在用户提交评论时被调用,负责验证和处理评论数据,并最终将评论插入到数据库中。 ✅ 函数作用 wp_handle_comment_submission() 的主要功能是: 验证用户提交的评论数据(如评论内容、用户名、邮箱等) 检查是否为垃圾评论(通过 Akismet 或其他过 […]
生成中...
扫描二维码
扫描二维码
用户登录