get_posts( array $args = null )

Retrieves an array of the latest posts, or posts matching the given criteria.

Description

For more information on the accepted arguments, see the WP_Query documentation in the Developer Handbook.

The $ignore_sticky_posts and $no_found_rows arguments are ignored by this function and both are set to true.

The defaults are as follows:

See also

Parameters

$args

(Optional) Arguments to retrieve posts. See WP_Query::parse_query() for all available arguments.<br>

  • 'numberposts'
    (int) Total number of posts to retrieve. Is an alias of $posts_per_page in WP_Query. Accepts -1 for all. Default 5.<br>
  • 'category'
    (int|string) Category ID or comma-separated list of IDs (this or any children).<br> Is an alias of $cat in WP_Query. Default 0.<br>
  • 'include'
    (int[]) An array of post IDs to retrieve, sticky posts will be included.<br> Is an alias of $post__in in WP_Query. Default empty array.<br>
  • 'exclude'
    (int[]) An array of post IDs not to retrieve. Default empty array.<br>
  • 'suppress_filters'
    (bool) Whether to suppress filters. Default true.<br>

Default value: null

Return

(WP_Post[]|int[]) Array of post objects or post IDs.

Source

File: wp-includes/post.php 

function get_posts( $args = null ) {
	$defaults = array(
		'numberposts' => 5,
		'category' => 0, 'orderby' => 'date',
		'order' => 'DESC', 'include' => array(),
		'exclude' => array(), 'meta_key' => '',
		'meta_value' =>'', 'post_type' => 'post',
		'suppress_filters' => true
	);

	$r = wp_parse_args( $args, $defaults );
	if ( empty( $r['post_status'] ) )
		$r['post_status'] = ( 'attachment' == $r['post_type'] ) ? 'inherit' : 'publish';
	if ( ! empty($r['numberposts']) && empty($r['posts_per_page']) )
		$r['posts_per_page'] = $r['numberposts'];
	if ( ! empty($r['category']) )
		$r['cat'] = $r['category'];
	if ( ! empty($r['include']) ) {
		$incposts = wp_parse_id_list( $r['include'] );
		$r['posts_per_page'] = count($incposts);  // only the number of posts included
		$r['post__in'] = $incposts;
	} elseif ( ! empty($r['exclude']) )
		$r['post__not_in'] = wp_parse_id_list( $r['exclude'] );

	$r['ignore_sticky_posts'] = true;
	$r['no_found_rows'] = true;

	$get_posts = new WP_Query;
	return $get_posts->query($r);

}

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/class-wp-query.php: WP_Query::__construct()

Constructor.
wp-includes/functions.php: wp_parse_args()

Merges user defined arguments into defaults array.
wp-includes/functions.php: wp_parse_id_list()

Cleans up an array, comma- or space-separated list of IDs.

Used By

Used By
Used By Description
wp-includes/comment.php: do_all_trackbacks()

Performs all trackbacks.
wp-includes/comment.php: do_all_pingbacks()

Performs all pingbacks.
wp-includes/comment.php: do_all_enclosures()

Performs all enclosures.
wp-includes/class-wp-query.php: WP_Query::get_posts()

Retrieves an array of posts based on query variables.
wp-includes/nav-menu.php: wp_get_nav_menu_items()

Retrieves all menu items of a navigation menu.
wp-includes/link-template.php: get_boundary_post()

Retrieves the boundary post.
wp-includes/theme.php: get_uploaded_header_images()

Gets the header images uploaded for the active theme.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_getMediaLibrary()

Retrieves a collection of media library items (or attachments).
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_getPages()

Retrieves Pages.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::get_changeset_posts()

Gets changeset posts.
wp-includes/post.php: wp_add_trashed_suffix_to_post_name_for_trashed_posts()

Adds a suffix if any trashed posts have a given slug.
wp-includes/post.php: wp_get_recent_posts()

Retrieves a number of recent posts.
wp-includes/post.php: get_children()

Retrieves all children of the post parent ID.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::load_available_items_query()

Performs the post_type and taxonomy queries for loading available menu items.
wp-admin/includes/image.php: wp_generate_attachment_metadata()

Generates attachment meta data and create image sub-sizes for images.
wp-admin/includes/nav-menu.php: wp_nav_menu_item_post_type_meta_box()

Displays a meta box for a post type menu item.
wp-admin/includes/ajax-actions.php: wp_ajax_find_posts()

Ajax handler for querying posts for the Find Posts modal.
wp-admin/includes/dashboard.php: wp_dashboard_recent_drafts()

Show recent drafts of the user on the dashboard.
Show 13 more used by Hide more used by

Changelog

Changelog
Version Description
1.2.0 Introduced.