首页>建站相关>wp添加自定义字段函数

wp添加自定义字段函数

通过api内容自动发布一篇文章,遗留了最后一个问题,为文章添加一个自定义字段,添加自定义字段有两个函数可以选择,一个是add_post_meta,另一个是update_post_meta,顾名思义,前者是添加一个,而后者是更新数据之用。但因为update_post_meta首先会检查指定的post_id的meta_key是否已经存在,如果不存在,则会调用add_post_meta,并返回其结果。所以对于性能要求不高的情况下,直接用update_post_meta取代add_post_meta也是可以的,数据比较多的时候,那自然是步骤越简洁越好。

add_post_meta函数

简介

add_post_meta会添加一个一个自定义字段到指定的日志,或者页面中。如果$unique参数被设置为true,并且指定的键值已经存在,那么这个函数返回false并且不对现有的字段做任何修改,否则添加字段并返回true。但$unique设置为false的话,会导致键值不唯一的情况,当使用update_post_meta更新数值时,如果不另行指定指定键的原有值,会导致同名键的值同时被修改,也算是一个安全隐患吧。

用法

<?php add_post_meta($post_id, $meta_key, $meta_value, $unique); ?>

参数

$post_id

(integer) (required) 将要添加自定义字段的日志 ID。
Default: None

$meta_key

(string) (required) 将要添加自定义字段的名称(key)。
Default: None

$meta_value

(mixed) (required) 将要添加自定义字段的值,如果是一个数组,将会被序列化成字符串。
Default: None

$unique

(boolean) (optional) 设置当前的 key 是否为唯一的,当设置为 true,将保证当前日志没有以 $meta_key 作为 key 的自定义字段,并且如果已经存在,则添加不成功。
Default: false

返回值

(bool)
添加成功返回 true,否则返回 false。

用法实例

<?php add_post_meta(68, 'my_key', 47); ?>

添加一个“隐藏”的自定义字段

默认情况下,你添加的自定义字段会在后台日志或者页面编辑器下面自定义区域显示,或者会被 the_meta() 函数可以调用,但是如果你是一个 WordPress 插件或者主题开发者,打算使用自定义字段来存储一些数据,并且不希望用户能够自己修改它,你可以通过给自定义字段的 key 以下划线(“_”)开始,则不会在后台显示。

<?php add_post_meta(68, '_color', 'red', true); ?>

比如上面实例就是添加了一个 key 名为 "_color" 值为 "red" 的自定义字段,这个字段将不会显示在在后台的日志或者页面的编辑页面。另外,如果 $meta_value 是一个数组,也不会显示在后台的日志或者页面的编辑页面。

update_post_meta函数

简介

根据日志 ID 来更新自定义字段。使用 $prev_value 参数来区分同样的 key 和日志 ID 的自定义字段。
如果指定的 $meta_key 不存在,则添加这个自定义字段。

用法

<?php update_post_meta($post_id, $meta_key, $meta_value, $prev_value); ?>

参数

主要参数同add_post_meta基本相同,需要特别注意的是这个参数:
$pre_value
(boolean) (optional) 将要修改的自定义字段原来的值,这是用来区分相同 key 的几个字段,如果省略了,则当前日志下指定 key 的多个值都将被更新。
Default: Empty

用法实例

<?php update_post_meta(76, 'thumb', 'wordpress_thumb.jpg'); ?>

其他实例

假设一个 ID 为 76 的日志,有下面四个自定义字段:

[key_1] => 'Happy'
[key_1] => 'Sad'
[key_2] => 'Gregory'
[my_key] => 'Steve'

将 key_2 的值修改成 'Hans':

<?php update_post_meta(76, 'key_2', 'Hans'); ?>

将 key_1 的值从 'Sad' 修改成 'Happy':

<?php update_post_meta(76, 'key_1', 'Happy', 'Sad'); ?>

现在的字段将如下所示:

[key_1] => 'Happy'
[key_1] => 'Happy'
[key_2] => 'Hans'
[my_key] => 'Steve'

字符转义

自定义字段在存储时通过stripslashes()函数传递,因此在传递可能包含“”转义字符的值(例如 JSON)时需要小心。

避免存储转义值

考虑JSON值{"key":"value with "escaped quotes""}

<?php
$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 passing through stripslashes() ends up unparsable:
{"key":"value with "escaped quotes""}
*/
?>

解决方法

通过使用函数(在 WP 3.6 中引入)添加更多级别的“”转义函数wp_slash,您可以补偿对 stripslashes() 的调用

<?php
$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 being stored as desired:
{"key":"value with "escaped quotes""}
*/
?>

标签: wordpress

移动端可扫我直达哦~

推荐阅读

wordpress 2025-04-07

wordpress主题目录穿越导致的bug

尝试从知乎的热榜api提取数据并保存到本地,隔几个小时刷新一次,前几天运行的好好的,这几天突然发现数据有几天没有更新了。手动刷新了一下数据获取页,一直提示无需更新,将文件下载到本地测试,功能又是完好的。开了wp的debug模式,修正了...

建站相关 wordpress

wordpress 2025-03-31

wordpress 重新生成缩略图

测试wp缩略图功能的时候不小心把所有的缩略图都删掉了,但保留了原图,不想一个个重新上传以生成缩略图,就使用了这段代码,注意生成成功之后,这段代码就可以删掉了。忽然想起之前钉钉宣传的某个功能,阅后即焚~~function regener...

建站相关 wordpress

wordpress 2025-03-29

WordPress的主循环与WP_Query

WordPress的主循环和WP_Query是主题开发中最重要的两个概念,它们负责从数据库获取内容并显示在页面上。主循环 (The Loop)主循环是WordPress用来显示文章的核心机制。它是一个PHP代码结构,用于遍历当前页面请...

建站相关 wordpress

wordpress 2025-03-22

在phpstudy中为wordpress开启伪静态

原文修改主题都是在服务器上一边在线修改一边调试,用上了phpstudy后才发现自己之前的方式有多没有效率。但测试设置固定链接的时候遇到了一个问题,就是设置前也无风雨也无晴,设置后统一返回404。这个问题之前尝试搭建站点的时候也遇到过,...

建站相关 wordpress

wordpress 2025-03-17

WordPress分页中遇到404错误:posts_per_page

这个问题可能更多为主题开发者所遇见,一款推向市场的主题一般都会几经测试,应该不容易到客户手中才发现这个问题。所以网络上的相关讨论不多,博主也是调试了几天才大致有了一些思路:后台的默认参数在wordpress的后台设置里,是可以设置归档...

建站相关 wordpress

wordpress 2025-03-14

WORDPRESS HEADER模块常用函数

在 WordPress 开发中,header.php 文件是主题的重要组成部分,用于定义网站的头部内容。以下是一些在 header.php 中常用的 WordPress 函数及其用途,如果嫌部分函数生成的默认模板不需要的元素过多,也可...

建站相关 wordpress

wordpress 2025-03-12

wordpress的前后台数据交换ajax

ajax是个耳熟能详的词儿,但因为有点儿复杂,博主一直是规避学习的,今天刚好碰到一个前台jquery向wp后台申请数据的问题。躲不过,那就慢慢调试吧。钩子wp的ajax还区分了用户,对于不同的用户(登录与否)采用不同的钩子,不过这里只...

建站相关 wordpress

wordpress 2025-03-07

WordPress中add_meta_box函数参数详解

add_meta_box 是 WordPress 中用于在后台编辑页面添加自定义元框(Meta Box)的函数。它允许开发者在文章、页面、自定义文章类型等编辑页面中添加自定义字段或内容。以下是 add_meta_box 函数的参数及其...

建站相关 wordpress

wordpress 2025-03-07

wordpress 手动添加自定义字段

自定义字段可以扩展文章的信息,也有很多相关的成熟的插件,比如Advanced Custom Fields (ACF) 插件,如果希望添加的字段不多,也不愿意为此安装过多的插件,我们也可以考虑手动来添加它。为post文章添加字段// 添...

建站相关 wordpress