WordPress后台添加自定义字段,如:电话、公司名称等

在 WordPress 中,如果你想在后台“设置”菜单的“常规”页面中添加自定义字段,经常会有一些公共的系统参数字段,比如手机号、备案号、QQ、邮箱等,如果把这些公共字段写在主题里,修改维护就不是很方便了,wordpress自身又没有这些字段表单,可以通过在主题的 functions.php 文件中添加代码来实现。这个过程包括两部分:添加自定义字段保存字段的值

以下是具体的实现步骤和代码示例:

functions.php 中添加自定义字段

functions.php 文件中,*先需要创建一个钩子来将自定义字段添加到“常规设置”页面:

/**
 * 在常规设置里添加自定义字段
 */
function set_global_seo() {
    // 实例化 GlobalSeo 类并调用 setting_fields 方法
    $global_seo = new GlobalSeo();
    $global_seo->setting_fields();
}
// 使用 'admin_init' 钩子在后台管理系统初始化时调用 set_global_seo 函数
add_action('admin_init', 'set_global_seo');

class GlobalSeo
{
    // 定义并注册多个设置字段
    public function setting_fields()
    {
        // 文本输入框字段的键值对(key 是字段的 ID,value 是页面上显示的标签)
        $text_input = [
            'contact' => '联系人',
            'email' => '邮箱',
            'address' => '地址',
            'phone' => '电话',
            'wechat' => '微信',
            'qq' => 'QQ',
            'copyright' => '备案号',
            'seo_title' => 'SEO 标题',
            'seo_keywords' => 'SEO 关键字',
        ];

        // 文本区域字段
        $textarea_input = ['seo_description' => 'SEO 描述'];

        // 遍历 $text_input 数组,添加和注册文本输入字段
        foreach ($text_input as $key => $val) {
            $this->tmc_settings_field($key, $val, 'tmc_textbox_callback', [$key]);
            $this->tmc_register_setting($key);
        }

        // 遍历 $textarea_input 数组,添加和注册文本区域字段
        foreach ($textarea_input as $key => $val) {
            $this->tmc_settings_field($key, $val, 'tmc_textareabox_callback', [$key]);
            $this->tmc_register_setting($key);
        }
    }

    /**
     * 添加设置字段
     * @param string $id 设置字段的 ID
     * @param string $title 显示在页面上的标题 (label)
     * @param string $callback 回调函数,用于生成表单字段
     * @param array $args 回调函数的参数
     */
    public function tmc_settings_field($id, $title, $callback, $args)
    {
        // 添加设置字段到指定的设置页面和区域
        add_settings_field(
            $id,
            $title,
            [$this, $callback],  // 调用类的回调方法
            'general',           // 字段添加到常规设置页面
            'default',           // 所属的设置区块(这里是默认的区块)
            $args                // 回调函数的参数
        );
    }

    /**
     * 注册设置字段
     * @param string $id 设置字段的 ID
     */
    public function tmc_register_setting($id)
    {
        // 在 WordPress 中注册设置,允许保存和读取这些字段的值
        register_setting('general', $id);
    }

    /**
     * 文本输入框的回调函数
     * @param array $args 字段的参数(例如字段 ID)
     */
    public function tmc_textbox_callback($args) {
        // 获取已保存的设置值
        $option = get_option($args[0]);
        // 输出文本输入框
        echo '<input type="text" id="'. $args[0] .'" name="'. $args[0] .'" value="' . $option . '" class="regular-text" />';
    }

    /**
     * 文本区域的回调函数
     * @param array $args 字段的参数(例如字段 ID)
     */
    public function tmc_textareabox_callback($args) {
        // 获取已保存的设置值
        $option = get_option($args[0]);
        // 输出文本区域
        echo '<textarea id="'. $args[0] .'" name="'. $args[0] .'" class="regular-text">'. $option .'</textarea>';
    }
}

功能概述:

  1. set_global_seo():使用 admin_init 钩子来在 WordPress 后台初始化时调用此函数,创建自定义设置字段。
  2. GlobalSeo:包含添加和注册自定义设置字段的逻辑。
    • setting_fields():定义并调用两个数组,分别用于文本输入框和文本区域字段,调用相关方法来在 WordPress 设置页面上添加这些字段。
    • tmc_settings_field():将自定义字段添加到常规设置页面。
    • tmc_register_setting():注册字段,以便 WordPress 能够保存和读取这些字段的值。
    • tmc_textbox_callback()tmc_textareabox_callback():用于生成输入框和文本区域的 HTML,并显示已保存的值。

这个代码*终会在 WordPress 的“常规”设置页面中生成多个 SEO 和联系信息相关的输入字段。

WordPress 后端设置

下面是在wordpress常规设置添加自定义字段后的效果图

wordpress常规设置添加自定义字段

WordPress 前台如何调用?

前台主题里调用标签  <?php echo get_option(‘seo_title’); ?>,seo_title为您的自定义字段名。

滚动至顶部
扫描微信二维码联系我们 关闭