Справочник по функциям/get post
Languages:
English •
Русский •
(Add your language)
Описание
В качестве аргумента принимает 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_id, ARRAY_A);
$title = $post_id_7['post_title'];
?>
<?php
## Правильно: зададим значение переменной равное ID записи
$the_post = & get_post( $dummy_id = 7 );
## Неправильно: зададим литерал 7 равный ID записи
$the_post = & get_post( 7 );
// Получим 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)
