本教程详细指导如何在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() 函数为每个分类术语生成一个指向其归档页面的链接。
总结与最佳实践
通过遵循上述步骤，你现在应该能够在WordPress自定义文章类型中成功地定义和显示自定义分类法术语了。为了确保你的WordPress项目健壮且易于维护，请牢记以下最佳实践：
- 唯一性: 确保自定义分类法的slug是唯一的，以避免与WordPress
以上就是WordPress自定义文章类型中显示自定义分类法术语的完整指南的详细内容，更多请关注php中文网其它相关文章！