本教程详细指导如何在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后台的“设置” -> “固定链接”页面并保存一次，WordPress会自动刷新重写规则。
2. 创建自定义文章并分配分类术语
在完成上述代码后，请确保在WordPress后台：
导航到“成员” -> “添加新成员”。创建一个新的成员文章。在文章编辑界面的右侧，你会看到一个名为“My Categories”的区块。在这里，你可以创建新的分类术语并将其分配给当前的成员文章。
3. 在单篇文章页面显示自定义分类法术语
现在，最关键的一步是在自定义文章类型 members 的单篇文章模板文件 (single-members.php) 中显示这些自定义分类法术语。
the_category() 函数是为WordPress内置的 category 分类法设计的，因此它无法用于显示自定义分类法术语。我们需要使用 get_the_terms() 函数来获取当前文章的自定义分类法术语。
在你的 single-members.php 文件中，可以这样修改代码：
<?phpif (have_posts()) : while (have_posts()) : the_post(); // 显示文章标题和内容 the_title('', '
'); the_content(); // 获取当前文章的 'my_categories' 分类法术语 // 第一个参数是文章对象或文章ID，第二个参数是自定义分类法的slug $categories = get_the_terms(get_the_ID(), 'my_categories'); // 检查是否有分类术语，并且不是WordPress错误对象 if (!empty($categories) && !is_wp_error($categories)) { echo 'Assigned My Categories:
'; echo '- '; 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 '
- ' . esc_html($cat->name) . ' '; } else { echo '
- ' . esc_html($cat->name) . ' '; } } echo '
No custom categories assigned.
'; } 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中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1338127.html
微信扫一扫 
支付宝扫一扫 
