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

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

在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的官方文档

页: [1]
查看完整版本: WordPress后台定制-通用字段option的添加和调用