代码实现WordPress分类目录和标签添加新的自定义字段

2015-12-01 22:39:51 WordPress后台定制 , ,

WordPress 的分类目录默认只有名称、别名、父节点和描述这几个字段，有时候我们需要给分类目录拓展一些信息，如想添加一个分类封面图、给分类指定 keywords 和 description 等等，这个时候我们就得给分类目录添加自定义字段（或者叫自定义栏目）。本文将给你介绍如何给 WordPress 的分类目录和标签添加新的自定义字段。

下图是 WordPress 后台的分类目录编辑页面，有心的读者可能注意到，这里多了个分类封面的输入框，这个就是我们所说的给分类目录添加的自定义字段。

代码实现分类加字段

将下面的 PHP 代码复制粘贴到你当前主题的 function.php 中即可。以下代码只给分类目录添加自定义字段，如果需要给标签添加自定义字段，请看文章后面的讲解。

这部分代码包括 4 大块：调用 WordPress 的 action；新建分类页面添加自定义字段输入框；编辑分类页面添加自定义字段输入框；保存自定义字段的数据。这里只创建一个分类封面的 URL 输入框。如果要添加更多的自定义字段，也只需在代码中几个 TODO 的位置上追加一些代码而已，代码中也给出添加 keywords 字段的示例。

所有自定义字段保存在 WordPress 的 _options 表中，无需建新的表。

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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

<?php
 
class Fanly_Tax_Image{
 
    function __construct(){
 
        // 新建分类页面添加自定义字段输入框
        add_action( 'category_add_form_fields', array( $this, 'add_tax_image_field' ) );
        // 编辑分类页面添加自定义字段输入框
        add_action( 'category_edit_form_fields', array( $this, 'edit_tax_image_field' ) );
 
        // 保存自定义字段数据
        add_action( 'edited_category', array( $this, 'save_tax_meta' ), 10, 2 );
        add_action( 'create_category', array( $this, 'save_tax_meta' ), 10, 2 );
 
 
    } // __construct
 
    /**
     * 新建分类页面添加自定义字段输入框
     */
    public function add_tax_image_field(){
    ?>
        <div class="form-field">
            <label for="term_meta[tax_image]">分类封面</label>
            <input type="text" name="term_meta[tax_image]" id="term_meta[tax_image]" value="" />
            <p class="description">输入分类封面图片URL</p>
        </div><!-- /.form-field -->
 
        <!-- TODO: 在这里追加其他自定义字段表单，如： -->
 
        <!--
        <div class="form-field">
            <label for="term_meta[tax_keywords]">分类关键字</label>
            <input type="text" name="term_meta[tax_keywords]" id="term_meta[tax_keywords]" value="" />
            <p class="description">输入分类关键字</p>
        </div>
        -->
    <?php
    } // add_tax_image_field
 
    /**
     * 编辑分类页面添加自定义字段输入框
     *
     * @uses get_option()       从option表中获取option数据
     * @uses esc_url()          确保字符串是url
     */
    public function edit_tax_image_field( $term ){
 
        // $term_id 是当前分类的id
        $term_id = $term->term_id;
 
        // 获取已保存的option
        $term_meta = get_option( "Fanly_taxonomy_$term_id" );
        // option是一个二维数组
        $image = $term_meta['tax_image'] ? $term_meta['tax_image'] : '';
 
        /**
         *   TODO: 在这里追加获取其他自定义字段值，如：
         *   $keywords = $term_meta['tax_keywords'] ? $term_meta['tax_keywords'] : '';
         */
    ?>
        <tr class="form-field">
            <th scope="row">
                <label for="term_meta[tax_image]">分类封面</label>
                <td>
                    <input type="text" name="term_meta[tax_image]" id="term_meta[tax_image]" value="<?php echo esc_url( $image ); ?>" />
                    <p class="description">输入分类封面图片URL</p>
                </td>
            </th>
        </tr><!-- /.form-field -->
 
        <!-- TODO: 在这里追加其他自定义字段表单，如： -->
 
        <!--
        <tr class="form-field">
            <th scope="row">
                <label for="term_meta[tax_keywords]">分类关键字</label>
                <td>
                    <input type="text" name="term_meta[tax_keywords]" id="term_meta[tax_keywords]" value="<?php echo $keywords; ?>" />
                    <p class="description">输入分类关键字</p>
                </td>
            </th>
        </tr>
        -->
 
    <?php
    } // edit_tax_image_field
 
    /**
     * 保存自定义字段的数据
     *
     * @uses get_option()      从option表中获取option数据
     * @uses update_option()   更新option数据，如果没有就新建option
     */
    public function save_tax_meta( $term_id ){
 
        if ( isset( $_POST['term_meta'] ) ) {
 
            // $term_id 是当前分类的id
            $t_id = $term_id;
            $term_meta = array();
 
            // 获取表单传过来的POST数据，POST数组一定要做过滤
            $term_meta['tax_image'] = isset ( $_POST['term_meta']['tax_image'] ) ? esc_url( $_POST['term_meta']['tax_image'] ) : '';
 
            /**
             *   TODO: 在这里追加获取其他自定义字段表单的值，如：
             *   $term_meta['tax_keywords'] = isset ( $_POST['term_meta']['tax_keywords'] ) ? $_POST['term_meta']['tax_keywords'] : '';
             */
 
            // 保存option数组
            update_option( "Fanly_taxonomy_$t_id", $term_meta );
 
        } // if isset( $_POST['term_meta'] )
    } // save_tax_meta
 
} // Fanly_Tax_Image
 
$wptt_tax_image = new Fanly_Tax_Image();

如果需要在主题中调用分类自定义字段的值，可以使用以下代码：

1
2
3
4
5
6
7
8

// $term_id 是当前分类的id，自行想办法获取
$term_id = $term->term_id;
 
// 获取已保存的option
$term_meta = get_option( "Fanly_taxonomy_$term_id" );
 
// 取值
$tax_image = $term_meta['tax_image'] ? $term_meta['tax_image'] : '';

全代码实现标签加字段

给标签添加自定义字段的原理是一样的，只需把上面第一部分代码中的 action 修改一下即可，将以上代码中的：

1
2
3
4
5
6
7
8

// 新建分类页面添加自定义字段输入框
add_action( 'category_add_form_fields', array( $this, 'add_tax_image_field' ) );
// 编辑分类页面添加自定义字段输入框
add_action( 'category_edit_form_fields', array( $this, 'edit_tax_image_field' ) );
 
// 保存自定义字段数据
add_action( 'edited_category', array( $this, 'save_tax_meta' ), 10, 2 );
add_action( 'create_category', array( $this, 'save_tax_meta' ), 10, 2 );

改成：

1
2
3
4
5
6

// 其实就是把 category 改成 post_tag 即可
add_action( 'post_tag_add_form_fields', array( $this, 'add_tax_image_field' ) );
add_action( 'post_tag_edit_form_fields', array( $this, 'edit_tax_image_field' ) );
 
add_action( 'edited_post_tag', array( $this, 'save_tax_meta' ), 10, 2 );
add_action( 'create_post_tag', array( $this, 'save_tax_meta' ), 10, 2 );

另外，也可以同时给分类目录和标签添加自定义字段：

1
2
3
4
5
6
7
8
9
10
11
12

// 分类
add_action( 'category_add_form_fields', array( $this, 'add_tax_image_field' ) );
add_action( 'category_edit_form_fields', array( $this, 'edit_tax_image_field' ) );
add_action( 'edited_category', array( $this, 'save_tax_meta' ), 10, 2 );
add_action( 'create_category', array( $this, 'save_tax_meta' ), 10, 2 );
 
 
// 标签
add_action( 'post_tag_add_form_fields', array( $this, 'add_tax_image_field' ) );
add_action( 'post_tag_edit_form_fields', array( $this, 'edit_tax_image_field' ) );
add_action( 'edited_post_tag', array( $this, 'save_tax_meta' ), 10, 2 );
add_action( 'create_post_tag', array( $this, 'save_tax_meta' ), 10, 2 );
发表评论
登录后参与评论
leixue
管理

122文章总数

最新：WordPress 用户文章数量统计函数 count_user_posts
专注 WordPress 网站优化解决方案！ 加入我们

了解更多

用户支持

联系我们

法律信息

Copyright © 2010-2024 ZHAN.LEIUE.COM. All Rights Reserved. 泪雪公司 版权所有