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

在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 发布
下一篇

发表评论

注册不是必须的

像素鱼丸
160 文章
2 评论
4 喜欢
最新文章

VooShop 商城主题

主题简介 Vooshop 是一个简单精美的 WordPress 主题,支持自适应、暗黑模式、多语言等功能,可以用于企业、团体、自由职业者或更广泛的主页。 Vooshop:回归 WooCommerce 的纯粹与极速 零冗余代码,零多余功能。一个完全依赖 WooCommerce 原生能力的轻量级主题。 Vooshop 不做 WooCommerce 做不到的事,我们只负责让它跑得更快。 市面上的主题总试 […]

XZhan 主题

主题简介 XZhan 主题(中文名称:小站主题)是一款 WordPress 企业主题,支持自适应、暗黑模式等功能,可快速构建高质量的企业网站。   主题特色 支持白天与暗黑模式 自适应设计,兼容多种主流浏览器 自定义主色调 LOGO扫光动画 自定义SMTP支持 内置SEO功能 文章支持点赞、分享和海报生成 丰富的小工具 侧边栏粘性滚动 简介的主题设置面板 主题设置可导入和备份 多级子菜单 […]

StarFish 配置框架

一个轻量级的 WordPress 选项框架插件,通过配置化的方式,快速为 WordPress 主题或插件生成后台设置页面。 ✨ 特性 🎯 配置驱动 UI:只需定义数组配置,自动生成完整的表单界面 📱 多页面架构:支持多个独立的设置页面 🎨 丰富的字段类型:包含 15+ 种常用字段类型 🔗 字段依赖系统:实现字段间的联动效果 ✅ 数据验证与清理:自动进行安全清理,防止 XSS 攻击 🚀 零依赖:使用 […]

什么是幽灵按钮

“幽灵按钮”(Ghost Button)是一种常见的网页与移动应用 UI 设计模式,指背景透明(或半透明)、仅通过边框(border)和文字(text)定义的按钮,视觉上“若隐若现”,仿佛“幽灵”一般——因此得名。 核心特征: 无填充色(transparent background) 背景完全透明(或与父容器同色),不遮挡背后内容。 清晰的边框(通常 1–2px 实线) 如 border: 2px […]
生成中...
扫描二维码
扫描二维码
确认购买

您确定要购买此资源吗?

微信扫码支付

请使用微信扫描二维码完成支付

订单号:

等待支付...