26.Сен.2011 ^{06.Фев.2011} Посты Ком-ев: 0↓ Автор: Kama ⁷²⁴

wp_get_single_post с версии 1.0.0

Описание

Получает всю информацию о посте, по указанному ID.

Отличается от get_posts() тем, что со стандартными данными поста, возвращаются данные о рубриках, метках поста.

wp_get_single_post() работает на базе get_post().

Функция возвращает массив данных с дополнительными полями: post_category и tags_input.

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

<?php wp_get_single_post( $postid, $mode ) ?>

Параметры

$postid (число): ID поста (записи).
По умолчанию: 0
$mode (константа): Одна из трех констант.
* OBJECT - результат будет возвращен в виде объекта. Установлена по умолчанию
* ARRAY_A - результат будет возвращен в виде ассоциативного массива.
* ARRAY_N - результат будет возвращен в виде пронумерованного массива.
По умолчанию: OBJECT

Примеры

1. Выведем на экран контент записи 14:

<?php
$post_14 = wp_get_single_post( 14 );
echo $post_14->post_content;
?>

Данные, возвращаемые в массиве

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 (число): Количество комментариев у записи.
post_category (?): Категории, к которым относится пост.
tags_input (?): Метки к которым относится пост.

wp_get_single_post()

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

function wp_get_single_post($postid = 0, $mode = OBJECT) {
	$postid = (int) $postid;

	$post = get_post($postid, $mode);

	if (
		( OBJECT == $mode && empty( $post->ID ) ) ||
		( OBJECT != $mode && empty( $post['ID'] ) )
	)
		return ( OBJECT == $mode ? null : array() );

	// Set categories and tags
	if ( $mode == OBJECT ) {
		$post->post_category = array();
		if ( is_object_in_taxonomy($post->post_type, 'category') )
			$post->post_category = wp_get_post_categories($postid);
		$post->tags_input = array();
		if ( is_object_in_taxonomy($post->post_type, 'post_tag') )
			$post->tags_input = wp_get_post_tags($postid, array('fields' => 'names'));
	} else {
		$post['post_category'] = array();
		if ( is_object_in_taxonomy($post['post_type'], 'category') )
			$post['post_category'] = wp_get_post_categories($postid);
		$post['tags_input'] = array();
		if ( is_object_in_taxonomy($post['post_type'], 'post_tag') )
			$post['tags_input'] = wp_get_post_tags($postid, array('fields' => 'names'));
	}

	return $post;
}

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

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

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

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