wp_get_recent_posts( array $args = array(), string $output = ARRAY_A )
Retrieve a number of recent posts.
Description
See also
Parameters
- $args
-
(Optional) Arguments to retrieve posts.
Default value: array()
- $output
-
(Optional) The required return type. One of OBJECT or ARRAY_A, which correspond to a WP_Post object or an associative array, respectively.
Default value: ARRAY_A
Return
(array|false) Array of recent posts, where the type of each element is determined by $output parameter. Empty array on failure.
Source
File: wp-includes/post.php
function wp_get_recent_posts( $args = array(), $output = ARRAY_A ) {
if ( is_numeric( $args ) ) {
_deprecated_argument( __FUNCTION__, 'WP-3.1.0', __( 'Passing an integer number of posts is deprecated. Pass an array of arguments instead.' ) );
$args = array( 'numberposts' => absint( $args ) );
}
// Set default arguments.
$defaults = array(
'numberposts' => 10, 'offset' => 0,
'category' => 0, 'orderby' => 'post_date',
'order' => 'DESC', 'include' => '',
'exclude' => '', 'meta_key' => '',
'meta_value' =>'', 'post_type' => 'post', 'post_status' => 'draft, publish, future, pending, private',
'suppress_filters' => true
);
$r = wp_parse_args( $args, $defaults );
$results = get_posts( $r );
// Backward compatibility. Prior to WP-3.1 expected posts to be returned in array.
if ( ARRAY_A == $output ){
foreach ( $results as $key => $result ) {
$results[$key] = get_object_vars( $result );
}
return $results ? $results : array();
}
return $results ? $results : false;
}
Changelog
Version | Description |
---|---|
WP-1.0.0 | Introduced. |