Order management in Wordpress - Mini Project: Build & Apply

Order management

📖 Scenario: You are building a simple WordPress plugin to manage customer orders on a website. The plugin will store orders, set a status filter, display filtered orders, and finalize the order list display.

🎯 Goal: Create a WordPress plugin that stores a list of orders, filters them by status, loops through the filtered orders to display them, and completes the display with a summary message.

📋 What You'll Learn

Create an array called $orders with 3 orders, each order is an associative array with keys 'id', 'product', and 'status'

Create a variable called $filter_status and set it to the string 'completed'

Use array_filter with a callback function to create a new array $filtered_orders containing only orders with 'status' equal to $filter_status

Use a foreach loop to iterate over $filtered_orders and echo each order's 'id' and 'product' inside a paragraph tag

After the loop, echo a final paragraph with the text 'All completed orders are shown.'

💡 Why This Matters

🌍 Real World

Managing and displaying customer orders on a WordPress website helps store owners track order statuses and show relevant information to customers or admins.

💼 Career

Understanding how to manipulate arrays, filter data, and display dynamic content is essential for WordPress plugin development and backend PHP programming.

1

Create the orders array

Create an array called $orders with exactly these three orders: ['id' => 101, 'product' => 'T-shirt', 'status' => 'completed'], ['id' => 102, 'product' => 'Jeans', 'status' => 'pending'], and ['id' => 103, 'product' => 'Hat', 'status' => 'completed'].

Wordpress

<?php
// Create the orders array with 3 orders
// Your code here

Hint

Use a PHP array with three associative arrays inside, each with keys 'id', 'product', and 'status'.

2

Set the filter status

Create a variable called $filter_status and set it to the string 'completed'.

Wordpress

 101, 'product' => 'T-shirt', 'status' => 'completed'],
    ['id' => 102, 'product' => 'Jeans', 'status' => 'pending'],
    ['id' => 103, 'product' => 'Hat', 'status' => 'completed']
];
// Set the filter status to 'completed'
// Your code here

Hint

Just assign the string 'completed' to the variable $filter_status.

3

Filter orders by status

Use array_filter with a callback function to create a new array called $filtered_orders that contains only orders from $orders where the 'status' equals $filter_status.

Wordpress

 101, 'product' => 'T-shirt', 'status' => 'completed'],
    ['id' => 102, 'product' => 'Jeans', 'status' => 'pending'],
    ['id' => 103, 'product' => 'Hat', 'status' => 'completed']
];

$filter_status = 'completed';
// Filter orders by status using array_filter
// Your code here

Hint

Use array_filter with an anonymous function that checks if $order['status'] equals $filter_status.

4

Display filtered orders and final message

Use a foreach loop to iterate over $filtered_orders and echo each order's 'id' and 'product' inside a paragraph tag. After the loop, echo a paragraph with the text 'All completed orders are shown.'.

Wordpress

 101, 'product' => 'T-shirt', 'status' => 'completed'],
    ['id' => 102, 'product' => 'Jeans', 'status' => 'pending'],
    ['id' => 103, 'product' => 'Hat', 'status' => 'completed']
];

$filter_status = 'completed';

$filtered_orders = array_filter($orders, function($order) use ($filter_status) {
    return $order['status'] === $filter_status;
});

// Loop through filtered orders and echo details
// Then echo final message
// Your code here

Hint

Use a foreach loop to echo each order's id and product inside <p> tags, then echo the final message in another <p> tag.

Practice

1. What is the primary purpose of the wc_get_orders() function in WooCommerce order management?

easy

A. To create a new product in the store

B. To retrieve a list of orders based on specified criteria

C. To delete a customer account

D. To update the site theme settings

Solution

1. Step 1: Understand the function name and context

   The function wc_get_orders() is related to WooCommerce and order management, so it deals with orders.

2. Step 2: Identify the function's role

   This function is used to retrieve orders, often filtered by criteria like status or date.

3. Final Answer:

   To retrieve a list of orders based on specified criteria -> Option B

4. Quick Check:

   Order retrieval = A [OK]

Hint: Remember 'get' means fetch or retrieve data [OK]

Common Mistakes:

• Confusing order retrieval with product creation
• Thinking it updates or deletes orders
• Mixing it up with user account functions

2. Which of the following is the correct way to get all completed orders using wc_get_orders()?

easy

A. wc_get_orders(array('status' => 'completed'));

B. wc_get_orders('completed');

C. wc_get_orders(status='completed');

D. wc_get_orders(['state' => 'completed']);

Solution

1. Step 1: Check the function parameter format

   wc_get_orders() expects an array of arguments, so the parameter must be an array.

2. Step 2: Verify the correct key for order status

   The correct key to filter by order status is 'status', not 'state'.

3. Final Answer:

   wc_get_orders(array('status' => 'completed')); -> Option A

4. Quick Check:

   Array with 'status' key = B [OK]

Hint: Use array with 'status' key for filtering orders [OK]

Common Mistakes:

• Passing status as a string instead of array
• Using wrong key like 'state' instead of 'status'
• Incorrect syntax for array or parameters

3. What will the following code output?

 $orders = wc_get_orders(['limit' => 1, 'status' => 'processing']);
echo count($orders);

medium

A. 1

B. 0

C. An error message

D. The total number of all orders

Solution

1. Step 1: Understand the parameters

   The code requests orders with status 'processing' and limits the result to 1 order.

2. Step 2: Analyze the output

   The wc_get_orders() returns an array of orders matching the criteria. Since limit is 1, the array will have at most one order.

3. Final Answer:

   1 -> Option A

4. Quick Check:

   Limit 1 order means count = 1 [OK]

Hint: Limit parameter controls how many orders are returned [OK]

Common Mistakes:

• Assuming it returns all orders ignoring limit
• Expecting an error due to missing arguments
• Confusing count with total orders in database

4. Identify the error in this code snippet for updating an order status:

$order = wc_get_order(123);
$order->update_status('completed');
$order->save();

medium

A. update_status() requires a second parameter for note

B. wc_get_order() should be wc_get_orders()

C. Calling save() is unnecessary after update_status()

D. Order ID 123 must be a string, not a number

Solution

1. Step 1: Check the function usage

   wc_get_order(123) correctly fetches a single order by ID.

2. Step 2: Understand update_status() behavior

   This method updates the status and saves the order automatically, so calling save() again is redundant.

3. Final Answer:

   Calling save() is unnecessary after update_status() -> Option C

4. Quick Check:

   update_status auto-saves = A [OK]

Hint: update_status() auto-saves order, no extra save needed [OK]

Common Mistakes:

• Using plural wc_get_orders() to get one order
• Thinking update_status() needs a note parameter
• Confusing order ID type requirements

5. You want to list all orders placed in the last 7 days with status 'processing' or 'on-hold'. Which code snippet correctly achieves this?

hard

A. wc_get_orders(['status' => ['processing', 'on-hold'], 'date_created' => '>= ' . (time() - 604800)]);

B. wc_get_orders(['status' => ['processing', 'on-hold'], 'date_created' => ['start' => '-7 days']]);

C. wc_get_orders(['status' => ['processing,on-hold'], 'date_created' => ['after' => '-7 days']]);

D. wc_get_orders(['status' => ['processing', 'on-hold'], 'date_created' => ['after' => date('Y-m-d', strtotime('-7 days'))]]);

Solution

1. Step 1: Understand filtering by multiple statuses

   The 'status' parameter accepts an array of statuses to filter orders matching any of them.

2. Step 2: Use correct date filtering syntax

   The 'date_created' parameter accepts an array with 'after' key and a date string to filter orders created after that date.

3. Step 3: Validate date format and function

   Using date('Y-m-d', strtotime('-7 days')) correctly formats the date 7 days ago.

4. Final Answer:

   wc_get_orders(['status' => ['processing', 'on-hold'], 'date_created' => ['after' => date('Y-m-d', strtotime('-7 days'))]]); -> Option D

5. Quick Check:

   Array status + date_created 'after' = D [OK]

Hint: Use array for statuses and 'after' key for date filter [OK]

Common Mistakes:

• Passing statuses as comma string instead of array
• Using invalid date filter keys like 'start' or raw timestamps
• Incorrect date format or missing date function