WordPress自定义文章类型及其分类法显示教程

碧海醫心
发布: 2025-11-22 13:41:02
原创
616人浏览过

WordPress自定义文章类型及其分类法显示教程

本教程详细介绍了如何在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后台创建一个新的“成员”文章,并在右侧的“我的分类”元框中为其分配一个或多个分类项。如果没有“我的分类”元框,请检查您的分类法注册代码是否有误,或尝试刷新固定链接。

BlessAI
BlessAI

Bless AI 提供五个独特的功能:每日问候、庆祝问候、祝福、祷告和名言的文本生成和图片生成。

BlessAI 89
查看详情 BlessAI

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; 
?>
登录后复制

代码解释:

  1. get_the_ID(): 获取当前文章的ID。
  2. 'my_categories': 这是您在register_taxonomy()函数中定义的自定义分类法的唯一标识符(slug)。
  3. get_the_terms(): 返回一个WP_Term对象数组,如果文章没有分配该分类法的分类项,则返回false或WP_Error对象。
  4. !empty($categories) && !is_wp_error($categories): 这是一个重要的检查,确保$categories变量中确实包含了有效的分类项。
  5. foreach ($categories as $cat): 遍历每个分类项。$cat是一个WP_Term对象,您可以访问其属性,如$cat->name(分类名称)、$cat->slug(分类别名)等。
  6. get_term_link($cat->term_id, 'my_categories'): 生成指向该分类项归档页面的链接。
  7. 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网站。

以上就是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号