WP_Query class in Wordpress - Mini Project: Build & Apply

Using the WP_Query Class to Display Recent Posts

📖 Scenario: You are building a WordPress theme and want to show a list of recent blog posts on the homepage.

🎯 Goal: Create a custom query using the WP_Query class to fetch the 5 most recent posts and display their titles in an unordered list.

📋 What You'll Learn

Create a WP_Query object with parameters to get 5 recent posts

Store the query parameters in a variable called $args

Use a while loop with $query->have_posts() and $query->the_post()

Output the post titles inside <li> tags within a <ul>

Reset post data after the loop with wp_reset_postdata()

💡 Why This Matters

🌍 Real World

Displaying recent or filtered posts on WordPress theme pages or widgets.

💼 Career

Essential skill for WordPress theme and plugin developers to customize content display.

1

Set up the query parameters

Create an array called $args with a key 'posts_per_page' set to 5 to specify fetching 5 posts.

Wordpress

# Your code here

Hint

Think of $args as a list of instructions for which posts to get.

2

Create the WP_Query object

Create a new WP_Query object called $query using the $args array.

Wordpress

$args = array('posts_per_page' => 5);
# Your code here

Hint

This creates the query that will fetch the posts based on your parameters.

3

Loop through the posts and display titles

Use a while loop with $query->have_posts() and inside it call $query->the_post(). Inside the loop, output each post title inside an <li> tag using get_the_title().

Wordpress

$args = array('posts_per_page' => 5);
$query = new WP_Query($args);
# Your code here

Hint

Remember to open the list before the loop and close it after.

4

Reset post data after the loop

After the loop, call wp_reset_postdata() to restore the original post data.

Wordpress

$args = array('posts_per_page' => 5);
$query = new WP_Query($args);
echo '';
while ($query->have_posts()) {
    $query->the_post();
    echo '' . get_the_title() . '';
}
echo '';
# Your code here

Hint

This step ensures WordPress returns to the main query after your custom loop.

Practice

1. What is the primary purpose of the WP_Query class in WordPress?

easy

A. To style posts with CSS classes

B. To create new posts in the WordPress admin

C. To fetch posts from the database based on custom criteria

D. To manage user roles and permissions

Solution

1. Step 1: Understand WP_Query's role

   WP_Query is designed to retrieve posts from the database using filters like category, author, or date.

2. Step 2: Differentiate from other WordPress features

   Creating posts, styling, or managing users are handled by other parts of WordPress, not WP_Query.

3. Final Answer:

   To fetch posts from the database based on custom criteria -> Option C

4. Quick Check:

   WP_Query fetches posts = A [OK]

Hint: WP_Query is for getting posts, not creating or styling [OK]

Common Mistakes:

• Confusing WP_Query with post creation functions
• Thinking WP_Query styles posts
• Assuming WP_Query manages users

2. Which of the following is the correct way to start a new WP_Query to get posts from category ID 5?

easy

A. $query = WP_Query(array('cat' => 5));

B. $query = new WP_Query(array('cat' => 5));

C. $query = new WP_Query('category_id' => 5);

D. $query = WP_Query('category' => 5);

Solution

1. Step 1: Check WP_Query instantiation syntax

   WP_Query must be created with the new keyword and an array of arguments.

2. Step 2: Verify correct argument key for category

   The correct key for category ID is 'cat', not 'category' or 'category_id'.

3. Final Answer:

   $query = new WP_Query(array('cat' => 5)); -> Option B

4. Quick Check:

   Use new WP_Query with array('cat' => 5) = D [OK]

Hint: Use new WP_Query with array and 'cat' key for category ID [OK]

Common Mistakes:

• Omitting the new keyword
• Using wrong argument keys like 'category' or 'category_id'
• Passing arguments without array

3. Given the following code, what will be the output if there are 3 posts in category 10?

$query = new WP_Query(['cat' => 10]);
if ($query->have_posts()) {
  while ($query->have_posts()) {
    $query->the_post();
    echo get_the_title() . ', ';
  }
} else {
  echo 'No posts found';
}
wp_reset_postdata();

medium

A. Titles of the 3 posts separated by commas

B. No posts found

C. Syntax error due to missing semicolons

D. Only the first post title printed

Solution

1. Step 1: Understand the loop behavior

   The loop runs while have_posts() returns true, printing each post title followed by a comma.

2. Step 2: Check the number of posts in category 10

   Since there are 3 posts, all 3 titles will be printed separated by commas.

3. Final Answer:

   Titles of the 3 posts separated by commas -> Option A

4. Quick Check:

   Loop prints all post titles = C [OK]

Hint: Loop prints all posts if have_posts() is true [OK]

Common Mistakes:

• Thinking only one post prints
• Assuming 'No posts found' when posts exist
• Confusing syntax errors with correct code

4. What is wrong with this WP_Query usage?

$query = new WP_Query(['post_type' => 'product']);
while ($query->have_posts()) {
  the_post();
  echo get_the_title();
}
wp_reset_postdata();

medium

A. Incorrect post_type value

B. Using echo instead of print

C. Missing wp_reset_query() after the loop

D. Missing call to $query->the_post() inside the loop

Solution

1. Step 1: Check loop method calls

   The loop uses $query->have_posts() but calls the_post() without the query object, which is incorrect.

2. Step 2: Identify correct method usage

   Inside the loop, it should call $query->the_post() to set up post data properly.

3. Final Answer:

   Missing call to $query->the_post() inside the loop -> Option D

4. Quick Check:

   Use $query->the_post() in custom loops = B [OK]

Hint: Use $query->the_post() inside loop, not just the_post() [OK]

Common Mistakes:

• Calling the_post() without query object in custom loops
• Confusing wp_reset_postdata() with wp_reset_query()
• Assuming echo vs print matters here

5. You want to display the latest 5 posts from category 3 but exclude posts tagged with 'featured'. Which WP_Query argument array correctly achieves this?

hard

A. ['cat' => 3, 'posts_per_page' => 5, 'tag__not_in' => [get_term_by('slug', 'featured', 'post_tag')->term_id]]

B. ['category_name' => '3', 'posts_per_page' => 5, 'tag__not_in' => ['featured']]

C. ['cat' => 3, 'posts_per_page' => 5, 'tag__not_in' => ['featured']]

D. ['cat' => 3, 'posts_per_page' => 5, 'tag__not_in' => get_term_by('slug', 'featured', 'post_tag')->term_id]

Solution

1. Step 1: Identify correct category argument

   Use 'cat' => 3 to filter by category ID 3, not 'category_name' with a number string.

2. Step 2: Exclude posts by tag ID

   The tag__not_in argument expects an array of tag IDs, so we must get the ID using get_term_by().

3. Step 3: Check syntax for excluding 'featured' tag

   Using get_term_by('slug', 'featured', 'post_tag')->term_id inside the array correctly fetches the tag ID to exclude.

4. Final Answer:

   ['cat' => 3, 'posts_per_page' => 5, 'tag__not_in' => [get_term_by('slug', 'featured', 'post_tag')->term_id]] -> Option A

5. Quick Check:

   Use tag IDs with tag__not_in, not slugs = A [OK]

Hint: Exclude tags by ID array with tag__not_in, not by slug string [OK]

Common Mistakes:

• Using tag slugs instead of tag IDs in tag__not_in
• Using category_name with numeric ID
• Not wrapping tag IDs in an array