wordpress函数wp_insert_post插入文章或页面详解

一般情况下使用wp_insert_post函数向wordpress数据库插入文章或页面的情况比较少，这个WP函数在采集方面用得比较多。因此，如果你想做个采集软件，或者想写个wordpress采集接口，这个函数是必须会的，一起来学习下wp_insert_post函数的用法吧。

wp_insert_post( array $postarr, bool $wp_error = false )

官方描述，插入或更新一个文章或页面，传入id为更新，不传则创建。

参数详解

$postarr

(array) (必须) 包含更新或插入内容的数组

• ‘ID’
  (int) 文章ID，如果不等于0则更新，等于0则创建，默认为0。
• ‘post_author’
  (int) 添加文章的作者，默认为当前用户。
• ‘post_date’
  (string) 文章添加日期，默认为当前日期
• ‘post_date_gmt’
  (string) 在格林尼治时间区域中的时间，默认为 $post_date的值.
• ‘post_content’
  (mixed) 文章内容，默认为空.
• ‘post_content_filtered’
  (string) 过滤后的帖子内容。默认空.
• ‘post_title’
  (string) 文章标题。默认空.
• ‘post_excerpt’
  (string) 文章摘要。默认空.
• ‘post_status’
  (string) 文章状态，默认为 ‘draft’.
• ‘post_type’
  (string) 文章类型，默认为 ‘post’.
• ‘comment_status’
  (string) 文章评论状态开关，默认是 ‘default_comment_status’ 配置项的值.
• ‘ping_status’
  (string) ping状态开关，默认是’default_ping_status’ 配置项的值.
• ‘post_password’
  (string) 文章阅读密码，默认为空.
• ‘post_name’
  (string) 文章的名字。默认情况下，在创建新文章时，必须使用经过净化的文章标题.
• ‘to_ping’
  (string) 空格或回车将url的列表分隔成ping，默认是空的.
• ‘pinged’
  (string) 空格或回车分隔的url列表，默认是空的.
• ‘post_modified’
  (string) 上次修改后的日期，默认是当前时间.
• ‘post_modified_gmt’
  (string) 最后在GMT时区修改后的日期，默认是当前时间.
• ‘post_parent’
  (int) 文章的父级文章ID，默认为 0.
• ‘menu_order’
  (int) 如果新文章为一个页面，可以设置一个页面序号，默认为 0.
• ‘post_mime_type’
  (string) 文章的mime类型，默认是空的.
• ‘guid’
  (string) 全局唯一ID，用于引用post，默认是空的.
• ‘post_category’
  (array) 文章分类目录，默认值为『default_category』选项的值.
• ‘tags_input’
  (array) 文章标签，默认为空.
• ‘tax_input’
  (array) 文章的自定义分类法项目，默认为空.
• ‘meta_input’
  (array) 自定义字段，默认为空.
• page_template
  页面模板文件的名称，如，template.php，默认为空。
  

$wp_error

(bool) (Optional) 是否在失败时返回wp_error

默认值: false

返回值

(int|WP_Error)成功返回post_id，失败返回0或wp_error

简单使用

//准备文章内容
$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 );