wordpress 的自定义字段就是文章的 Meta 信息(元信息),利用这个功能,可以扩展文章的功能,是学习 wordpress 插件开发和主题深度开发的必备知识,方便给文章储存一些额外的自定义内容。
自定义字段不光给插件开发者使用,wordpress 的特色图像、自定义页面模板等功能的信息都储存在自定义字段的表单里边。
在文章编辑器界面的 “自定义栏目” 板块可以管理除了名字开头是 “_” 的字段(没有 “自定义栏目” 板块请在右上角的 “显示选项” 开启),所以很多 wordpress 自己使用的自定义字段无法在此管理。
存储原理
自定义字段非常灵活,首先来说一下它的储存原理和为什么这么灵活。数据库中,储存文章的 wp_posts 表单,只有默认的 20 个项目,用于储存必须的文章信息。
而存储自定义字段的 wp_postMeta 表,却只有四个项目,分别是 Meta_id(自定义字段的 ID)、post_id(自定义字段属于的文章的 ID)、Meta_key(自定义字段的名字)和 Meta_value(自定义字段的值),一般我们只需要注意 Meta_key 和 Meta_value 两个项目即可。
正是因为这样,每篇文章都可以有相同名字但不同值的自定义字段,而且可以有无限个自定义字段,任何的插件和主题都可以利用自定义字段对文章信息进行扩展。
添加字段
自定义字段可以在文章编辑页面操作,但本文主要写关于开发的事情。
添加自定义字段,可以使用 add_post_Meta() 函数:
参数:
$post_id
默认值:None
$Meta_key
默认值:None
$Meta_value
(混合)(必须)自定义字段的值。
默认值:None
$unique
(布尔)(可选)如果已经有相同名字的字段,是否重复添加。True 允许;False 不允许。
默认值:False
更新字段
要更新一个字段的值,可以使用 update_post_Meta() 函数:
参数:
$post_id
默认值:None
$Meta_key
默认值:None
$Meta_value
(混合)(必须)更新的自定义字段的值。
默认值:None
$prev_value
(混合)(可选)此参数只有在一篇文章有多个相同名称的自定义字段时才有用。如果留空,则更新所有同名的字段,否则则更新和此参数值相同的值的字段。
默认值:空字符串
获取字段
获取字段可以使用 get_post_meta() 函数:
参数:
$post_id
(整数)(必须)要获取字段的文章 ID,如果在循环中,可以使用 get_the_ID() 来设置。
默认值:None
$key
默认值:None
$single
(布尔)(可选)如果为 True 则返回一个字符串;如果为 False 则返回数组,且相同键值的自定义字段的值会按照添加顺序组合成一个序列数组。
默认值:False
例子
下边是一个浏览统计的简单例子:
不可见的自定义字段
虽然在数据库里存在很多 wordpress 自己创建的自定义字段,但是在文章编辑器的 “自定义栏目” 里却并没有显示(没有 “自定义栏目” 板块请在右上角的 “显示选项” 开启),比如特色图像、自定义页面模板和评论是否开启等等。如果仔细观察,会发现这些自定义字段的名字都是以下划线 “_” 开头的,所以说,以下划线 “_” 开头的自定义字段并不会显示给用户,the_Meta() 函数也不会输出,对用户来说是隐藏的。
利用这个特性,我们可以把不想让用户随便修改的字段、会让用户感到困惑的字段,比如已经提供设置界面的设置选项、缓存数据等等,以免出现错误。
下边是一个小例子: