本文详细探讨了在wordpress中，通过自定义分类筛选自定义文章类型时，归档页面内容无法正确显示的问题。核心解决方案是利用wordpress强大的模板层级机制，特别是`taxonomy.php`或`taxonomy-{slug}.php`模板文件，来自动处理分类归档页面的查询和内容展示，避免手动构建复杂且易错的查询逻辑。
在WordPress开发中，为自定义文章类型（Custom Post Type, CPT）创建自定义分类法（Custom Taxonomy）并允许用户通过分类进行筛选，是常见的需求。然而，许多开发者在尝试实现这一功能时，可能会遇到归档页面无法正确显示筛选结果的问题。这通常是由于对WordPress模板层级和主查询机制理解不足导致的。
原始的实现尝试通过一个下拉菜单选择自定义分类，然后使用JavaScript将用户重定向到一个名为pdf_cat.php的自定义页面。在这个页面中，开发者试图手动获取分类信息并构建一个新的WP_Query来显示筛选后的文章。
具体来看，原始代码中存在以下几个关键问题：
由于上述问题，pdf_cat.php页面无法正确识别用户所选的分类，也无法构建出正确的查询来显示文章。
WordPress提供了一套强大的模板层级机制来处理不同类型的页面，包括文章、页面、分类、标签、作者归档等。对于自定义分类归档页面，WordPress会按照特定的顺序查找模板文件：
当用户通过get_term_link()生成的URL访问一个自定义分类归档时，WordPress会根据这个层级自动加载最匹配的模板文件，并且主查询（Main Query）已经被预设为显示该分类下的所有文章。这意味着我们无需手动构建WP_Query。
我们将通过以下步骤来修正并实现自定义分类的筛选和展示：
这部分代码是正确的，它通过get_term_link($term->term_id)生成了正确的分类归档URL。
<select name="form" id="form">
<div class="options">
<option value="<?php echo home_url('/newsletter'); ?>" selected>一覧</option>
<?php
$args = array(
'orderby' => 'slug',
'order' => 'ASC',
'parent' => 0,
'hide_empty' => false
);
$terms = get_terms([
'taxonomy' => 'pdf_cat', // 假设你的自定义分类法slug是 'pdf_cat'
'hide_empty' => false,
]);
foreach( $terms as $term ){
echo '<option class="ctg" value="'. get_term_link($term->term_id) .' ">' . $term->name . '</option>';
}
?>
</div>
</select>这部分JavaScript代码也是正确的，它监听下拉菜单的change事件，并将浏览器重定向到所选分类的URL。
<script type="text/javascript">
$("#form").change(function(){
var url = $(this).val();
location.assign(url);
});
</script>这是最关键的一步。我们需要创建一个符合WordPress模板层级规则的模板文件。建议创建taxonomy-pdf_cat.php（如果pdf_cat是你的自定义分类法slug），这样它只会影响这个特定的分类归档。如果希望所有自定义分类都使用相同的模板，可以创建taxonomy.php。
在这个模板文件中，我们不再需要手动构建WP_Query或调用get_the_terms()。WordPress的主查询已经准备好。
代码示例：taxonomy-pdf_cat.php
<?php
/**
* Template Name: Custom Taxonomy Archive for PDF Category
* Description: Displays posts from the 'pdf' custom post type filtered by 'pdf_cat' taxonomy.
*/
get_header(); // 引入主题头部文件
?>
<div id="primary" class="content-area">
<main id="main" class="site-main">
<?php
// 获取当前查询的分类对象
$queried_object = get_queried_object();
if ( $queried_object && is_a( $queried_object, 'WP_Term' ) ) {
echo '<h1 class="page-title">' . esc_html( $queried_object->name ) . ' 分类归档</h1>';
echo '<div class="taxonomy-description">' . wpautop( $queried_object->description ) . '</div>';
}
?>
<?php if ( have_posts() ) : ?>
<div class="pdf-list-container">
<?php
// 循环遍历主查询中的文章
while ( have_posts() ) : the_post();
// 这里放置显示每篇文章的HTML结构
// 例如，可以包含一个模板部分来显示文章摘要
?>
<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
<header class="entry-header">
<?php the_title( '<h2 class="entry-title"><a href="' . esc_url( get_permalink() ) . '" rel="bookmark">', '</a></h2>' ); ?>
</header><!-- .entry-header -->
<div class="entry-content">
<?php the_excerpt(); // 显示文章摘要 ?>
<a href="<?php the_permalink(); ?>" class="read-more">阅读更多</a>
</div><!-- .entry-content -->
</article><!-- #post-<?php the_ID(); ?> -->
<?php endwhile; ?>
</div>
<?php
// 显示分页导航
the_posts_pagination( array(
'prev_text' => __( '上一页', 'textdomain' ),
'next_text' => __( '下一页', 'textdomain' ),
) );
else :
// 如果没有找到文章
get_template_part( 'template-parts/content', 'none' );
endif;
?>
</main><!-- #main -->
</div><!-- #primary -->
<?php
get_sidebar(); // 引入主题侧边栏文件 (如果需要)
get_footer(); // 引入主题底部文件
?>代码说明：
通过利用WordPress的模板层级，特别是创建taxonomy-{taxonomy-slug}.php文件，我们可以让WordPress自动处理自定义分类归档页面的文章查询和显示逻辑。这种方法不仅代码量更少、更易维护，而且符合WordPress的最佳实践，避免了手动构建复杂查询可能带来的问题。理解并遵循WordPress的核心机制，是构建健壮、高效主题的关键。
以上就是WordPress自定义分类归档页面显示问题及解决方案的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
982
收藏
