wp_insert_post() | WordPress插入页面/文章的函数

函数

wp_insert_post( $postarr, $wp_error );

描述

该函数可用于投稿、WordPress主题启用时自动创建页面、问答等功能。

参数

$postarr = array(
    'ID'                    => '0', // (int)默认值为0，如果是0以外的值，则该 ID 的文章将被更新。
    'post_author'           => get_current_user_id(), // (int)文章作者的ID，默认为当前登录的用户ID
    'post_date'             => '', // 文章发布时间，默认为当前时间。
    'post_date_gmt'         => '', // (字符串)GMT格式的文章发布时间。默认值是$post_date的值。
    'post_content'          => '', // (字符串)文章内容，默认为空。
    'post_content_filtered' => '', // (字符串)过滤后的内容，默认是空的。不要管这个，WordPress会自动处理。
    'post_title'            => '', // (字符串)文章标题，默认为空.
    'post_excerpt'          => '', // (字符串)文章摘要，默认为空。
    'post_status'           => '', // (字符串)文章状态，默认为『draft』，即草稿。
    'post_type'             => '', // (字符串)文章类型，默认为『post』.
    'comment_status'        => '', // (字符串)是否可以接受评论。接受『打开』或『关闭』。默认值是『default_comment_status』选项的值。
    'ping_status'           => '', // (字符串)是否可以接受ping命令。接受『打开』或『关闭』。默认值是『default_ping_status』选项的值。
    'post_password'         => '', // (字符串)访问该文章的密码，默认是空的。
    'post_name'             => '', // (字符串)文章的别名，当发布新的文章时会默认创建。
    'to_ping'               => '', // (字符串)空格或回车将url的列表分隔成ping，默认是空的。
    'pinged'                => '', // (字符串)空格或回车分隔的url列表，默认是空的。
    'post_modified'         => '', // (字符串)上次修改后的日期，默认是当前时间。
    'post_modified_gmt'     => '', // (字符串)最后在GMT时区修改后的日期，默认是当前时间。
    'post_parent'           => '', // (int)文章的父级文章ID，默认为 0。
    'menu_order'            => '', // (int)如果新文章为一个页面，可以设置一个页面序号，默认为 0。
    'post_mime_type'        => '', // (字符串)文章的mime类型，默认是空的。
    'guid'                  => '', // (字符串)全局唯一ID，用于引用post，默认是空的。
    'post_category'         => '', // (数组)文章分类目录，默认值为『default_category』选项的值。
    'tags_input'            => '', // (数组)文章标签，默认为空。
    'tax_input'             => '', // (数组)文章的自定义分类法项目，默认为空。
    'meta_input'            => '', // (数组)自定义字段，默认为空。
    'page_template'         => '', // 页面模板文件的名称，如，template.php，默认为空。
);

$wp_error (可选)是否返回失败的 WP_Error。默认值：false

例子

$my_post = array(
  'post_title'    => wp_strip_all_tags( $_POST['post_title'] ),
  'post_content'  => $_POST['post_content'],
  'post_status'   => 'publish',
  'post_author'   => 1,
  'post_category' => array( 8,39 )
);
// 插入文章到数据库
wp_insert_post( $my_post );