本教程详细介绍了如何在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模板中显示“我的分类”项的正确方法：
>
';
echo '所属分类:
';
echo '';
foreach ($categories as $cat) {
// $cat 是一个 WP_Term 对象
// 您可以访问 $cat->name (名称), $cat->slug (别名), $cat->term_id (ID) 等属性
echo '- ' . esc_html($cat->name) . '
';
}
echo '
';
echo '';
} else {
echo '暂无所属分类。
';
}
?>
