apply_filters( 'widget_pages_args', array $args, array $instance )

Filters the arguments for the Pages widget.


Description

Top ↑

See also


Top ↑

Parameters

$args array
An array of arguments to retrieve the pages list.
$instance array
Array of settings for the current widget.

Top ↑

Source

File: wp-includes/widgets/class-wp-widget-pages.php. View all references

apply_filters(
	'widget_pages_args',
	array(
		'title_li'    => '',
		'echo'        => 0,
		'sort_column' => $sortby,
		'exclude'     => $exclude,
	),
	$instance
)


Top ↑

Changelog

Changelog
Version Description
4.9.0 Added the $instance parameter.
2.8.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    Contributed by Steven Lin

    Example migrated from Codex:

    The following removes certain pages from displaying in the WordPress default Display Pages widget.

    add_filter( 'widget_pages_args', 'wp_list_pages_filter', 10, 1 );
    
    function wp_list_pages_filter($args, $instance) {
        global $secure_slug;
    
        $remove_secure = array($secure_slug); // or could be array(1,2,3,4)
        $args['exclude'] = implode( ',', $remove_secure );
        return $args;
    }

You must log in before being able to contribute a note or feedback.