display_media_states

Filters the default media display states for items in the Media list table.

Description

apply_filters( 'display_media_states', (array) $media_states ); 

Parameters (1)

0. $media_states (array)

An array of media states. Default Header Image,, Background Image., Site Icon, Logo.

Usage

To run the hook, copy the example below.

$media_states = apply_filters( 'display_media_states', $media_states ); 
                         
if ( !empty( $media_states ) ) { 
                         
   // everything has led up to this point... 
                         
} 
  

The following example is for adding a hook callback.

// define the display_media_states callback 
function filter_display_media_states( $media_states ) { 
    // make filter magic happen here... 
    return $media_states; 
}; 
         
// add the filter 
add_filter( 'display_media_states', 'filter_display_media_states', 10, 1 ); 

To remove a hook callback, use the example below.

// remove the filter 
remove_filter( 'display_media_states', 'filter_display_media_states', 10, 1 );