在WordPress构建的网站上我们经常要定义一些全站通用的数据，比如联系方式、公司简介等，这些数据可能会在网站的任何地方被调用，比如首页、相关内页、每个页面的头部和底部等。个人喜欢称这样的数据为通用字段。既然叫通用字段，顾名思义就是存在于数据库里的一条可以被随处调用的数据，WordPress的options表提供了这样的便利。需要注意的是通用字段和自定义字段的概念区别，前者保存在options表中，而自定义字段则保存在postmeta表中。options表一般用来保存一些网站全局设置和插件设置，而保存自定义字段的postmeta表则保存的是用于和文章、页面、菜单等关联的字段。
WordPress封装好的操作options表最重要的函数就是 update_option ，本文通过一个最简单的实例介绍通用字段的操作。
首先看下我要定制的这个后台功能截图：
如图，在后台的Settings主菜单下增加一个Custom Setting子菜单。具体的设置页面只有两个字段，Site Intro和Phone Number。这是最简单的自定义设置页面了，下面开始代码：
1. 通过add_submenu_page函数给Settiings菜单下增加一栏：
1 2 3 4 | 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. 详细的设置界面
以下就是第一步回调的执行函数，包含所有页面的内容和保存功能
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 | 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等：
1 2 3 4 5 | echo get_option( 'blogname' ); //在General设置里填写的网站名称 echo get_option( 'siteurl' ); //在General设置里填写的网站地址 echo get_option( 'admin_email' ); //安装WordPress时填写的管理员邮箱 echo get_option( 'template' ); //当前调用的主题名称 //... |
具体可以看看get_option的官方文档
本站所有文章均为原创，欢迎转载，请注明文章出处：https://blog.brain1981.com/1122.html。百度和各类采集站皆不可信，搜索请谨慎鉴别。技术类文章一般都有时效性，本人习惯不定期对自己的博文进行修正和更新，因此请访问出处以查看本文的最新版本。
本站记录了近几年的工作中遇到的一些技术问题和解决过程，“作品集”还收录了本人的大部分作品展示。除了本博客外，我们的工作室网站 – JennyStudio，内有更多作品回顾和展示。您也可以扫描左边的二维码，关注我们的微信公众号，在微信上查看我们的案例。
卧槽，竟然是技术博~学习了~