Добавление публикаций в WordPress

Помимо стандартных способов добавления публикаций, в WordPress можно добавлять статьи через функцию "wp_insert_post".

Функцию "wp_insert_post" можно использовать даже на небезопасных данных, потому что она обеззараживает все входящие параметры, используя функцию "sanitize_post".

При использовании функции происходит вызов всех фильтров и событий, которые привязаны к созданию публикации. Читайте подробнее в статье "Фильтры и события (хуки) в WordPress"
Функция "wp_insert_post" имеет два аргумента. Первый - это массив, который описывает новую публикацию: заголовок, текст, id автора и т.п. Второй параметр - это логический флаг (true/false) вывода ошибок:
$post_id = wp_insert_post( $data, $wp_error );
Функция во вращает следующие значения:
  • ID новой записи - при успешном добавлении записи функция возвращает ID новой записи
  • "0" - ноль при появлении ошибки, если параметр $wp_error равен "false"
  • "WP_Error" объект - если произошла ошибка и параметр $wp_error "true"
Приведём пример использования функции "wp_insert_post":
<php
$data = array(
   'post_title'    => 'Заголовок публикации',
   'post_content'  => 'Содержание публикации',
   'post_status'   => 'publish', // статус: publish - опубликовано
   'post_author'   => 1, // id автора публикации
   'post_category' => array( 3,4,9 ) // id рубрик, в которых находится публикация
);
$post_id = wp_insert_post( $data );
echo $post_id; // распечатает id добавленной публикации
Рассмотрим ключи массива, описывающего публикацию функции:
Название Описание
ID ID существующей публикации, если происходит обновление
post_title Заголовок публикации.
post_excerpt Цитата записи.
post_name Ярлык записи (используется в URL адресе).
menu_order Порядок в меню (для прикрепленных страниц).
comment_status Статус комментировани: 'closed' - нельзя комментировать, 'open' - можно.
ping_status Статус пингов. 'closed' - пинги выключены, 'open' включены.
post_author ID автора записи
post_content Полный текст записи.
post_date Дата и время создания записи. Формат: Y-m-d H:i:s.
post_date_gmt Дата и время создания записи. Формат: Y-m-d H:i:s (по Гринвичу).
post_parent ID родительской записи.
post_password Пароль для просмотра записи.
post_status Статус записи: 'draft' - черновик, 'publish' - опубликовано, 'pending' - на утверждении, 'future' - запланирован на публикацию в будущем, 'private' - видно только администратору.
post_type Тип публикации: 'post' - обычная запись, 'page' - страница, 'link' - ссылка, 'nav_menu_item' - элемент навигации.
post_category Массив из рубрик, в которым привязана публикация.
tags_input Массив из тегиов публикации.
tax_input Массив из таксономий публикации.
MouseDC.ru - хостинг, виртуальный хостинг, покупка доменов, проверка доменов, WHOIS, курсы создания сайтов, вебинары по созданию, курсы разработки сайтов, доработка сайтов, сопровождение сайтов, разработка сайтов, техподдержка сайтов
Была ли эта статья полезна? Есть вопрос?
Cмотрите другие статьи: