## 添加元数据
add_post_meta()可以很容易地添加元数据。 该函数接受一个post_id,一个meta_key,一个meta_value和一个唯一的标志。
meta_key是你的插件如何引用代码中的其他地方的元值。 像mycrazymetakeyname这样的东西可以工作,但是与插件或主题相关的前缀跟随关键字的描述会更有用。 wporg_featured_menu可能是一个好的。 应该注意的是,可以多次使用相同的meta_key来存储元数据的变体(参见下面的唯一标志)。
meta_value可以是字符串,整数或数组。 如果它是一个数组,它将被自动序列化,然后被存储在数据库中。
唯一标志允许您声明该键是否应该是唯一的。 一个非唯一的键是一个帖子可以有多个变体,如价格。
如果你只想要一个帖子的价格,你应该标记它是唯一的,并且meta_key将只有一个值。
## 更新元数据
如果一个密钥已经存在,并且要更新,请使用update_post_meta()。 如果您使用此功能并且该键不存在,那么它将创建它,就像您使用add_post_meta()一样。
与add_post_meta()类似,该函数接受一个post_id,一个meta_key,一个meta_value和一个唯一的标志。
## 删除元数据
delete_post_meta()接受一个post_id,一个meta_key和可选的meta_value。 它正好是名字所暗示的。
## 角色逃避
发送元值被存储时通过stripslashes()函数,所以在传递可能包含\转义字符的值(如JSON)时,您需要小心。
考虑JSON值{“key”:“value with \”escaped quotes \“”}:
```
$escaped_json = '{"key":"value with \"escaped quotes\""}';
update_post_meta($id, 'escaped_json', $escaped_json);
$broken = get_post_meta($id, 'escaped_json', true);
/*
$broken, after stripslashes(), ends up unparsable:
{"key":"value with "escaped quotes""}
*/
```
## 解决办法
通过使用函数wp_slash()(在WP 3.6中引入)添加一个级别的\escape,您可以补偿对stripslashes()的调用:
```
$escaped_json = '{"key":"value with \"escaped quotes\""}';
update_post_meta($id, 'double_escaped_json', wp_slash($escaped_json));
$fixed = get_post_meta($id, 'double_escaped_json', true);
/*
$fixed, after stripslashes(), ends up as desired:
{"key":"value with \"escaped quotes\""}
*/
```
## 隐藏的自定义字段
如果您是插件或主题开发人员,并且您打算使用自定义字段来存储参数,请务必注意,WordPress不会显示自定义字段,该自定义字段在自定义字段列表中以“_”(下划线)开头 后编辑屏幕或使用the_meta()模板功能时。
这可以通过使用add_meta_box()函数以异常的方式显示这些自定义字段是有用的。
下面的示例将添加一个唯一的自定义字段与meta_key名称“_color”和meta_value“红色”,但此自定义字段不会显示在后编辑屏幕中:
```
add_post_meta(68, '_color', 'red', true);
```
## 隐藏数组
另外,如果meta_value是一个数组,它不会显示在页面编辑屏幕上,即使不使用下划线的meta_key名称前缀。
- 简介
- 主题开发
- WordPress许可证
- 什么是主题
- 开发环境
- 主题开发示例
- 主题基础
- 模板文件
- 主样式表(style.css)
- 文章类型
- 规划主题文件
- 模板层级
- 模板标签
- 循环
- 主题函数
- 连接主题文件和目录
- 使用CSS和JavaScript
- 条件标签
- 类别,标签和自定义分类
- 模板文件
- 内容模板文件
- 页面模板文件
- 附件模板文件
- 自定义内容类型
- 部分和其他模板文件
- 评论模板
- 分类模板
- 404页面
- 主题功能
- 核心支持的功能
- 管理菜单
- 自定义Headers
- 自定义Logo
- 文章格式
- 置顶文章
- Sidebars
- Widgets
- 导航菜单
- 分页
- 媒体
- Audio
- Images
- Galleries
- Video
- 精选图片和缩略图
- 国际化
- 本地化
- 辅助功能
- 主题选项 – 自定义API
- 定制对象
- 改进用户体验的工具
- 定制JavaScript API
- JavaScript / Underscore.js渲染的自定义控件
- 高级用法
- 主题安全
- 数据消毒/逃避
- 数据验证
- 使用随机数
- 常见漏洞
- 高级主题
- 子主题
- UI最佳实践
- JavaScript最佳做法
- 主题单元测试
- 验证你的主题
- Plugin API Hooks
- 发布你的主题
- 所需的主题文件
- 测试
- 主题评论指南
- 写文档
- 提交你的主题到WordPress.org
- 参考文献
- 模板标签列表
- 条件标签列表
- 编码标准
- HTML编码标准
- CSS编码标准
- JavaScript编码标准
- PHP编码标准
- 插件开发
- 插件开发简介
- 什么是插件
- 插件基础
- 头部要求
- 包括软件许可证
- 启用 / 停用 Hooks
- 卸载方法
- 最佳做法
- 插件安全
- 检查用户功能
- 数据验证
- 保护输入
- 保护输出
- 随机数
- Hooks
- Actions
- Filters
- 自定义Hooks
- 高级主题
- 管理菜单
- 顶级菜单
- 子菜单
- 短代码
- 基本短码
- 封闭短码
- 带参数的短代码
- TinyMCE增强型短码
- 设置
- 设置API
- 使用设置API
- 选项API
- 自定义设置页面
- 元数据
- 管理帖子元数据
- 自定义元数据
- 渲染元数据
- 自定义文章类型
- 注册自定义文章类型
- 使用自定义文章类型
- 分类
- 使用自定义分类
- 在WP 4.2+中使用“split术语”
- 用户
- 创建和管理用户
- 使用用户元数据
- 角色和功能
- HTTP API
- JavaScript
- jQuery
- Ajax
- 服务器端PHP和入队
- Heartbeat API
- 概要
- 计划任务
- 了解WP-Cron计划
- 安排WP-Cron 事件
- 将WP-Cron挂接到系统任务计划程序中
- WP-Cron简单测试
- 国际化
- 本地化
- 如何国际化您的插件
- 国际化安全
- WordPress.org
- 详细插件指南
- 规划您的插件
- 如何使用Subversion
- 插件开发者常见问题
- 开发工具
- Debug Bar 和附加组件
- 辅助插件
- REST API手册
- 资源
- 文章
- 文章修订
- 文章类型
- 文章状态
- 类别
- 标签
- 页面
- 评论
- 分类
- 媒体
- 用户
- 设置
- 使用REST API
- 全局参数
- 分页
- 链接和嵌入
- 发现
- 认证
- 经常问的问题
- 骨干JavaScript客户端
- 客户端库
- 扩展REST API
- 添加自定义端点
- 自定义内容类型
- 修改回应
- 模式
- 词汇表
- 路由和端点
- 控制器类