WordPress自定义文章类型及其分类法显示教程

程序猿 • 2025年12月12日 23:30:11 • 好文分享 • 阅读 0

本教程详细介绍了如何在wordpress中正确创建和管理自定义文章类型（custom post type）及其关联的自定义分类法（custom taxonomy）。文章将指导您完成注册这些自定义元素、为文章分配分类法，以及如何在单篇文章模板中利用`get_the_terms()`函数准确显示自定义分类法下的分类项，避免使用`the_category()`等标准函数可能导致的错误，并提供关键的注意事项。

1. 理解自定义文章类型与自定义分类法

WordPress的强大之处在于其可扩展性，自定义文章类型（Custom Post Type, CPT）和自定义分类法（Custom Taxonomy, CT）是实现高度定制化内容管理的关键。CPT允许您创建除文章、页面之外的全新内容类型，例如“产品”、“成员”或“活动”。而CT则允许您为这些CPT创建自定义的分类体系，类似于文章的“分类”和“标签”，但专属于您的自定义内容。

2. 注册自定义文章类型

首先，我们需要注册一个名为“成员”（members）的自定义文章类型。这通常在主题的functions.php文件或一个自定义插件中完成。

function register_members_post_type() {    $labels = array(        'name'          => '成员',        'singular_name' => '成员',        'all_items'     => '所有成员',        'add_new_item'  => '添加新成员',        'edit_item'     => '编辑成员',        'view_item'     => '查看成员',        'search_items'  => '搜索成员',        'not_found'     => '未找到成员',        'not_found_in_trash' => '回收站中未找到成员',    );    $args = array(        'labels'        => $labels,        'public'        => true,        'has_archive'   => true,        'supports'      => array('title', 'editor', 'thumbnail'), // 支持标题、编辑器、特色图片        'menu_icon'     => 'dashicons-groups', // 后台菜单图标        'hierarchical'  => false, // 是否支持层级结构（如页面）        'query_var'     => true, // 允许通过查询变量访问        'rewrite'       => array('slug' => 'members'), // 自定义URL重写规则    );    register_post_type('members', $args);}add_action('init', 'register_members_post_type');

在注册自定义文章类型后，为了确保URL重写规则生效，WordPress需要刷新一次。通常，在开发环境中，当您首次添加或修改CPT/CT注册代码后，访问WordPress后台的“设置”->“固定链接”页面并点击“保存更改”即可手动刷新重写规则。在代码中，不建议在init钩子中每次都调用flush_rewrite_rules(false);，因为它会增加服务器负载。此函数仅在插件激活或主题首次启用时调用一次即可。

3. 注册自定义分类法

接下来，为“成员”自定义文章类型注册一个自定义分类法，例如名为“我的分类”（my_categories）。

function register_members_taxonomy() {    $labels = array(        'name'                       => '我的分类',        'singular_name'              => '我的分类',        'menu_name'                  => '我的分类',        'all_items'                  => '所有我的分类',        'edit_item'                  => '编辑我的分类',        'view_item'                  => '查看我的分类',        'update_item'                => '更新我的分类',        'add_new_item'               => '添加新我的分类',        'new_item_name'              => '新我的分类名称',        'parent_item'                => '父级我的分类',        'parent_item_colon'          => '父级我的分类:',        'search_items'               => '搜索我的分类',        'popular_items'              => '热门我的分类',        'separate_items_with_commas' => '用逗号分隔我的分类',        'add_or_remove_items'        => '添加或移除我的分类',        'choose_from_most_used'      => '从常用我的分类中选择',        'not_found'                  => '未找到我的分类',    );    $args = array(        'labels'        => $labels,        'public'        => true,        'hierarchical'  => true, // 是否支持层级结构（如分类）        'show_ui'       => true, // 是否在后台显示用户界面        'show_admin_column' => true, // 是否在文章列表页显示分类列        'query_var'     => true, // 允许通过查询变量访问        'rewrite'       => array('slug' => 'my-categories'), // 自定义URL重写规则    );    // 将 'my_categories' 分类法关联到 'members' 文章类型    register_taxonomy('my_categories', array('members'), $args);}add_action('init', 'register_members_taxonomy');

重要提示：

register_taxonomy()的第一个参数是分类法的唯一标识符（slug），在这里是my_categories。这个slug在后续获取分类项时会用到。第二个参数array(‘members’)指定了该分类法将应用于哪些文章类型。

4. 为自定义文章类型分配分类项

在注册了自定义文章类型和分类法之后，您需要在WordPress后台创建一个新的“成员”文章，并在右侧的“我的分类”元框中为其分配一个或多个分类项。如果没有“我的分类”元框，请检查您的分类法注册代码是否有误，或尝试刷新固定链接。

5. 在单篇文章模板中显示自定义分类法项

当您尝试在single-members.php（或single.php）模板中使用the_category()函数来显示自定义分类法项时，会发现它不起作用。这是因为the_category()函数专用于显示标准文章的“分类”（category）分类法。

要显示自定义分类法（my_categories）的分类项，您需要使用get_the_terms()函数。此函数接受两个参数：文章ID和分类法slug。

以下是在single-members.php模板中显示“我的分类”项的正确方法：

    <article id="post-" >                    
        
                                <?php            // 获取当前文章的 'my_categories' 分类项            $categories = get_the_terms(get_the_ID(), 'my_categories');            // 检查是否获取到分类项            if (!empty($categories) && !is_wp_error($categories)) {                echo '';                echo '所属分类:
';                echo '';                foreach ($categories as $cat) {                    // $cat 是一个 WP_Term 对象                    // 您可以访问 $cat->name (名称), $cat->slug (别名), $cat->term_id (ID) 等属性                    echo 'term_id, 'my_categories')) . '">' . esc_html($cat->name) . '
';                }                echo '
';                echo '
';            } else {                echo '暂无所属分类。
';            }            ?>        
                    <?php edit_post_link('编辑', '', ''); ?>