Retrieving the post count for a category is a common requirement in WordPress theme development. This article presents several standard and practical approaches to accomplish this task.
Get Post Count for the Current Category
On category archive pages (e.g., category.php), you can directly access the post count for the category being viewed.
<?php
global $wp_query;
$cat_ID = get_query_var('cat');
$category = get_category($cat_ID);
echo $category->count;
?>Code Explanation:
get_query_var('cat')retrieves the category ID for the current category page.get_category($cat_ID)fetches the category object based on the ID.$category->countis a property of the category object containing the post count.
The category object also includes other useful properties like $category->slug, $category->name, and $category->term_id.
Get Post Count for a Specific Category
These methods allow you to retrieve the post count for any category from any page or template.
Method 1: Using get_category()
This is the most direct and recommended approach. Get the category object by ID and read its count property.
<?php
// Replace `cat_ID` with your target category ID
$category = get_category(cat_ID);
echo $category->count;
?>Method 2: Using get_category_by_slug()
Use this method if you know the category slug.
<?php
// Replace 'category-name' with your category slug
$category = get_category_by_slug('category-name');
if ($category) {
echo $category->count;
}
?>Note: Always check if $category exists to avoid errors from invalid slugs.
Method 3: Using get_posts()
Query all posts in the category and count them. This is more flexible but has higher performance overhead.
<?php
$args = array(
'category' => 3, // Category ID
'posts_per_page' => -1, // Get all posts
'fields' => 'ids', // Get only post IDs for better performance
);
$posts = get_posts($args);
echo count($posts);
?>Method 4: Direct Database Query (Advanced)
For high-performance needs or complex logic, you can query the database directly. Here's a secure, encapsulated function:
<?php
function wt_get_category_count($input = '') {
global $wpdb;
if (empty($input)) {
// Called within the main loop, returns count of first category
$category = get_the_category();
return (isset($category[0])) ? $category[0]->count : 0;
} elseif (is_numeric($input)) {
// Input is a category ID
$SQL = $wpdb->prepare(
"SELECT count FROM {$wpdb->term_taxonomy} WHERE term_id = %d AND taxonomy = 'category'",
$input
);
return $wpdb->get_var($SQL);
} else {
// Input is a category slug
$SQL = $wpdb->prepare(
"SELECT tt.count FROM {$wpdb->terms} AS t INNER JOIN {$wpdb->term_taxonomy} AS tt ON t.term_id = tt.term_id WHERE t.slug = %s AND tt.taxonomy = 'category'",
$input
);
return $wpdb->get_var($SQL);
}
}
?>Usage: Add this code to your theme's functions.php file, then call it in your templates:
// 1. Call within the main loop (no parameter)
<?php echo wt_get_category_count(); ?>
// 2. Pass a category ID
<?php echo wt_get_category_count(1); ?>
// 3. Pass a category slug
<?php echo wt_get_category_count('hello-world'); ?>Key Improvement: This code uses $wpdb->prepare() to prevent SQL injection and specifies taxonomy = 'category' to ensure only post categories are queried.
Summary
For most use cases, Method 1 (get_category()) is recommended. It's concise, efficient, and uses standard WordPress core functions, ensuring the best compatibility and maintainability. Consider other methods only when querying by slug or performing complex custom queries.