Common filter hooks in Wordpress - Step-by-Step Execution

Concept Flow - Common filter hooks

WordPress loads

↓

Apply filter hook

↓

Call all hooked functions

↓

Each function modifies data

↓

Return modified data

↓

Continue with filtered data

WordPress runs filter hooks by calling all functions attached to a hook, each can change the data before it is used.

Execution Sample

Wordpress

<?php
add_filter('the_title', 'add_prefix_to_title');
function add_prefix_to_title($title) {
  return 'Prefix: ' . $title;
}
?>

This code adds a prefix to post titles using the 'the_title' filter hook.

Execution Table

Step	Hook Triggered	Data Before	Function Called	Data After	Next Action
1	'the_title'	'Hello World'	add_prefix_to_title	'Prefix: Hello World'	Return modified title
2	End of filter functions	'Prefix: Hello World'	None	'Prefix: Hello World'	Use filtered title in page

💡 All hooked functions executed; filtered data returned for use.

Variable Tracker

Variable	Start	After add_prefix_to_title	Final
$title	'Hello World'	'Prefix: Hello World'	'Prefix: Hello World'

Key Moments - 2 Insights

Why does the title change after the filter runs?

Because the function 'add_prefix_to_title' modifies the title and returns the new value, as shown in step 1 of the execution_table.

What happens if multiple functions are hooked to the same filter?

Each function runs in order, receiving the data modified by the previous function, so the data changes step by step before final use.

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of data after 'add_prefix_to_title' runs?

A 'Hello World'

B 'Hello World Prefix:'

C 'Prefix: Hello World'

D 'Prefix Hello World'

💡 Hint

Check the 'Data After' column in step 1 of the execution_table.

At which step does WordPress stop calling filter functions?

A Step 1

B Step 2

C Step 3

D Step 0

💡 Hint

Look for the row where 'Function Called' is 'None' in the execution_table.

If you add another function hooked to 'the_title' that adds '!!!' at the end, how would the data change after step 1?

A 'Prefix: Hello World!!!'

B 'Prefix: Hello World'

C 'Hello World!!!'

D '!!! Prefix: Hello World'

💡 Hint

Remember each hooked function modifies the data passed from the previous one.

Concept Snapshot

Common filter hooks let you change data in WordPress.
Use add_filter('hook_name', 'your_function') to attach.
Your function gets data, modifies it, returns it.
WordPress runs all hooked functions in order.
Final modified data is used in the site.

Full Transcript

In WordPress, common filter hooks let you change data before it is used. When WordPress runs a filter hook, it calls all functions attached to that hook. Each function receives the current data, changes it if needed, and returns it. The next function gets the modified data. After all functions run, WordPress uses the final data. For example, the 'the_title' filter lets you change post titles. You add a function with add_filter('the_title', 'your_function'). Your function takes the title, adds a prefix, and returns it. WordPress then shows the modified title on the page. This process helps customize WordPress behavior without changing core code.

Practice

1. What is the main purpose of a filter hook in WordPress?

easy

A. To enqueue scripts and styles

B. To add new pages to the WordPress admin menu

C. To create new database tables

D. To modify data before it is displayed or saved

Solution

1. Step 1: Understand what filter hooks do

   Filter hooks allow you to change or modify data before WordPress uses or shows it.

2. Step 2: Compare options to the definition

   Only To modify data before it is displayed or saved describes modifying data before display or saving, which matches filter hooks.

3. Final Answer:

   To modify data before it is displayed or saved -> Option D

4. Quick Check:

   Filter hooks modify data = D [OK]

Hint: Filter hooks change data before use or display [OK]

Common Mistakes:

• Confusing filter hooks with action hooks
• Thinking filters add new features instead of modifying data
• Mixing up filters with script loading

2. Which of the following is the correct syntax to add a filter in WordPress?

easy

A. add_action('the_content', 'my_function');

B. add_filter('the_content', 'my_function');

C. apply_filter('the_content', 'my_function');

D. filter_add('the_content', 'my_function');

Solution

1. Step 1: Recall the correct function to add a filter

   The WordPress function to add a filter is add_filter.

2. Step 2: Check the syntax of each option

   add_filter('the_content', 'my_function'); uses add_filter with correct parameters. Others use wrong function names.

3. Final Answer:

   add_filter('the_content', 'my_function'); -> Option B

4. Quick Check:

   Use add_filter() to add filters = A [OK]

Hint: Use add_filter() to attach filter functions [OK]

Common Mistakes:

• Using add_action instead of add_filter
• Using non-existent functions like apply_filter
• Mixing up function names

3. What will be the output of this code snippet?

add_filter('the_title', function($title) {
  return strtoupper($title);
});

// Later WordPress calls apply_filters('the_title', 'Hello World');

medium

A. "HELLO WORLD"

B. "hello world"

C. "Hello World"

D. Error: Function not found

Solution

1. Step 1: Understand the filter function

   The filter changes the title by converting it to uppercase using strtoupper.

2. Step 2: Apply the filter to the input string

   When WordPress applies the filter to 'Hello World', it returns 'HELLO WORLD'.

3. Final Answer:

   "HELLO WORLD" -> Option A

4. Quick Check:

   Filter changes title to uppercase = C [OK]

Hint: Filter returns modified data, here uppercase string [OK]

Common Mistakes:

• Assuming original string is unchanged
• Confusing add_filter with add_action
• Expecting lowercase instead of uppercase

4. Identify the error in this filter hook code:

add_filter('the_content', 'modify_content');

function modify_content($content) {
  echo strtoupper($content);
}

medium

A. The filter name 'the_content' is incorrect

B. The function name must start with 'filter_'

C. The function should return the modified content, not echo it

D. add_filter requires three parameters

Solution

1. Step 1: Review the filter function behavior

   Filter functions must return the modified data, not output it directly.

2. Step 2: Check the code for return vs echo

   The function uses echo instead of return, so WordPress won't get the modified content.

3. Final Answer:

   The function should return the modified content, not echo it -> Option C

4. Quick Check:

   Filter functions must return data = B [OK]

Hint: Filter functions must return modified data, not print it [OK]

Common Mistakes:

• Using echo instead of return in filter functions
• Thinking filter names are arbitrary
• Believing add_filter always needs three parameters

5. You want to add a filter that appends " - Powered by WordPress" to every post title but only if the title is not empty. Which code correctly implements this?

hard

A. add_filter('the_title', function($title) {
if ($title !== '') {
return $title . ' - Powered by WordPress';
}
return $title;
});

B. add_filter('the_title', function($title) {
if ($title) {
echo $title . ' - Powered by WordPress';
}
});

C. add_filter('the_title', function() {
return ' - Powered by WordPress';
});

D. add_filter('the_title', function($title) {
return $title . ' - Powered by WordPress';
});

Solution

1. Step 1: Check the condition for empty title

   add_filter('the_title', function($title) { if ($title !== '') { return $title . ' - Powered by WordPress'; } return $title; }); checks if the title is not empty before appending the text, which matches the requirement.

2. Step 2: Verify the function returns the modified title

   add_filter('the_title', function($title) { if ($title !== '') { return $title . ' - Powered by WordPress'; } return $title; }); returns the modified title correctly; add_filter('the_title', function($title) { if ($title) { echo $title . ' - Powered by WordPress'; } }); uses echo which is wrong, C ignores the original title, D appends text even if title is empty.

3. Final Answer:

   code with condition and return -> Option A

4. Quick Check:

   Check empty title and return modified string = A [OK]

Hint: Return modified title only if not empty, use return not echo [OK]

Common Mistakes:

• Using echo instead of return
• Not checking if title is empty
• Replacing title instead of appending