
本文旨在解决WordPress自定义分类法归档页面不显示内容的问题。核心在于指导开发者如何利用WordPress内置的模板层级结构,特别是taxonomy.php或taxonomy-{slug}.php模板,来正确地渲染自定义分类法下的文章列表,而非通过手动创建页面并进行复杂的自定义查询。文章将详细阐述正确的模板文件命名、内容结构以及避免常见错误,确保分类筛选功能按预期工作。
在WordPress中,当用户访问一个自定义分类法的归档页面时(例如,yourdomain.com/taxonomy-slug/term-slug),WordPress会按照特定的模板层级顺序查找并加载相应的模板文件来显示内容。这个层级结构是WordPress强大而灵活的核心之一。
对于自定义分类法归档页面,WordPress的查找顺序大致如下:
理解这一层级至关重要,因为它意味着我们不需要为每个分类项或分类法创建独立的页面文件(如pdf_cat.php),WordPress会自动处理URL路由和主查询。
原始的实现尝试通过以下方式显示分类过滤结果:
这里存在几个主要问题:
要正确实现自定义分类法的归档页面,我们应遵循WordPress的模板层级结构。
原始代码中的下拉菜单已经正确使用了get_term_link($term->term_id)来生成分类法归档链接。这是正确的做法。例如,如果你的自定义分类法是pdf_cat,并且有一个分类项名为“报告”,其slug为report,那么get_term_link()可能会生成类似https://yourdomain.com/pdf_cat/report/的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', // 假设你的自定义分类法是 'pdf_cat'
'hide_empty' => false,
]);
foreach( $terms as $term ){
// get_term_link() 会生成正确的分类法归档URL
echo '<option class="ctg" value="'. get_term_link($term->term_id) .' ">' . $term->name . '</option>';
}
?>
</div>
</select>JavaScript部分也保持不变,它负责监听下拉菜单的变化并跳转到相应的URL:
<script type="text/javascript">
$("#form").change(function(){
var url = $(this).val();
location.assign(url);
});
</script>根据自定义分类法的slug,在你的主题根目录下创建一个名为taxonomy-{taxonomy-slug}.php的文件。在你的案例中,如果自定义分类法slug是pdf_cat,那么文件应命名为taxonomy-pdf_cat.php。
示例:taxonomy-pdf_cat.php文件内容
<?php get_header(); ?>
<div id="primary" class="content-area">
<main id="main" class="site-main">
<?php if ( have_posts() ) : ?>
<header class="page-header">
<?php
// 获取当前分类法对象
$term = get_queried_object();
if ( $term && is_a( $term, 'WP_Term' ) ) {
echo '<h1 class="page-title">' . esc_html( $term->name ) . '</h1>';
if ( ! empty( $term->description ) ) {
echo '<div class="taxonomy-description">' . wp_kses_post( $term->description ) . '</div>';
}
} else {
echo '<h1 class="page-title">分类归档</h1>';
}
?>
</header><!-- .page-header -->
<?php
/* Start the Loop */
while ( have_posts() ) : the_post();
// 在这里包含你的文章内容模板部分
// 例如:get_template_part( 'template-parts/content', get_post_type() );
// 或者直接在这里输出文章标题和摘要
?>
<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(); ?>
</div><!-- .entry-content -->
</article><!-- #post-<?php the_ID(); ?> -->
<?php
endwhile;
// 分页导航
the_posts_pagination( array(
'prev_text' => __( '上一页', 'your-text-domain' ),
'next_text' => __( '下一页', 'your-text-domain' ),
'before_page_number' => '<span class="meta-nav screen-reader-text">' . __( '页', 'your-text-domain' ) . ' </span>',
) );
else :
// 如果没有找到文章
get_template_part( 'template-parts/content', 'none' );
endif;
?>
</main><!-- #main -->
</div><!-- #primary -->
<?php get_sidebar(); ?>
<?php get_footer(); ?>在这个taxonomy-pdf_cat.php文件中,我们直接使用了WordPress的主循环(have_posts()和the_post())。WordPress已经根据URL中的分类法和分类项,自动设置了主查询,因此无需再使用WP_Query或query_posts()。get_queried_object()函数能够安全地获取当前查询的分类法对象,方便显示分类标题和描述。
确认你的自定义文章类型(例如pdf)已经正确注册,并且与自定义分类法(pdf_cat)关联。这通常在注册自定义文章类型时通过'taxonomies' => array('pdf_cat')参数或使用register_taxonomy_for_object_type()函数来完成。
解决WordPress自定义分类法归档页面不显示内容的问题,关键在于理解并遵循WordPress的模板层级结构。通过创建正确的taxonomy-{taxonomy-slug}.php模板文件,并利用WordPress自动设置的主查询,可以高效且正确地显示分类筛选后的文章列表。避免手动创建独立页面并进行复杂的自定义查询,能够让你的WordPress开发更加健壮和符合最佳实践。
以上就是WordPress 自定义分类法归档页面的正确实现与调试的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号