本教程详细介绍了如何在WordPress中为自定义文章类型（Custom Post Type, CPT）创建并正确显示自定义分类法（Custom Taxonomy）。文章涵盖了自定义文章类型和分类法的注册、关键参数配置（包括重写规则），以及如何在单篇自定义文章模板中利用`get_the_terms()`函数替代标准`the_category()`函数，以确保自定义分类法术语能够被准确获取和展示。
在WordPress开发中，自定义文章类型（CPT）和自定义分类法（Custom Taxonomy）是扩展网站功能、组织内容不可或缺的工具。它们允许开发者创建高度定制化的内容结构，例如“产品”、“成员”或“活动”等，并为这些内容定义独特的分类体系。然而，初学者在尝试显示自定义分类法术语时，常会遇到一些挑战，特别是当错误地使用适用于标准文章分类的函数时。本教程将引导您完成从注册到显示的完整过程。
一、 注册自定义文章类型 (Custom Post Type)
首先，我们需要注册一个自定义文章类型。以“成员（Members）”为例，我们将在functions.php文件中添加以下代码。请注意，这里我们引入了query_var和rewrite参数，并建议在开发阶段使用flush_rewrite_rules()来确保URL重写规则的更新。
function members_post_type() {
$args = array(
'labels' => array(
'name' => '成员',
'singular_name' => '成员',
'all_items' => '所有成员'
),
'public' => true,
'has_archive' => true,
'supports' => array('title', 'editor', 'thumbnail'),
'menu_icon' => 'dashicons-groups',
'query_var' => true, // 允许通过查询变量访问
'rewrite' => array('slug' => 'members'), // 定义URL重写规则
);
register_post_type('members', $args);
// 注意：flush_rewrite_rules(false) 应仅在注册CPT或分类法后执行一次，
// 不应在每次页面加载时运行。通常在主题激活或插件激活时调用。
// 在开发阶段，为方便测试，可以暂时放在这里，但部署前应移除或妥善处理。
flush_rewrite_rules(false);
}
add_action('init', 'members_post_type');关键参数解释：
- labels: 定义了管理界面中显示的各种文本标签。
- public: 设置为true使CPT在前端可见，并允许通过URL访问。
- has_archive: 设置为true为CPT启用归档页面。
- supports: 定义CPT支持的编辑器功能，例如标题、内容编辑器、特色图片等。
- menu_icon: 设置CPT在WordPress后台菜单中的图标。
- query_var: 设为true后，WordPress会创建一个查询变量，以便您可以使用WP_Query来查询此CPT。
- rewrite: 定义了此CPT的URL重写规则。例如，'slug' => 'members'意味着单篇成员文章的URL可能形如yourdomain.com/members/post-name/。
- flush_rewrite_rules(false): 这个函数用于更新WordPress的URL重写规则。当您注册新的CPT或分类法时，WordPress需要知道如何处理这些新的URL结构。重要提示： 这个函数会消耗资源，不应该在每次页面加载时都调用。通常，它只在主题激活或插件激活时调用一次，或者在开发过程中手动刷新。
二、 注册自定义分类法 (Custom Taxonomy)
接下来，我们将为“成员”CPT注册一个自定义分类法。为了避免与WordPress内置的“分类（Categories）”混淆，我们建议使用一个独特的名称，例如“我的分类（My Categories）”，并为其指定一个唯一的别名（slug）。
function members_taxonomys() {
$args = array(
'label' => '我的分类', // 在管理界面显示的标签
'public' => true,
'hierarchical' => true, // 设置为true使其像常规分类一样具有层级结构
'rewrite' => array('slug' => 'my_categories'), // 定义URL重写规则
);
// 注册分类法 'my_categories' 并将其关联到 'members' 文章类型
register_taxonomy('my_categories', array('members'), $args);
}
add_action('init', 'members_taxonomys');关键参数解释：
- label: 在WordPress管理界面中显示的分类法名称。
- public: 设置为true使其在前端可见。
- hierarchical: 设置为true允许此分类法像标准分类一样拥有父子层级结构；如果设置为false，则像标签一样没有层级。
- rewrite: 定义了此分类法的URL重写规则。
- register_taxonomy('my_categories', array('members'), $args): 第一个参数是分类法的唯一别名（slug），第二个参数是此分类法将关联的CPT或文章类型数组。
三、 创建内容并分配自定义分类法术语
完成上述注册后，请在WordPress后台：
- 导航到“成员” -> “添加新成员”。
- 在右侧边栏，您应该会看到一个新的元框，标题为“我的分类”。
- 创建一些分类法术语（例如，“管理层”、“技术团队”、“销售团队”），并将它们分配给您创建的成员文章。
四、 在单篇自定义文章模板中显示自定义分类法术语
这是最关键的一步。WordPress的the_category()函数专门用于显示标准文章的分类。对于自定义分类法，您需要使用get_the_terms()函数来获取分配给当前文章的分类法术语。
在您的single-members.php模板文件（如果不存在，请创建它）中，使用以下代码来显示“我的分类”下的术语：
<?php if (have_posts()) : ?>
<?php while (have_posts()) : the_post(); ?>
<h1><?php the_title(); ?></h1>
<?php the_content(); ?>
<?php
// 获取当前文章的 'my_categories' 分类法术语
$categories = get_the_terms(get_the_ID(), 'my_categories');
if (!empty($categories) && !is_wp_error($categories)) {
echo '<h3>我的分类:</h3>';
echo '<ul>';
foreach ($categories as $cat) {
// $cat 是一个 WP_Term 对象
// 可以访问 $cat->name (名称), $cat->slug (别名), $cat->term_id (ID) 等属性
echo '<li><a href="' . get_term_link($cat->term_id, 'my_categories') . '">' . esc_html($cat->name) . '</a></li>';
}
echo '</ul>';
}
?>
<?php endwhile; ?>
<?php endif; ?>代码解释：
- get_the_terms(get_the_ID(), 'my_categories'):
- get_the_ID(): 获取当前循环中的文章ID。
- 'my_categories': 这是您在register_taxonomy()函数中定义的自定义分类法的唯一别名（slug）。
- !empty($categories) && !is_wp_error($categories): 这是一个重要的检查，确保get_the_terms()函数成功返回了结果，并且没有发生WordPress错误。
- foreach ($categories as $cat): 遍历获取到的所有分类法术语。每个$cat变量都是一个WP_Term对象，包含了该术语的所有信息。
- $cat->name: 访问分类法术语的名称。
- get_term_link($cat->term_id, 'my_categories'): 生成指向该分类法术语归档页面的链接。
五、 注意事项与最佳实践
- 分类法别名（Slug）的唯一性： 确保您的自定义分类法别名是唯一的，并且不要与WordPress内置的分类法（如category或post_tag）冲突。
- flush_rewrite_rules()的调用时机： 如前所述，这个函数不应该在每次页面加载时运行。最佳实践是在主题激活、插件激活或更新CPT/分类法注册代码后，手动访问WordPress后台的“设置” -> “固定链接”页面，点击“保存更改”按钮，这也会自动刷新重写规则。
- 错误处理： 总是对get_the_terms()等可能返回空值或WP_Error对象的函数进行检查，以避免页面出现PHP警告或错误。
- 链接生成： 使用get_term_link()而不是手动构建链接，可以确保链接的正确性和兼容性。
- 安全性： 在输出任何动态内容时，使用esc_html()等WordPress的转义函数，以防止跨站脚本（XSS）攻击。
总结
通过遵循本教程的步骤，您将能够成功地为自定义文章类型注册自定义分类法，并将其术语正确地显示在您的WordPress网站前端。关键在于理解the_category()和get_the_terms()之间的区别，并正确配置自定义文章类型和分类法的参数，特别是URL重写规则。掌握这些技能将极大地提升您在WordPress中构建复杂内容结构的能力。
