WordPress自定义文章类型中显示自定义分类法术语的完整指南

碧海醫心

发布时间：2025-11-23 11:41:01

919人浏览过

来源于php中文网

原创

WordPress自定义文章类型中显示自定义分类法术语的完整指南

本教程详细指导如何在wordpress自定义文章类型（cРТ）中正确定义和显示自定义分类法术语。文章将涵盖自定义分类法的注册、刷新重写规则的注意事项，以及如何使用`get_the_terms()`函数替代`the_category()`来在单篇文章页面上有效展示自定义分类信息，避免常见错误。

在WordPress开发中，自定义文章类型（Custom Post Types, CPT）和自定义分类法（Custom Taxonomies）是扩展网站功能的强大工具。然而，许多开发者在尝试显示自定义分类法术语时，可能会遇到诸如the_category()函数无法正常工作的问题。本文将提供一个全面的指南，演示如何正确地注册自定义文章类型和自定义分类法，并在单篇文章页面上准确地展示它们关联的分类术语。

1. 正确注册自定义文章类型和自定义分类法

为了确保自定义分类法能够被正确识别和使用，其注册过程需要一些关键的细节。一个常见的错误是自定义分类法的名称与WordPress内置的分类法名称冲突，或者在显示时使用了错误的函数。

首先，我们来定义一个名为“Members”的自定义文章类型和一个名为“My Categories”的自定义分类法。

// 将以下代码添加到你的主题的 functions.php 文件或自定义插件中

/**
 * 注册自定义文章类型：成员 (Members)
 */
function register_members_cpt() {
    $labels = array(
        'name'          => 'Members',
        'singular_name' => 'Member',
        'all_items'     => 'All members',
    );

    $args = array(
        'labels'        => $labels,
        'public'        => true,
        'has_archive'   => true,
        'supports'      => array('title', 'editor', 'thumbnail'),
        'menu_icon'     => 'dashicons-groups',
        'query_var'     => true, // 确保查询变量可用
        'rewrite'       => array('slug' => 'members'), // 定义URL重写规则
        // 'hierarchical' => true, // 如果需要父子关系，可启用
    );
    register_post_type('members', $args);
}
add_action('init', 'register_members_cpt');

/**
 * 注册自定义分类法：我的分类 (My Categories)
 */
function register_my_categories_taxonomy() {
    $labels = array(
        'name'                       => 'My Categories',
        'singular_name'              => 'My Category',
        'menu_name'                  => 'My Categories',
        'all_items'                  => 'All My Categories',
        'parent_item'                => 'Parent My Category',
        'parent_item_colon'          => 'Parent My Category:',
        'new_item_name'              => 'New My Category Name',
        'add_new_item'               => 'Add New My Category',
        'edit_item'                  => 'Edit My Category',
        'update_item'                => 'Update My Category',
        'view_item'                  => 'View My Category',
        'separate_items_with_commas' => 'Separate my categories with commas',
        'add_or_remove_items'        => 'Add or remove my categories',
        'choose_from_most_used'      => 'Choose from the most used my categories',
        'popular_items'              => 'Popular My Categories',
        'search_items'               => 'Search My Categories',
        'not_found'                  => 'Not Found',
        'no_terms'                   => 'No my categories',
        'items_list'                 => 'My Categories list',
        'items_list_navigation'      => 'My Categories list navigation',
    );

    $args = array(
        'labels'            => $labels,
        'public'            => true,
        'hierarchical'      => true, // 设为true表示是层级分类（如常规分类），false表示标签式（如常规标签）
        'show_ui'           => true,
        'show_admin_column' => true, // 在文章列表页显示此分类
        'query_var'         => true,
        'rewrite'           => array('slug' => 'my-categories'), // 定义URL重写规则
    );
    // 'my_categories' 是自定义分类法的内部名称（slug），必须是唯一的。
    // array('members') 表示这个分类法适用于 'members' 这个自定义文章类型。
    register_taxonomy('my_categories', array('members'), $args);
}
add_action('init', 'register_my_categories_taxonomy');

注意事项：

自定义分类法名称 (Slug): 在 register_taxonomy() 函数中，第一个参数 'my_categories' 是自定义分类法的唯一标识符（slug）。它应该避免与WordPress内置的分类法（如category或post_tag）以及其他插件或主题定义的分类法冲突。
标签 (Label): 在 $args 数组中设置 labels 参数，可以为后台管理界面提供更友好的显示名称。
刷新重写规则 (flush_rewrite_rules()): 这个函数用于更新WordPress的URL重写规则。在开发过程中，当你注册或修改了自定义文章类型或分类法时，可能需要运行一次此函数，以确保新的URL结构生效。然而，在生产环境中，不应将其直接放置在 init 钩子中，因为它会消耗资源并可能导致性能问题。更推荐的做法是在主题激活、插件激活/停用时调用它，或者手动访问WordPress后台的“设置” -youjiankuohaophpcn “固定链接”页面并保存一次，WordPress会自动刷新重写规则。

2. 创建自定义文章并分配分类术语

在完成上述代码后，请确保在WordPress后台：

导航到“成员” -> “添加新成员”。
创建一个新的成员文章。
在文章编辑界面的右侧，你会看到一个名为“My Categories”的区块。在这里，你可以创建新的分类术语并将其分配给当前的成员文章。

3. 在单篇文章页面显示自定义分类法术语

现在，最关键的一步是在自定义文章类型 members 的单篇文章模板文件 (single-members.php) 中显示这些自定义分类法术语。

吉卜力风格图片在线生成

将图片转换为吉卜力艺术风格的作品

下载

the_category() 函数是为WordPress内置的 category 分类法设计的，因此它无法用于显示自定义分类法术语。我们需要使用 get_the_terms() 函数来获取当前文章的自定义分类法术语。

在你的 single-members.php 文件中，可以这样修改代码：

<?php
if (have_posts()) :
    while (have_posts()) : the_post();
        // 显示文章标题和内容
        the_title('<h1>', '</h1>');
        the_content();

        // 获取当前文章的 'my_categories' 分类法术语
        // 第一个参数是文章对象或文章ID，第二个参数是自定义分类法的slug
        $categories = get_the_terms(get_the_ID(), 'my_categories');

        // 检查是否有分类术语，并且不是WordPress错误对象
        if (!empty($categories) && !is_wp_error($categories)) {
            echo '<h2>Assigned My Categories:</h2>';
            echo '<ul>';
            foreach ($categories as $cat) {
                // $cat 是一个 WP_Term 对象，包含 term_id, name, slug 等属性
                // 为了更好的用户体验，可以为分类术语添加链接
                $term_link = get_term_link($cat->term_id, 'my_categories');
                if (!is_wp_error($term_link)) {
                    echo '<li><a href="' . esc_url($term_link) . '">' . esc_html($cat->name) . '</a></li>';
                } else {
                    echo '<li>' . esc_html($cat->name) . '</li>';
                }
            }
            echo '</ul>';
        } else {
            echo '<p>No custom categories assigned.</p>';
        }

    endwhile;
endif;
?>

代码说明：

get_the_terms(get_the_ID(), 'my_categories'): 这个函数是获取文章自定义分类术语的关键。
- get_the_ID() 获取当前循环中的文章ID。
- 'my_categories' 是我们在 register_taxonomy() 中定义的自定义分类法的唯一标识符（slug）。
错误处理和空值检查: !empty($categories) && !is_wp_error($categories) 这一行非常重要。它确保 $categories 变量不为空，并且不是一个WordPress错误对象，从而避免在没有分类术语或发生错误时导致页面崩溃。
遍历显示: 如果获取到了分类术语，我们通过 foreach 循环遍历 $categories 数组。每个 $cat 变量都是一个 WP_Term 对象，你可以访问它的 name (显示名称)、slug (URL别名)、term_id 等属性。
esc_html($cat->name): 使用 esc_html() 函数对输出内容进行转义，这是一个良好的安全实践，可以防止XSS攻击。
添加链接: 为了提升用户体验，我们使用 get_term_link() 函数为每个分类术语生成一个指向其归档页面的链接。