通过add_submenu_page函数给Settiings菜单下增加一栏:

1
2
3
4
5
6
7
8
9
10
11
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是回调函数,后面会提到。

详细的设置界面

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

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
33
34
35
36
37
38
39
40
41
42
43
44
45
//服务时间和电话微博全局参数设置
add_action('admin_menu', 'options_admin_menu');
function options_admin_menu(){
add_submenu_page( 'options-general.php','联系方式设置', '联系方式设置', 'administrator', 'custom-setting', 'customSetting' );
}
function customSetting(){ ?>
<div class="wrap">
<h2>联系方式设置</h2>
<small>网站主题联系方式设置相关设置</small>
<?php
if ($_POST['update_options']=='true') {//若提交了表单,则保存变量
update_option('fuwushijian', $_POST['fuwushijian']);
update_option('lianxidianhua', $_POST['lianxidianhua']);
update_option('sinaweibo', $_POST['sinaweibo']);
//若值为空,则删除这行数据
if( empty($_POST['fuwushijian']) ) delete_option('fuwushijian' );
if( empty($_POST['lianxidianhua']) ) delete_option('lianxidianhua' );
if( empty($_POST['sinaweibo']) ) delete_option('sinaweibo' );
echo '<div id="message" class="updated below-h2"><p>保存完毕!</p></div>';
//保存完毕显示文字提示
}
//下面开始界面表单
?>
<form method="POST" action="">
<input type="hidden" name="update_options" value="true" />
<table class="form-table">
<tr>
<th scope="row">服务时间:</th>
<td><input type="text" name="fuwushijian" id="fuwushijian" value="<?php echo get_option('fuwushijian'); ?>" /></td>
</tr>
<tr>
<th scope="row">联系电话:</th>
<td><input type="text" name="lianxidianhua" id="lianxidianhua" value="<?php echo get_option('lianxidianhua'); ?>" /></td>
</tr>
<tr>
<th scope="row">新浪微博:</th>
<td><input type="text" name="sinaweibo" id="sinaweibo" value="<?php echo get_option('sinaweibo'); ?>" /></td>
</tr>
</table>
<p><input type="submit" class="button-primary" name="admin_options" value="保存"/></p>
</form>
</div>
<?php
add_action('admin_menu', 'customSetting');
}

在前台调用

1
echo get_option( 'fuwushijian' );

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

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

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

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

如果要删除一条options数据,只要用delete_option即可:

1
delete_option( 'site-intro' );

最后,在前台调用option也很简单,用get_option即可:

1
echo get_option( 'site-intro' );

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

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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
$ parent_slug
(string)(必需)父菜单的文件名(或标准WordPress管理页的文件名)。
$ page_title
(string)(必需)选择菜单时要显示在页面的标题标记中的文本。
$ menu_title
(string)(必需)用于菜单的文本。
$能力
(string)(必需)将此菜单显示给用户所需的功能。
$ menu_slug
(string)(必需)引用此菜单的段名称(对于此菜单应该是唯一的)。
$ function
(callable)(可选)要调用以输出此页面的内容的函数。

add_submenu_page( string $parent_slug, string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '' )