The Loop and query in Wordpress - Mini Project: Build & Apply

The Loop and query

📖 Scenario: You are building a simple WordPress theme template that shows a list of blog posts. You want to display only posts from the category "News".

🎯 Goal: Create a WordPress Loop that queries posts from the category "News" and displays their titles in an unordered list.

📋 What You'll Learn

Create a query to get posts from the category "News"

Use The Loop to display the post titles

Wrap the titles in an unordered list

Reset the post data after the loop

💡 Why This Matters

🌍 Real World

WordPress themes often need to show posts from specific categories or with custom filters. This project teaches how to do that safely and clearly.

💼 Career

Understanding The Loop and WP_Query is essential for WordPress developers to customize themes and build dynamic content displays.

1

Create the initial query

Create a variable called $news_query that uses new WP_Query to get posts from the category slug 'news'.

Wordpress

# Your code here

Hint

Use new WP_Query(array('category_name' => 'news')) to get posts from the "News" category.

2

Check if the query has posts

Add an if statement that checks $news_query->have_posts() to see if there are posts to show.

Wordpress

$news_query = new WP_Query(array('category_name' => 'news'));
# Add an if statement to check if there are posts
# Your code here

Hint

Use if ($news_query->have_posts()) to check if posts exist.

3

Create The Loop to display post titles

Inside the if block, start an unordered list with <ul>. Then use a while loop with $news_query->have_posts() and inside it call $news_query->the_post(). For each post, add a list item <li> with the post title using get_the_title(). Close the unordered list after the loop.

Wordpress

$news_query = new WP_Query(array('category_name' => 'news'));
if ($news_query->have_posts()) {
    # Start unordered list
    # Use while loop with $news_query->have_posts()
    # Call $news_query->the_post() inside loop
    # Display post title inside 
    # Close unordered list
    # Your code here
}

Hint

Use while ($news_query->have_posts()) { $news_query->the_post(); } and inside echo list items with get_the_title().

4

Reset post data after the loop

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

Wordpress

$news_query = new WP_Query(array('category_name' => 'news'));
if ($news_query->have_posts()) {
    echo '';
    while ($news_query->have_posts()) {
        $news_query->the_post();
        echo '' . get_the_title() . '';
    }
    echo '';
}
# Call wp_reset_postdata() here
# Your code here

Hint

Call wp_reset_postdata() after the loop to clean up.

Practice

1. What is the main purpose of The Loop in WordPress?

easy

A. To manage user login sessions

B. To create new posts in the database

C. To style the website layout

D. To display posts one by one on a page

Solution

1. Step 1: Understand The Loop's role

   The Loop is a WordPress structure that cycles through posts to display them.

2. Step 2: Identify its main function

   It outputs posts one by one on the page, showing content to visitors.

3. Final Answer:

   To display posts one by one on a page -> Option D

4. Quick Check:

   The Loop shows posts = D [OK]

Hint: The Loop shows posts on pages one at a time [OK]

Common Mistakes:

• Thinking The Loop creates posts
• Confusing The Loop with styling or login
• Assuming The Loop manages database directly

2. Which of the following is the correct way to start The Loop in a WordPress theme file?

easy

A. if ( have_posts() ) : while ( have_posts() ) : the_post();

B. while ( the_post() ) : have_posts();

C. if ( the_post() ) : while ( have_posts() );

D. for ( have_posts(); the_post(); ) :

Solution

1. Step 1: Recall The Loop syntax

   The Loop starts by checking if posts exist with have_posts(), then loops with while ( have_posts() ).

2. Step 2: Confirm correct function order

   Inside the loop, the_post() sets up post data for each iteration.

3. Final Answer:

   if ( have_posts() ) : while ( have_posts() ) : the_post(); -> Option A

4. Quick Check:

   Correct loop syntax = A [OK]

Hint: Check if posts exist before looping with have_posts() [OK]

Common Mistakes:

• Using the_post() before have_posts()
• Mixing function order in the loop
• Using for loop syntax instead of while

3. Given this code snippet, what posts will be displayed?

$custom_query = new WP_Query(['category_name' => 'news', 'posts_per_page' => 2]);
if ($custom_query->have_posts()) :
  while ($custom_query->have_posts()) : $custom_query->the_post();
    the_title();
  endwhile;
endif;
wp_reset_postdata();

medium

A. Only posts from the default query ignoring 'news'

B. All posts from the 'news' category

C. Only the first 2 posts from the 'news' category

D. No posts will be displayed due to syntax error

Solution

1. Step 1: Analyze WP_Query parameters

   The query requests posts from category 'news' and limits to 2 posts.

2. Step 2: Understand the loop behavior

   The loop runs through posts found by $custom_query, showing only those 2 posts.

3. Final Answer:

   Only the first 2 posts from the 'news' category -> Option C

4. Quick Check:

   WP_Query limits posts = A [OK]

Hint: posts_per_page limits how many posts show [OK]

Common Mistakes:

• Assuming all posts show ignoring posts_per_page
• Confusing default query with custom query
• Missing wp_reset_postdata() after custom loop

4. What is wrong with this code snippet?

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

medium

A. Missing parentheses after the_post function call

B. Incorrect use of curly braces instead of colons

C. the_title() should be called before the_post

D. have_posts() should be called only once outside the loop

Solution

1. Step 1: Check function calls inside the loop

   The function the_post is missing parentheses, so it is not called properly.

2. Step 2: Verify syntax correctness

   Functions must have parentheses even if no arguments: the_post(); is correct.

3. Final Answer:

   Missing parentheses after the_post function call -> Option A

4. Quick Check:

   Function calls need () = B [OK]

Hint: Always add () when calling functions in PHP [OK]

Common Mistakes:

• Forgetting parentheses on function calls
• Confusing syntax styles (curly braces vs colons)
• Calling the_title() before the_post()

5. You want to display a list of posts excluding category 'news' and showing only posts with the custom field 'featured' set to 'yes'. Which WP_Query arguments correctly achieve this?

hard

A. ['category__not_in' => get_cat_ID('news'), 'meta_key' => 'featured', 'meta_value' => 'yes']

B. ['cat' => '-'.get_cat_ID('news'), 'meta_query' => [['key' => 'featured', 'value' => 'yes']]]

C. ['category_name' => 'news', 'meta_key' => 'featured', 'meta_value' => 'yes']

D. ['category__in' => [get_cat_ID('news')], 'meta_key' => 'featured', 'meta_value' => 'yes']

Solution

1. Step 1: Exclude category 'news'

   Using 'cat' => '-ID' excludes a category by its ID. get_cat_ID('news') gets the ID.

2. Step 2: Filter posts with custom field 'featured' = 'yes'

   Use meta_query with key and value to filter posts by custom fields.

3. Step 3: Combine both conditions correctly

   ['cat' => '-'.get_cat_ID('news'), 'meta_query' => [['key' => 'featured', 'value' => 'yes']]] uses negative cat ID and meta_query array properly.

4. Final Answer:

   ['cat' => '-'.get_cat_ID('news'), 'meta_query' => [['key' => 'featured', 'value' => 'yes']]] -> Option B

5. Quick Check:

   Exclude category with negative ID + meta_query = C [OK]

Hint: Use negative cat ID to exclude categories in WP_Query [OK]

Common Mistakes:

• Using category__not_in without meta_query for custom fields
• Including category instead of excluding
• Using meta_key/meta_value without meta_query array