Common filter hooks in Wordpress

Introduction

Filter hooks let you change data before WordPress uses it. They help you customize how WordPress works without changing core files.

You want to change the text of a post title before it shows on your site.

You need to modify the content of a post before it appears to visitors.

You want to add extra HTML or text to the end of every post automatically.

You want to change the URL of an image before it loads.

You want to adjust the way WordPress formats dates or times.

Syntax

Wordpress

add_filter('hook_name', 'your_function_name', priority, accepted_args);

function your_function_name($value) {
    // modify $value
    return $value;
}

add_filter connects your function to a filter hook.

Your function must return the modified value for WordPress to use it.

Examples

This adds 'Hello: ' before every post title.

Wordpress

add_filter('the_title', 'change_title');

function change_title($title) {
    return 'Hello: ' . $title;
}

This adds a thank you message at the end of every post content.

Wordpress

add_filter('the_content', 'add_footer_text');

function add_footer_text($content) {
    return $content . '<p>Thank you for reading!</p>';
}

This changes the upload folder to a custom folder.

Wordpress

add_filter('upload_dir', 'custom_upload_dir');

function custom_upload_dir($dirs) {
    $dirs['subdir'] = '/custom_folder';
    $dirs['path'] = $dirs['basedir'] . $dirs['subdir'];
    $dirs['url'] = $dirs['baseurl'] . $dirs['subdir'];
    return $dirs;
}

Sample Program

This code adds 'Prefix: ' before every post title using the 'the_title' filter hook. It shows how the title changes when the filter runs.

Wordpress

<?php
// Add prefix to all post titles
add_filter('the_title', 'add_prefix_to_title');

function add_prefix_to_title($title) {
    return 'Prefix: ' . $title;
}

// Usage example: simulate getting a title
$original_title = 'My First Post';
$filtered_title = apply_filters('the_title', $original_title);
echo $filtered_title;
?>

Important Notes

Always return the modified value in your filter function.

Use the right hook name to target the data you want to change.

You can set priority to control the order if multiple filters use the same hook.

Summary

Filter hooks let you change WordPress data before it is used or shown.

Use add_filter to connect your function to a filter hook.

Your function must return the changed data for WordPress to use it.

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