apply_filters( 'widget_posts_args', array $args , array $instance )
Filters the arguments for the Recent Posts widget.
Contents
Description Description
See also See also
Parameters Parameters
- $args
-
(array) An array of arguments used to retrieve the recent posts.
- $instance
-
(array) Array of settings for the current widget.
More Information More Information
Use any of the WP_Query parameters for $args.
Source Source
Changelog Changelog
| Version | Description |
|---|---|
| 4.9.0 | Added the $instance parameter. |
| 3.4.0 | Introduced. |
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
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.Example migrated from Codex:
Use the following to sort recent posts of the widget by date. Add the code to the
functions.phpfile 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; }