Yogesh Chauhan's Blog

add_filter function in WordPress

in WordPress on February 17, 2021

We can use add_filter to hook a function or a method to a specific filter action.

WordPress has tons of functions to make changes in the website – backend and frontend. WordPress also has filter hooks.

filter hooks allow plugins to modify various types of internal data at runtime.

A plugin can modify data by binding a callback to a filter hook. When we apply the filter, each bound callback is run in order of priority.


add_filter($tag, $function_to_add, $priority = 10, $accepted_args = 1 )


$tag is string and required. It’s the name of the filter to hook.

$function_to_add is required as well. It is callable. The callback to be run when the filter is applied. You can also pass a class method as a callback.

$priority is optional but if we want to pass it then it has to be an integer. The default value is 10.

$priority is used to specify the order in which the functions associated with a particular action are executed. Lower numbers means it will execute first. If two functions have same priorities then they will be executed in the order in which they were added to the action.

$accepted_args – as the name suggests – It’s the number of arguments the function accepts. It is optional but if we want to pass it then it has to be an integer. The default value is 1. It makes sense! The function will always accept at least one argument.

Hooked functions can take extra arguments that are set when the matching do_action() or apply_filters() call is run.


Simple callback

function square( $var ) {
    return $var*$var;
add_filter( 'square_filter', 'square' );

Change the frontpage sections

add_filter( 'twentytwentyone_front_page_sections', 'prefix_custom_front_page_sections' );
function prefix_custom_front_page_sections( $num_sections )
  return 6;

Display custom length of post excerpt

if( ! function_exists( 'prefix_custom_excerpt_length' ) )
    function prefix_custom_excerpt_length( $length )
        return 40;
add_filter( 'excerpt_length', 'prefix_custom_excerpt_length', 999 );

Inject a CLASS/ID CSS in content

//Add Class/ID to Post Content
add_filter('the_content', 'xai_my_class');
function xai_my_class($content)
    //Replace the instance with the Class/ID markup.
    $string = '<ul'; //your tag
    $replace = '<ul class="detail-list"'; //add your class/id and tag
    $content = str_replace( $string, $replace, $content );
    return $content;

Credit goes to: WordPress Official Docs

Most Read

#1 Solution to the error “Visual Studio Code can’t be opened because Apple cannot check it for malicious software” #2 How to add Read More Read Less Button using JavaScript? #3 How to check if radio button is checked or not using JavaScript? #4 Solution to “TypeError: ‘x’ is not iterable” in Angular 9 #5 PHP Login System using PDO Part 1: Create User Registration Page #6 How to uninstall Cocoapods from the Mac OS?

Recently Posted

#Apr 8 JSON.stringify() in JavaScript #Apr 7 Middleware in NextJS #Jan 17 4 advanced ways to search Colleague #Jan 16 Colleague UI Basics: The Search Area #Jan 16 Colleague UI Basics: The Context Area #Jan 16 Colleague UI Basics: Accessing the user interface
You might also like these
How to add a ribbon inside a container using CSS?CSSConditional operator in JavaScript (aka ternary operator)JavaScriptHow to create Flickering Texts using CSS?CSS3 Ways we can create URLSearchParams Objects in JavaScriptJavaScriptfor @each loop in SCSSSCSSThe actual difference between indexOf() and search() in JavaScriptJavaScript