WordPress自定义文章类型中显示自定义分类法术语的完整指南

碧海醫心
发布: 2025-11-23 11:41:01
原创
887人浏览过

WordPress自定义文章类型中显示自定义分类法术语的完整指南

本教程详细指导如何在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后台:

  1. 导航到“成员” -> “添加新成员”。
  2. 创建一个新的成员文章。
  3. 在文章编辑界面的右侧,你会看到一个名为“My Categories”的区块。在这里,你可以创建新的分类术语并将其分配给当前的成员文章。

3. 在单篇文章页面显示自定义分类法术语

现在,最关键的一步是在自定义文章类型 members 的单篇文章模板文件 (single-members.php) 中显示这些自定义分类法术语。

绘蛙-多图成片
绘蛙-多图成片

绘蛙新推出的AI图生视频工具

绘蛙-多图成片 133
查看详情 绘蛙-多图成片

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中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号