get_boundary_post() │ WP 2.8.0

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

Перший або останній пост можна отримати із таксономії поточного запису (посту). Також можна вказати елементи таксономії, пости яких не потрібно враховувати. Параметри: $in_same_term та $excluded_terms .

Функція встановлює покажчик посту першу посаду.

Хуків немає.

Повертає

null|Массив.

  • Масив – коли вдалося отримати дані.
  • Порожній масив – коли постів немає (наприклад, на сайті немає постів).
  • null – коли:
    • глобальна змінна $post не встановлена.
    • або поточна сторінка не is_single() .
    • або поточна сторінка is_attachment() .
    • або зазначеної таксономії немає.

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

get_boundary_post($in_same_term, $excluded_terms, $start, $taxonomy);
$in_same_term
(логічний)
Чи потрібно вибирати пости з того ж терміна, що і поточний пост.

true – потрібно отримати перший/останній пост з того ж терміна (категорії), що і поточний запис.


Типово: false
$excluded_terms
(рядок/масив)
ID термінів (через кому чи вигляді масиву), пости у яких нічого очікувати враховуватися щодо першого чи останнього посту.


За замовчуванням: ”
$start
(логічний)
true, якщо потрібно показати перший пост. false, якщо потрібно показати останню посаду.


Типово: true
$taxonomy
(рядок)
Назва таксономії для
$excluded_categories .


Типово: ‘category’

Приклади

0

#1 Виведемо заголовок останнього запису з поточної категорії

Під поточною категорією розуміється: категорії до якої належить пост, мається на увазі, що функція викликається на сторінці посту.

$last = get_boundary_post(true, '', false) [0];
echo $last->post_title;
0

#2 Отримаємо перший пост на блозі

$first_post = get_boundary_post()[0];

echo $first_post->post_title;
0

#3 Інші приклади

// останній пост на блозі, крім категорій 5 і 20
$last_post = get_boundary_post(false, '5,20', true) [0];

// останній пост із категорії поточного посту
$last_post_of_the_cat = get_boundary_post( true, '', false )[0];

// остання посада з таксономії my_tax
$last_post = get_boundary_post(false, '', true, 'my_tax') [0];
0

#4 Що повертає функція

$boundary_post = get_boundary_post();

/*
Array (
	[0] => WP_Post Object (
			[ID] => 1000
			[post_author] => 1
			[post_date] => 2009-05-15 14:48:32
			[post_date_gmt] => 2009-05-15 21:48:32
			[post_content] => Текст посту
			[post_title] => Edge Case: Nested And Mixed Lists
			[post_excerpt] =>
			[post_status] => publish
			[comment_status] => closed
			[ping_status] => closed
			[post_password] =>
			[post_name] => edge-case-nested-and-mixed-lists
			[to_ping] =>
			[pinged] =>
			[post_modified] => 2009-05-15 14:48:32
			[post_modified_gmt] => 2009-05-15 21:48:32
			[post_content_filtered] =>
			[post_parent] => 0
			[guid] => http://wptest.io/demo/?p=1000
			[menu_order] => 0
			[post_type] => post
			[post_mime_type] =>
			[comment_count] => 0
			[filter] => raw
		)
)
*/

Масив містить об’єкти постів. Кожен об’єкт посту WP_Post містить такі елементи:

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
(рядок)
Посилання на запис. Важливо: використовувати цей параметр як постійне посилання для посту неправильно, якщо версія WordPress вище 2.5. Це унікальний ідентифікатор запису, який пізніше став посиланням на запис.
menu_order
(число)
Порядковий номер для створення меню (використовується для постійних сторінок).
post_type
(рядок)
Тип запису (post|page|attachment).
post_mime_type
(рядок)
Міме тип запису (jpg|png|zip|pdf і т.д.). Використовується для записів.
comment_count
(число)
Кількість коментарів запису.

список змін

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

Код get_boundary_post() WP 6.0.2

wp-includes/link-template.php 
function get_boundary_post( $in_same_term = false, $excluded_terms = '', $start = true, $taxonomy = 'category' ) {
	$post = get_post();
	if ( ! $post || ! is_single() || is_attachment() || ! taxonomy_exists( $taxonomy ) ) {
		return null;
	}

	$query_args = array(
		'posts_per_page' => 1,
		'order' => $start? 'ASC' : 'DESC',
		'update_post_term_cache' => false,
		'update_post_meta_cache' => false,
	);

	$term_array = array();

	if ( ! is_array( $excluded_terms ) ) {
		if ( ! empty( $excluded_terms ) ) {
			$excluded_terms = explode(',', $excluded_terms);
		} else {
			$excluded_terms = array();
		}
	}

	if ($in_same_term ||! empty($excluded_terms)) {
		if ( $in_same_term ) {
			$term_array = wp_get_object_terms( $post->ID, $taxonomy, array( 'fields' => 'ids' ) );
		}

		if ( ! empty( $excluded_terms ) ) {
			$excluded_terms = array_map( 'intval', $excluded_terms );
			$excluded_terms = array_diff($excluded_terms, $term_array);

			$inverse_terms = array();
			foreach ($excluded_terms as $excluded_term) {
				$inverse_terms[] = $excluded_term *-1;
			}
			$excluded_terms = $inverse_terms;
		}

		$query_args['tax_query'] = array(
			array(
				'taxonomy' => $taxonomy,
				'terms' => array_merge( $term_array, $excluded_terms ),
			),
		);
	}

	return get_posts($query_args);
}

query (запит)

Навігація

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

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