该函数可在数据库中插入文章（及页面）。它可以进行处理变量，检查操作，填充日期/时间等缺失变量等工作。该函数以对象作为变量，返回已创建文章的编号（出错时返回0）。

用法

<?php wp_insert_post( $post, $wp_error ); ?>

参数
$post
(array) (必需) 一个文章对象. 与数据库wp_posts表中的字段一一对应

默认: 无
重要: 如果设置$post['ID']的值，将不会创建 这个ID的文章. 设置这个值将会更新这个ID的文章. 简单的说，创建一个文章 $post['ID'] 必须为空或不设置这个值.

 

[pcsh lang="php" tab_size="4" message="" hl_lines="" provider="manual"]

$post = array(
	'ID' => [ <post id> ] //需要更新的文章编号
	'menu_order' => [ <order> ] //如果新文章是页面，设置显示顺序
	'comment_status' => [ 'closed' | 'open' ] // 评论的状态，'closed'关闭评论.
	'ping_status' => [ 'closed' | 'open' ] // ping的状态，'closed' 关闭 pingbacks和trackbacks
	'pinged' => [ ? ] //该文章被ping到的地址
	'post_author' => [ <user ID> ] //作者编号
	'post_category' => [ array(<category id>, <...>) ] //文章归类数组
	'post_content' => [ <the text of the post> ] //文章内容，必填
	'post_date' => [ Y-m-d H:i:s ] //文章编辑日期
	'post_date_gmt' => [ Y-m-d H:i:s ] //文章编辑GMT日期
	'post_excerpt' => [ <an excerpt> ] //摘要信息
	'post_name' => [ <the name> ] // (slug) 文章别名
	'post_parent' => [ <post ID> ] //新文章的父文章编号
	'post_password' => [ ? ] //文章浏览密码
	'post_status' => [ 'draft' | 'publish' | 'pending'| 'future' | 'private' ] //新文章的状态
	'post_title' => [ <the title> ] //文章标题，必填
	'post_type' => [ 'post' | 'page' | 'link' | 'nav_menu_item' | custom post type ] //文章类型：文章、页面、链接、菜单、其他定制类型
	'tags_input' => [ '<tag>, <tag>, <...>' ] //标签字符串
	'to_ping' => [ ? ] //该文章需要ping到的地址
	'tax_input' => [ array( 'taxonomy_name' => array( 'term', 'term2', 'term3' ) ) ] // 附加注释数组
);

[/pcsh]

$wp_error
(布尔型) (可选) 失败时是否返回WP_Error对象

默认: false
返回的值
若文章成功加入数据库，返回文章编号。否则返回0.

最后更新于 2017-03-17 15:58:08 并被添加「」标签，已有 463 位童鞋阅读过。