WordPress插入文章函数：wp_insert_post

WordPress函数wp_insert_post用于插入一篇新的文章。

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

函数参数

$postarr

数组

• ID：文章的ID，如果传递0以外的值，则更新相应ID的文章而不是插入新的文章；

• post_author：作者的ID，默认为当前作者；

• post_date：发表时间，格式为Y-m-d H:i:s，默认为当前时间；

• post_date_gmt：发表文章的格林时间，与国内时区相差8小时；

• post_content：文章内容；

• post_content_filtered：文章内容过滤；

• post_title：文章标题；

• post_excerpt：文章摘要；

• post_status：文章状态，默认值：draft

• post_type：文章类型，默认值：post

• comment_status：是否允许评论，可用值：open或closed，默认取wp_options表中default_comment_status的值，即后台讨论设置中“允许他人在新文章上发表评论”选项；

• ping_status：是否允许其他博客发送链接通知，可用值：open或closed，默认取wp_options表中default_ping_status的值，即后台讨论设置中“允许其他博客发送链接通知（pingback和trackback）到新文章”选项；

• post_password：访问密码，默认为空；

• post_name：文章别名；

• to_ping：使用空格或回车分隔要ping的URL列表；

• pinged：空格或回车分隔已ping的url列表；

• post_modified：文章的修改时间，格式为Y-m-d H:i:s，默认为当前时间；

• post_modified_gmt：修改文章的格林时间；

• post_parent：父级ID；

• menu_order：文章的显示顺序；

• post_mime_type：MIME类型，适用于插入附件时；

• guid：文章链接，当设置固定链接后为伪静态格式，默认为动态链接；

• post_category：数组，文章分类的ID；

• tags_input：数组，标签名称、别名或ID；

• tax_input：数组，自定义分类法名称；

• meta_input：数组，post meta的键值对；

$wp_error

布尔值，默认值：false

是否返回错误信息

$fire_after_hooks

布尔值，默认值：true

是否启用插入文章后的hooks

函数使用示例

$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 );

扩展阅读

wp_insert_post()函数位于：wp-includes/post.php

相关函数：

• wp_after_insert_post()

• wp_update_post()

• sanitize_post()

欢迎咨询/Welcome to inquire