06.Фев.2011 Посты Ком-ев: 0↓ Автор: Kama ⁵⁶⁵

get_boundary_post с версии 2.8.0

Описание

Получает первый или последний пост опубликованные на блоге.

Первый или последний пост можно получить из какой-либо категории или не входящий в какие-либо категории.

Функция возвращает массив данных поста, если удалось получить данные.
Если глобальная переменная $post не установлена, то функция вернет null.
Пустой результат будет возвращен, если не удалось получить данные.

ЗАМЕТКА: функция устанавливает указатель поста на первый пост.

Использование

<?php get_boundary_post( $in_same_cat, $excluded_categories, $start ) ?>

Параметры

$in_same_cat

(логический) Если нужно получить первый/последний пост из той же категории что и текущий пост.
По умолчанию: false

$excluded_categories

(строка) ID категорий, посты в которых не будут учитываться при определении первого или последнего поста.
По умолчанию: ''

$start

(логический) true, если нужно показать первый пост. false, если нужно показать последний пост.
По умолчанию: true

Примеры

1. Выведем заголовок последней записи из текущей категории (категории к которой относится пост, подразумевается что функция вызывается на странице поста).

$rrr = get_boundary_post( 1, '', false );
echo $rrr['post_title'];

Элементы массива, возвращаемого функцией

(число) Идентификатор записи.

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

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

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

get_boundary_post()

из файла: /wp-includes/link-template.php ^{WP 3.3.2}

function get_boundary_post( $in_same_cat = false, $excluded_categories = '', $start = true ) {
	global $post;

	if ( empty($post) || ! is_single() || is_attachment() )
		return null;

	$cat_array = array();
	if( ! is_array( $excluded_categories ) )
		$excluded_categories = explode( ',', $excluded_categories );

	if ( $in_same_cat || ! empty( $excluded_categories ) ) {
		if ( $in_same_cat )
			$cat_array = wp_get_object_terms( $post->ID, 'category', array( 'fields' => 'ids' ) );

		if ( ! empty( $excluded_categories ) ) {
			$excluded_categories = array_map( 'intval', $excluded_categories );
			$excluded_categories = array_diff( $excluded_categories, $cat_array );

			$inverse_cats = array();
			foreach ( $excluded_categories as $excluded_category )
				$inverse_cats[] = $excluded_category * -1;
			$excluded_categories = $inverse_cats;
		}
	}

	$categories = implode( ',', array_merge( $cat_array, $excluded_categories ) );

	$order = $start ? 'ASC' : 'DESC';

	return get_posts( array('numberposts' => 1, 'category' => $categories, 'order' => $order, 'update_post_term_cache' => false, 'update_post_meta_cache' => false) );
}

Связанные Функции

Ещё из раздела

Смотрите также: Функции WordPress и Теги Шаблона.

Комментариев нет↓get_boundary_post