wp_get_recent_posts() │ WP 1.0.0

Отримує останні записи (пости) сайту, включаючи чернетки, заплановані та записи на модерації. Отримає останні 10 записів.

У параметрі post_type можна зазначити записи якого типу необхідно отримати, за замовчуванням post – тобто. виходять пости сайту…

Функція є обгорткою для get_posts() , відмінності в тому, що вона отримує 10, а не 5 записів і намагається отримати записи всіх можливих статусів, включаючи чернетки, заплановані, особисті та модерації, що очікують.

'numberposts' => 10,
'post_status' => 'draft, publish, future, pending, private',
Працює на основі:
get_posts()

Хуків немає.

Повертає

Массив|false. Список постів як асоціативного масиву з об’єктів записів. У індексах масиву буде ID запису, а значенні об’єкт WP_Post, тобто. сам запис (пост).

Шаблон використання

$result = wp_get_recent_posts([
	'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,
], OBJECT);
foreach( $result as $post ){
	setup_postdata($post);
	the_title(); // Висновок
}
wp_reset_postdata();

Використання

wp_get_recent_posts ($ args, $ output);
$args
(число)

Масив аргументів, за якими потрібно отримати останні пости. Які аргументи можна використовувати дивіться в описі query_posts() .

Аргументи стали можливі лише з версії 3.1, до цього в цей параметр передавалося число – скільки останніх постів виводити.

За замовчуванням: попереднє встановлення

$output
(рядок)

Тип даних, що повертаються.

  • ARRAY_A – масив масивів з даними постів, в індексах масиву буде ID посту.
  • OBJECT – масив об’єктів WP_Post, в індексах масиву будуть числа по порядку.

Default: ARRAY_A

Приклади

0

#1 Останні записи

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

<?php
$ args = array (
	'numberposts' => 6,
	'category' => 5,
	'post_status' => 'publish',
);

$result = wp_get_recent_posts($args);

foreach( $result as $p ){
	?>
	— <a href="<?php echo get_permalink($p['ID']) ?>"><?php echo $p['post_title'] ?></a><br />
	<?php
}
?>
0

#2 Для версій нижче 3.1

Працює для версій нижче 3.1. Це приклад, показує як використовувати функцію wp_get_recent_postsдля того, щоб вивести список з 7 останніх постів на екран. Список буде у вигляді посилань на посади.

<ul>
  <li>
	<h2>Posts Recentes</h2>
	<ul>
	<?php
	  $recent_posts = wp_get_recent_posts(7);
	  foreach($recent_posts as $post){
		echo '<li><a href="' . get_permalink($post["ID"]) . '" title="'.$post["post_title"].'" >' . $post["post_title"].'</a> </li> ';
	  } ?>
	</ul>
  </li>
</ul>
0

#3 Дані, що повертаються для кожного посту

ID
(число)
Ідентифікатор запису.
post_author
(число)
Ідентифікатор автора запису.
post_date
(рядок)
Дата запису у форматі YYYY-MM-DD HH:MM:SS (з урахуванням виправлення часу).
post_date_gmt
(рядок)
Дата запису у форматі YYYY-MM-DD HH:MM:SS (час за Грінвічем (GMT)).
post_content
(рядок)
Текст запису.
post_title
(рядок)
Заголовок запису.
post_excerpt
(рядок)
Цитувати запис.
post_status
(рядок)
Статут запису, можливо: publish|pending|draft|private|static|object|attachment|inherit|future|trash.
comment_status
(рядок)
Можливість коментування для запису може бути: open | closed | registered_only.
ping_status
(рядок)
Статус пінгів/трекбеків, можливо: open | closed.
post_password
(рядок)
Пароль запису.
post_name
(рядок)
Ім’я запису (склад). Назва, яка зазвичай використовується в УРЛ-і.
to_ping
(рядок)
УРЛ-и зі статті, на які потрібно надіслати повідомлення під час оновлення посту.
pinged
(рядок)
УРЛ зі статті, які вже отримали повідомлення.
post_modified
(рядок)
Дата зміни запису у форматі YYYY-MM-DD HH:MM:SS (з урахуванням коригування часу).
post_modified_gmt
(рядок)
Дата зміни запису у форматі YYYY-MM-DD HH:MM:SS (час за Грінвічем (GMT)).
post_parent
(число)
ID батьківської сторінки (відмінно від нуля у прикріплених типів записів).
guid
(рядок)
Унікальний ідентифікатор запису (для RSS) зазвичай містить посилання на запис. Цей параметр не можна використовувати як постійне посилання на пост.
menu_order
(число)
Порядковий номер для створення меню (використовується для постійних сторінок).
post_type
(рядок)
Тип запису:
post ,
page ,
attachment і т.д.
post_mime_type
(рядок)

Якого типу вкладення необхідно отримати. Можна використовувати, коли параметр post_type = attachment .

  • image/jpeg
  • image/png
  • image/gif
  • image – для будь-яких картинок
  • audio/mpeg
  • application/pdf
  • application/zip

Замість однієї міми типу можна вказати дещо в масиві. Повний список міме типів дивіться тут .

comment_count
(число)
Кількість коментарів запису.

нотатки

список змін

З версії 1.0.0Введено.

Код wp_get_recent_posts() WP 6.0.2

wp-includes/post.php 
function wp_get_recent_posts( $args = array(), $output = ARRAY_A ) {

	if ( is_numeric( $args ) ) {
		_deprecated_argument( __FUNCTION__, '3.1.0', __( 'Passing aninteger 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,
	);

	$parsed_args = wp_parse_args($args, $defaults);

	$results = get_posts( $parsed_args );

	// Backward compatibility. Prior to 3.1 expected posts to 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;

}

query (запит)

Запити

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *