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

Filters the arguments for the Recent Posts widget.

Contents

Description
- See also
Parameters
More Information
Source
Related
- Used By
Changelog
User Contributed Notes

Description

See also

WP_Query::get_posts()

Parameters

$args array: An array of arguments used to retrieve the recent posts.
$instance array: Array of settings for the current widget.

More Information

Use any of the WP_Query parameters for $args.

Source

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

apply_filters(
	'widget_posts_args',
	array(
		'posts_per_page'      => $number,
		'no_found_rows'       => true,
		'post_status'         => 'publish',
		'ignore_sticky_posts' => true,
	),
	$instance
)

View on Trac View on GitHub

Used By

Used By
Used By	Description
WP_Widget_Recent_Posts::widget() wp-includes/widgets/class-wp-widget-recent-posts.php	Outputs the content for the current Recent Posts widget instance.

Changelog

Changelog
Version	Description
4.9.0	Added the `$instance` parameter.
3.4.0	Introduced.

User Contributed Notes

Skip to note 1 content

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

Contributed by habitcreature — 5 years ago
Adding to my custom theme in functions.php:
```
//filter recent posts widgets by category name
function myorg_recentposts_events($args, $instance) {
	$args['category_name'] = 'upcoming-events';
	return $args;
}
add_filter('widget_posts_args', 'myorg_recentposts_events', 1, 2);
```
Most important, return $args!! Spent an hour trying to figure out why my filter wasn’t working.
Log in to add feedback
Skip to note 2 content

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

Contributed by Steven Lin — 2 years ago
Example migrated from Codex:

Use the following to sort recent posts of the widget by date. Add the code to the functions.php file of the child theme.
```
add_filter('widget_posts_args', 'filter_recent_posts_widget_parameters'); 

function filter_recent_posts_widget_parameters($args, $instance) {
   $args['orderby'] = 'date';
   return $args;
}
```
Log in to add feedback

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