A WordPress-centric search engine for devs and theme authors



get_posts ›

Since1.2.0
Deprecatedn/a
get_posts ( $args = null )
Parameters:
  • (array) $args { Optional. Arguments to retrieve posts. See WP_Query::parse_query() for all available arguments.
    Required: No
    Default: null
See:
  • WP_Query::parse_query()
Returns:
  • (WP_Post[]|int[]) Array of post objects or post IDs.
Defined at:
Codex:

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

The defaults are as follows:



Source

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 );

}