在WordPress主题开发和定制化过程中，灵活调用特定分类ID下的内容是一项核心技能。以下系统介绍7种从基础到高级的实现方法，适用于不同场景需求。

方法1：WP_Query类(最强大推荐)

特点：功能最完整、参数最丰富，支持分页和复杂查询，是官方推荐的标准方式。

基本使用方法

<?php
$args = array(
    'cat'              => 5,           // 指定分类ID
    'posts_per_page'   => 10,          // 显示数量
    'orderby'          => 'date',      // 排序字段
    'order'            => 'DESC',      // 降序排列
    'post_status'      => 'publish'    // 已发布文章
);

$query = new WP_Query($args);

if ($query->have_posts()) {
    while ($query->have_posts()) {
        $query->the_post();
        the_title('<h2>', '</h2>');
        the_excerpt();
    }
} else {
    echo '<p>没有找到文章</p>';
}

wp_reset_postdata(); // 重置查询数据
?>

多分类查询技巧

// 包含多个分类中的任意一个
'category__in' => array(2, 5, 12),

// 必须同时属于这些分类
'category__and' => array(2, 5),

// 排除特定分类
'category__not_in' => array(3, 7),

适用场景：主题模板文件、创建多个独立查询、需要分页功能时。

方法2：get_posts()函数(简洁版)

特点：WP_Query的简化封装，返回文章数组而非对象，适合简单查询。

基础用法

<?php
$posts = get_posts(array(
    'category'      => 5,      // 分类ID
    'numberposts'   => 5,      // 获取数量(-1为全部)
    'orderby'       => 'date',
    'order'         => 'DESC',
    'post_type'     => 'post'
));

if ($posts) {
    foreach ($posts as $post) {
        setup_postdata($post);
        echo '<h3><a href="' . get_permalink() . '">' . get_the_title() . '</a></h3>';
    }
    wp_reset_postdata();
}
?>

适用场景：侧边栏小工具、简单文章列表、不需要分页时。

方法3：query_posts()函数(修改主循环)

特点：直接修改全局主查询，不推荐使用，但在旧主题中常见。

基本用法

<?php
// 警告：此方法会改变主循环，使用后必须重置
query_posts('cat=5&posts_per_page=10');

if (have_posts()) {
    while (have_posts()) {
        the_post();
        the_title();
    }
}

// 必须重置查询
wp_reset_query();
?>

注意事项：此方法会覆盖页面原始查询，可能导致分页和条件标签失效，建议优先使用WP_Query。

方法4：pre_get_posts钩子(修改主查询)

特点：在查询执行前修改参数，推荐用于分类归档页等需要修改主查询的场景。

在functions.php中添加

// 修改分类ID为5的存档页显示数量
function modify_category_query($query) {
    if (!is_admin() && $query->is_main_query() && $query->is_category(5)) {
        $query->set('posts_per_page', 15);
        $query->set('orderby', 'date');
    }
}
add_action('pre_get_posts', 'modify_category_query');

适用场景：修改分类存档页、标签页等主查询行为，不影响其他查询。

方法5：category-{id}.php模板文件(原生支持)

特点：利用WordPress模板层级，为特定分类创建专属模板。

实现步骤

在主题目录创建文件 category-5.php(5为分类ID)

或创建 category-news.php(news为分类别名/slug)

WordPress会自动使用该模板显示对应分类内容

模板示例

<?php get_header(); ?>

<h1><?php single_cat_title(); ?></h1>
<?php echo category_description(); ?>

<?php if (have_posts()) : ?>
    <?php while (have_posts()) : the_post(); ?>
        <article>
            <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
            <?php the_excerpt(); ?>
        </article>
    <?php endwhile; ?>
    <?php the_posts_pagination(); ?>
<?php endif; ?>

<?php get_footer(); ?>

适用场景：需要为特定分类设计独特布局和样式时。

方法6：自定义短代码(编辑器调用)

特点：在文章/页面编辑器中通过 [category_posts id=”5″] 快速调用。

在functions.php中添加

function display_category_posts_shortcode($atts) {
    $atts = shortcode_atts(array(
        'category_id'    => '',
        'posts_per_page' => 5,
        'orderby'        => 'date',
        'order'          => 'DESC'
    ), $atts);

    if (empty($atts['category_id'])) {
        return '<p>请提供分类ID</p>';
    }

    ob_start();
    $query = new WP_Query(array(
        'cat'              => $atts['category_id'],
        'posts_per_page'   => $atts['posts_per_page'],
        'orderby'          => $atts['orderby'],
        'order'            => $atts['order']
    ));

    if ($query->have_posts()) {
        echo '<ul class="category-posts-list">';
        while ($query->have_posts()) {
            $query->the_post();
            echo '<li><a href="' . get_permalink() . '">' . get_the_title() . '</a></li>';
        }
        echo '</ul>';
    } else {
        echo '<p>没有找到相关文章</p>';
    }

    wp_reset_postdata();
    return ob_get_clean();
}
add_shortcode('category_posts', 'display_category_posts_shortcode');

使用方式

[category_posts category_id="5" posts_per_page="10"]

适用场景：非技术人员需要灵活在内容中插入分类文章列表。

方法7：REST API方式(现代开发)

特点：前后端分离、无刷新加载，适合现代Web应用和移动端。

使用端点URL

https://wodepress.com/wp-json/wp/v2/posts?categories=5&per_page=10

JavaScript调用示例

// 获取分类ID为5的最新文章
fetch('https://wodepress.com/wp-json/wp/v2/posts?categories=5&per_page=10')
    .then(response => response.json())
    .then(posts => {
        const container = document.getElementById('posts-container');
        posts.forEach(post => {
            container.innerHTML += `
                <article>
                    <h3><a href="${post.link}">${post.title.rendered}</a></h3>
                    <div>${post.excerpt.rendered}</div>
                </article>
            `;
        });
    })
    .catch(error => console.error('Error:', error));

适用场景：SPA应用、AJAX加载、移动端API调用。

方法选择对比表

方法	优点	缺点	推荐度	适用场景
WP_Query	功能最强大、支持分页	代码稍多	⭐⭐⭐⭐⭐	主题开发、复杂查询
get_posts	简洁、易用	不支持分页	⭐⭐⭐⭐	简单列表、侧边栏
query_posts	直接修改主循环	破坏主查询、不推荐	⭐	旧主题维护
pre_get_posts	优雅修改主查询	仅影响主循环	⭐⭐⭐⭐⭐	存档页定制
category-{id}.php	WordPress原生支持	需创建模板文件	⭐⭐⭐⭐	分类页定制
短代码	编辑器灵活调用	性能略低	⭐⭐⭐⭐	内容编辑
REST API	前后端分离	需JavaScript基础	⭐⭐⭐⭐	现代应用开发

高级技巧与最佳实践

1. 性能优化

// 禁用SQL_CALC_FOUND_ROWS提高性能
'no_found_rows' => true,

// 只获取需要的字段
'fields' => 'ids',

// 使用缓存
'cache_results' => true,

2. 获取分类ID的技巧

// 通过分类别名获取ID
$cat_id = get_cat_ID('新闻资讯');

// 在分类页自动获取当前ID
$cat_id = get_queried_object_id();

// 通过文章获取所属分类
$categories = get_the_category();
if ($categories) {
    $cat_id = $categories[0]->term_id;
}

3. 获取子分类内容

// 获取父分类下的所有子分类ID
$child_cats = get_categories(array(
    'parent' => 5,
    'hide_empty' => false
));
$child_ids = wp_list_pluck($child_cats, 'term_id');

// 查询包含子分类
$args = array(
    'category__in' => array_merge([5], $child_ids)
);

4. 排除特定分类

// 排除ID为3和7的分类
'category__not_in' => array(3, 7),

重要提示：修改代码前请备份网站，建议在子主题中进行开发，避免主题更新后代码丢失。

通过以上7种方法，可以根据具体需求选择最合适的方案。对于新开发项目，强烈推荐使用WP_Query或pre_get_posts钩子，它们提供了最佳的灵活性和性能表现。

wordpress调用指定ID分类