本教程详细介绍了如何在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模板中显示“我的分类”项的正确方法：
<?php
if (have_posts()) :
while (have_posts()) : the_post();
?>
<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
<header class="entry-header">
<h1><?php the_title(); ?></h1>
</header>
<div class="entry-content">
<?php the_content(); ?>
<?php
// 获取当前文章的 'my_categories' 分类项
$categories = get_the_terms(get_the_ID(), 'my_categories');
// 检查是否获取到分类项
if (!empty($categories) && !is_wp_error($categories)) {
echo '<div class="member-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="' . esc_url(get_term_link($cat->term_id, 'my_categories')) . '">' . esc_html($cat->name) . '</a></li>';
}
echo '</ul>';
echo '</div>';
} else {
echo '<p>暂无所属分类。</p>';
}
?>
</div><!-- .entry-content -->
<footer class="entry-footer">
<?php edit_post_link('编辑', '<span class="edit-link">', '</span>'); ?>
</footer>
</article><!-- #post-## -->
<?php
endwhile;
endif;
?>代码解释：
- get_the_ID(): 获取当前文章的ID。
- 'my_categories': 这是您在register_taxonomy()函数中定义的自定义分类法的唯一标识符（slug）。
- get_the_terms(): 返回一个WP_Term对象数组，如果文章没有分配该分类法的分类项，则返回false或WP_Error对象。
- !empty($categories) && !is_wp_error($categories): 这是一个重要的检查，确保$categories变量中确实包含了有效的分类项。
- foreach ($categories as $cat): 遍历每个分类项。$cat是一个WP_Term对象，您可以访问其属性，如$cat->name（分类名称）、$cat->slug（分类别名）等。
- get_term_link($cat->term_id, 'my_categories'): 生成指向该分类项归档页面的链接。
- esc_url()和esc_html(): 用于安全输出URL和HTML内容，防止XSS攻击。
6. 注意事项与最佳实践
- 分类法Slug的唯一性： 确保您的自定义分类法slug（如my_categories）是全局唯一的，避免与WordPress内置的分类法或其他插件的分类法冲突。
- 刷新重写规则： 如前所述，每次注册或修改CPT/CT的rewrite规则后，都需要刷新固定链接。在开发阶段，最安全的方法是手动访问“设置”->“固定链接”页面并保存。在生产环境中，这通常只在主题/插件激活时通过代码执行一次。
- 错误处理： 始终检查get_the_terms()的返回值，确保它不是空的或WP_Error对象，以避免PHP警告或错误。
- 性能考量： get_the_terms()在循环中被调用是高效的，因为它会利用WordPress的缓存机制。
- CSS样式： 输出的分类项列表可以通过CSS进行样式化，以适应您的主题设计。
总结
通过本教程，您应该已经掌握了在WordPress中创建自定义文章类型和自定义分类法，并能够正确地在单篇文章模板中显示这些自定义分类项。关键在于使用get_the_terms()函数而非the_category()，并理解其参数和返回值。遵循这些步骤和最佳实践，将帮助您构建更加灵活和强大的WordPress网站。
