Получение последних записей с помощью wp_get_recent_posts() – WP 1.0.0

# WP_GET_RECENT_POSTS() │ WP 1.0.0

Функция wp_get_recent_posts() позволяет получить последние записи сайта, включая черновики, запланированные и записи на модерации. Она возвращает только последние 10 записей.

## Параметры функции

В параметре post_type можно указать тип записей, которые вы хотите получить. По умолчанию функция возвращает записи типа **post** — основные записи сайта.

Эта функция является оберткой для get_posts(). Разница в том, что она возвращает 10 записей, а не 5, и пытается получить записи всех возможных статусов: черновики, запланированные, личные и ожидающие модерации.

```php
'numberposts' => 10,
'post_status' => 'draft, publish, future, pending, private',

Использует: get_posts()

Возвращаемое значение

Функция может вернуть:

• Массив или false.
  • Массив — список записей в виде ассоциативного массива объектов записей. Индексы массива содержат ID записи, а значения — объекты WP_Post, то есть сами записи.
  • Пустой массив — если записей нет.
  • false — если $output не равен ARRAY_A, и записей нет.

Применение функции

Пример использования

$result = wp_get_recent_posts(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,
));

foreach( $result as $post ){
    setup_postdata( $post );
    the_title(); // выводит заголовок поста
}
wp_reset_postdata();

Параметры функции (массив)

• $args (array) — аргументы для получения записей. Более подробную информацию смотрите в описании WP_Query().

Примечание: Передать аргументы можно начиная с версии WP 3.1. Ранее можно было лишь указать количество последних записей для вывода. Значение по умолчанию: пустой массив.

Параметры вывода

• $output (строка) — тип возвращаемого значения.
  • ARRAY_A — массив массивов с данными записей, индексы массива содержат ID записей.
  • OBJECT — массив объектов WP_Post, индексы которого содержат номера в порядке.

По умолчанию: ARRAY_A

Примеры использования

1. Вывод последних записей

Выводим список из 6 ссылок на последние опубликованные записи из категории 5:

$result = wp_get_recent_posts(array(
    'numberposts' => 6,
    'category' => 5,
    'post_status' => 'publish',
));

foreach( $result as $p ){ 
    ?>
    — 
    
    

2. Для версий WP ниже 3.1

Этот пример показывает, как использовать функцию wp_get_recent_posts() для вывода списка последних 7 записей в виде ссылок.

  

    
Недавние записи
    

    '. esc_html($post["post_title"]) .'  ';
    }
    ?>
    
  

3. Данные, возвращаемые для каждой записи

Каждая запись содержит следующую информацию:

• ID (int) — ID записи
• post_author (int) — ID автора записи
• post_date (string) — Дата публикации записи в формате: YYYY-MM-DD HH:MM:SS (с учетом часового пояса)
• post_title (string) — Заголовок записи
• post_content (string) — Текст записи
• post_excerpt (string) — Краткое описание записи
• post_status (string) — Статус записи, может быть: publish, pending, draft, private, future и др.
• comment_status (string) — Возможность оставлять комментарии к записи: open или closed
• ping_status (string) — Статус пинга/трекбека: open или closed
• post_name (string) — Название записи (slug), которое обычно используется в URL
• post_type (string) — Тип записи: post, page, attachment и др.

Заметки

• Для понимания работы функции стоит рассмотреть get_posts().

Изменения

• С версии 1.0.0 — функция была представлена в WordPress.