WordPress后台定制-通用字段option的添加和调用

美工学习 · 发表于 2023-12-1 22:02:37

亲注册登录道勤网-可以查看更多帖子内容哦！（包涵精彩图片、文字详情等）请您及时注册登录-www.daoqin.net

您需要登录才可以下载或查看，没有账号？立即注册

x

在 wordpress构建的网站上我们经常要定义一些全站通用的数据，比如联系方式、公司简介等，这些数据可能会在网站的任何地方被调用，比如首页、相关内页、每个页面的头部和底部等。个人喜欢称这样的数据为通用字段。既然叫通用字段，顾名思义就是存在于数据库里的一条可以被随处调用的数据，WordPress的options表提供了这样的便利。需要注意的是通用字段和自定义字段的概念区别，前者保存在options表中，而自定义字段则保存在postmeta表中。options表一般用来保存一些网站全局设置和插件设置，而保存自定义字段的postmeta表则保存的是用于和文章、页面、菜单等关联的字段。

WordPress封装好的操作options表最重要的函数就是 update_option ，本文通过一个最简单的实例介绍通用字段的操作。

首先看下我要定制的这个后台功能截图：

如图，在后台的Settings主菜单下增加一个Custom Setting子菜单。具体的设置页面只有两个字段，Site Intro和Phone Number。这是最简单的自定义设置页面了，下面开始代码：

1. 通过add_submenu_page函数给Settiings菜单下增加一栏：

add_action('admin_menu', 'options_admin_menu');
function options_admin_menu(){
add_submenu_page( 'options-general.php','Custom Setting', 'Custom Setting', 'administrator', 'custom-setting', 'customSetting' );
}

复制代码

注意其中“options-general.php”指定了新增的子菜单添加在Settings主菜单下，如果要把菜单增加到其他地方，比如Tools主菜单下，换成”tools.php”，即可。更多选择请参考add_submenu_page的官方文档点这里。
点击新增子菜单，页面地址就会跳转到/wp-admin/options-general.php?page=custom-setting
这里的custom-setting也是参数之一，可以自行命名。
最后一个参数customSetting是回调函数，后面会提到。

2. 详细的设置界面

以下就是第一步回调的执行函数，包含所有页面的内容和保存功能

function customSetting(){ ?>
<div class="wrap">
<h2>Custom Setting</h2>
<?php
if ($_POST['update_options']=='true') {//若提交了表单，则保存变量
update_option('site-intro', $_POST['site-intro']);
update_option('phone-number', $_POST['phone-number']);
//若值为空，则删除这行数据
if( empty($_POST['site-intro']) ) delete_option('site-intro' );
if( empty($_POST['phone-number']) ) delete_option('phone-number' );
echo '<div id="message" class="updated below-h2"><p>Saved!</p></div>';//保存完毕显示文字提示
}
//下面开始界面表单
?>
<form method="POST" action="">
<input type="hidden" name="update_options" value="true" />
<table class="form-table">
<tr>
<th scope="row">Site Intro:</th>
<td><input type="text" name="site-intro" id="site-intro" value="<?php echo get_option('site-intro'); ?>" /></td>
</tr>
<tr>
<th scope="row">Phone Number:</th>
<td><input type="text" name="phone-number" id="phone-number" value="<?php echo get_option('phone-number'); ?>" /></td>
</tr>
</table>
<p><input type="submit" class="button-primary" name="admin_options" value="Update"/></p>
</form>
</div>
<?php
add_action('admin_menu', 'customSetting');
}

复制代码

以上两段代码复制到主题的functions.php内即可。

update_option函数只有两个参数，使用起来确很灵活。首先，如果数据库的options表中没有名称为“site-intro”数据，而我用

update_option('site-intro', $_POST['site-intro']);

复制代码

这条命令就可以在数据库自动创建这条数据，并且设置成我想要的值，而无需先做有没有数据的判断。

如果要删除一条options数据，只要用delete_option即可：

delete_option( 'site-intro' );

复制代码

delete_option的官方文档点这里。

最后，在前台调用option也很简单，用get_option即可：

echo get_option( 'site-intro' );

复制代码

通常我们还会用get_option命令取出一些WordPress默认带有的变量，比如网站名称、网站URL等：

echo get_option( 'blogname' ); //在General设置里填写的网站名称
echo get_option( 'siteurl' ); //在General设置里填写的网站地址
echo get_option( 'admin_email' ); //安装WordPress时填写的管理员邮箱
echo get_option( 'template' ); //当前调用的主题名称
//...

复制代码

具体可以看看get_option的官方文档

道勤主机提供365天*24小时全年全天无休、实时在线、零等待的售后技术支持。竭力为您免费处理您在使用道勤主机过程中所遇到的一切问题! 如果您是道勤主机用户，那么您可以通过QQ【792472177】、售后QQ【59133755】、旺旺【诠释意念】、微信：q792472177免费电话、后台提交工单这些方式联系道勤主机客服！如果您不是我们的客户也没问题，点击页面最右边的企业QQ在线咨询图标联系我们并购买后，我们为您免费进行无缝搬家服务，让您享受网站零访问延迟的迁移到道勤主机的服务！