WordPress.org

Ready to get started?Download WordPress

Codex

Справочник по функциям/get post

Contents

Описание

В качестве аргумента принимает ID записи и возвращает хранящуюся в базе данных информацию о ней. Формат возвращаемых данных зависит от параметра $output.

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

<?php get_post$post$output ); ?> 

Параметры

$post
(integer) (required) ID записи, которую вы бы хотели «достать». Вам нужно подставлять именно переменную со значением ID (напр. $id), а не просто цифру, равную ID (напр. 7). В последнем случае получите критическую ошибку. (Only variables can be passed for reference или Cannot pass parameter 1 by reference)
Default: None
$output
(string) (optional) Определяет формат возвращаемых данных.
  • OBJECT — возвращает объект
  • ARRAY_A — возвращает ассоциативный массив, в котором индексами служат названия полей в базе данных, а значениями данные из этих полей
  • ARRAY_N — возвращает числовой массив с данными из полей
Default: OBJECT

Примеры

Для вывода заголовка записи с ID 7:

<?php
$my_id 
7;
$post_id_7 get_post($my_id); 
$title $post_id_7->post_title;
?> 

Тоже самое, но с указанием формата возвращаемых данных «Как ассоциативный массив». Для этого зададим параметру $output значение ARRAY_A:

<?php
$my_id 
7;
$post_id_7 get_post($my_idARRAY_A);
$title $post_id_7['post_title'];
?> 

<?php
##    Правильно: зададим значение переменной равное ID записи
$the_post = & get_post$dummy_id );
    
##    Неправильно: зададим литерал 7 равный ID записи
$the_post = & get_post);
//    Получим Fatal error: 'Only variables can be passed for reference' или 'Cannot pass parameter 1 by reference'
?>

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

В случае ошибки эта функция возвращает null.

Возвращаемые поля:

ID 
(integer) ID записи
post_author 
(integer) ID автора записи
post_date 
(string) Дата и время создания записи (ГГГГ-ММ-ДД ЧЧ:ММ:СС)
post_date_gmt 
(string) Дата и время создания записи по Гринвичу (GMT) (ГГГГ-ММ-ДД ЧЧ:ММ:СС)
post_content 
(string) Содержание записи.
post_title 
(string) Заголовок записи
post_category 
(integer) ID рубрики к которой принадлежит запись. Важно помнить, что это значения всегда будет равно 0 начиная с Wordpress 2.1 Для определения рубрики или рубрик, в которых находится запись используйте get_the_category().
post_excerpt 
(string) Выдержка из записи (отрывок текста)
post_status 
(string) Статус записи (publish|pending|draft|private|static|object|attachment|inherit|future)
comment_status 
(string) Статус комментирования (open|closed|registered_only)
ping_status 
(string) Статус пингов и трекбеков (open|closed)
post_password 
(string) Пароль записи
post_name 
(string) Приставка к URL записи (slug, ее видно в URL, если включена опция ЧПУ)
to_ping 
(string) URL'ы для пингов
pinged 
(string) URL'ы, которые уже были «пропингованы»
post_modified 
(string) Дата и время последнего редактирования записи (ГГГГ-ММ-ДД ЧЧ:ММ:СС)
post_modified_gmt 
(string) Дата и время последнего редактирования записи по Гринвичу (GMT) (ГГГГ-ММ-ДД ЧЧ:ММ:СС)
post_content_filtered 
(string)
post_parent 
(integer) ID родительской записи (для вложений, например и т.п.)
guid 
(string) Cсылка на запись. Примечание: не всегда GUID это постоянная (неизменяемая) ссылка на запись (как это было до версии 2.5). Можно сказать, что это текущая ссылка на конретную запись.
menu_order 
(integer) Число определяющее «рейтинг» записи (влияет на порядок вывода страниц в списке)
post_type 
(string) Тип записи (post|page|attachment)
post_mime_type 
(string) Mimе-тип (для вложений, проч.)
comment_count 
(integer) Число комментариев

Ссылки

Тема закрыта для обсуждения.

Исходный файл

get_post() объявляется в /wp-includes/post.php (а также и в /wp-app.php)

См. также содержание справочника по функциям и список тегов шаблонов.