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

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

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

首先看下我要定制的这个后台功能截图:
WordPress后台定制-通用字段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 本站记录了近几年的工作中遇到的一些技术问题和解决过程,“作品集”还收录了本人的大部分作品展示。除了本博客外,我们的工作室网站 – JennyStudio,内有更多作品回顾和展示。
您也可以扫描左边的二维码,关注我们的微信公众号,在微信上查看我们的案例。

1 关于 “WordPress后台定制-通用字段option的添加和调用” 的评论

发表评论

电子邮件地址不会被公开。 必填项已用*标注