Why custom queries retrieve specific data in Wordpress - See It in Action

Why custom queries retrieve specific data

📖 Scenario: You are building a WordPress site that shows posts about different topics. You want to display only posts about a specific topic on a page.

🎯 Goal: Create a custom WordPress query that retrieves only posts from the category 'Travel'.

📋 What You'll Learn

Create a variable called $args with the query parameters to get posts from the 'Travel' category

Create a WP_Query object called $travel_query using the $args variable

Use a while loop with $travel_query->have_posts() and $travel_query->the_post() to loop through posts

Inside the loop, output the post title using the_title()

Reset post data after the loop with wp_reset_postdata()

💡 Why This Matters

🌍 Real World

Custom queries let you show specific posts on your WordPress site, like posts about travel, recipes, or news.

💼 Career

Understanding custom queries is essential for WordPress developers to build dynamic and personalized websites.

1

Set up query parameters

Create an array called $args with a key category_name set to the string 'travel'.

Wordpress

# Your code here

Hint

The category_name parameter filters posts by category slug.

2

Create the custom query

Create a WP_Query object called $travel_query using the $args array.

Wordpress

$args = array('category_name' => 'travel');
# Your code here

Hint

Use new WP_Query($args) to create the query object.

3

Loop through the posts

Use a while loop with $travel_query->have_posts() and inside it call $travel_query->the_post(). Inside the loop, call the_title() to display each post's title.

Wordpress

$args = array('category_name' => 'travel');
$travel_query = new WP_Query($args);
# Your code here

Hint

The loop checks if there are posts and sets up each post for display.

4

Reset post data

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

Wordpress

$args = array('category_name' => 'travel');
$travel_query = new WP_Query($args);
while ($travel_query->have_posts()) {
    $travel_query->the_post();
    the_title();
}
# Your code here

Hint

This function resets the global post data to avoid conflicts.

Practice

1. What is the main reason to use a custom query in WordPress?

easy

A. To retrieve specific posts based on filters like category or author

B. To change the WordPress theme

C. To update the WordPress core automatically

D. To create new user accounts

Solution

1. Step 1: Understand the purpose of custom queries

   Custom queries allow you to select posts based on specific rules like category, author, or date.

2. Step 2: Compare with other options

   Changing themes, updating core, or creating users are unrelated to querying posts.

3. Final Answer:

   To retrieve specific posts based on filters like category or author -> Option A

4. Quick Check:

   Custom queries = filter posts [OK]

Hint: Custom queries filter posts; others change site settings [OK]

Common Mistakes:

• Confusing custom queries with theme changes
• Thinking custom queries update WordPress core
• Assuming custom queries create users

2. Which of the following is the correct way to start a custom query in WordPress?

easy

A. $query = new WP_Query('category_name=news');

B. $query = new WP_Query(['category_name' => 'news']);

C. new WP_Query(['category_name' => 'news']);

D. $query = WP_Query('category=news');

Solution

1. Step 1: Check WP_Query syntax

   WP_Query expects an array of arguments inside new WP_Query([...]).

2. Step 2: Identify correct array syntax

   $query = new WP_Query(['category_name' => 'news']); uses the correct PHP array syntax with key 'category_name' and value 'news'.

3. Final Answer:

   $query = new WP_Query(['category_name' => 'news']); -> Option B

4. Quick Check:

   Correct WP_Query syntax = $query = new WP_Query(['category_name' => 'news']); [OK]

Hint: Use new WP_Query with array args in brackets [OK]

Common Mistakes:

• Passing query as string instead of array
• Missing 'new' keyword before WP_Query
• Using wrong argument keys like 'category'

3. Given this code snippet, what posts will the custom query retrieve?

$args = ['author' => 5, 'posts_per_page' => 3];
$query = new WP_Query($args);
while ($query->have_posts()) {
  $query->the_post();
  echo get_the_title() . '
';
}

medium

A. The latest 3 posts by author with ID 5

B. All posts except those by author 5

C. 3 random posts from any author

D. Posts from author 5 but unlimited number

Solution

1. Step 1: Analyze query arguments

   The 'author' => 5 limits posts to author ID 5, 'posts_per_page' => 3 limits to 3 posts.

2. Step 2: Understand loop output

   The loop prints titles of these 3 posts by author 5.

3. Final Answer:

   The latest 3 posts by author with ID 5 -> Option A

4. Quick Check:

   Author 5 + 3 posts = The latest 3 posts by author with ID 5 [OK]

Hint: Author ID and posts_per_page limit results [OK]

Common Mistakes:

• Ignoring posts_per_page limit
• Confusing author filter as exclusion
• Assuming random posts without filter

4. What is wrong with this custom query code snippet?

$args = ['category_name' => 'news'];
$query = new WP_Query($args);
while ($query->have_posts()) {
  $query->the_post();
  echo get_the_title() . '
';
}

medium

A. The WP_Query object is not created correctly

B. The category_name argument is invalid

C. The loop will never run because have_posts() is missing

D. It does not reset post data after the loop

Solution

1. Step 1: Check query and loop correctness

   The query and loop syntax are correct and will run.

2. Step 2: Identify missing reset

   After a custom query loop, you must call wp_reset_postdata() to restore global post data.

3. Final Answer:

   It does not reset post data after the loop -> Option D

4. Quick Check:

   Missing wp_reset_postdata() = It does not reset post data after the loop [OK]

Hint: Always reset post data after custom query loops [OK]

Common Mistakes:

• Forgetting wp_reset_postdata() after loop
• Thinking category_name is invalid
• Assuming have_posts() is missing

5. You want to retrieve posts from category 'events' published after January 1, 2023, and only those with a custom field 'featured' set to 'yes'. Which WP_Query arguments array will achieve this?

hard

A. {'category_name' => 'events', 'date_query' => [['before' => '2023-01-01']], 'meta_query' => [['key' => 'featured', 'value' => 'yes']] }

B. {'category' => 'events', 'date' => '2023-01-01', 'meta_key' => 'featured', 'meta_value' => 'yes'}

C. {'category_name' => 'events', 'date_query' => [['after' => '2023-01-01']], 'meta_query' => [['key' => 'featured', 'value' => 'yes']]}

D. {'category_name' => 'events', 'date_query' => [['after' => '2023-01-01']], 'meta_key' => 'featured', 'meta_value' => 'no'}

Solution

1. Step 1: Check category and date filters

   'category_name' => 'events' and 'date_query' with 'after' => '2023-01-01' correctly filter posts after that date.

2. Step 2: Verify custom field filter

   'meta_query' with key 'featured' and value 'yes' filters posts with that custom field set.

3. Step 3: Compare options

   {'category_name' => 'events', 'date_query' => [['after' => '2023-01-01']], 'meta_query' => [['key' => 'featured', 'value' => 'yes']]} uses correct keys and nested arrays for date_query and meta_query. Others have wrong keys or values.

4. Final Answer:

   {'category_name' => 'events', 'date_query' => [['after' => '2023-01-01']], 'meta_query' => [['key' => 'featured', 'value' => 'yes']]} -> Option C

5. Quick Check:

   Correct filters + meta_query = {'category_name' => 'events', 'date_query' => [['after' => '2023-01-01']], 'meta_query' => [['key' => 'featured', 'value' => 'yes']]} [OK]

Hint: Use date_query and meta_query arrays for complex filters [OK]

Common Mistakes:

• Using 'category' instead of 'category_name'
• Wrong date_query keys like 'before' instead of 'after'
• Confusing meta_key/meta_value with meta_query array