WordPress常用函数wp insert post
来自站长百科
导航: 上一页 | 首页 | WordPress中文论坛 | WordPress主机 | CMS程序 | 论坛程序 | ECShop | ShopNC | PowerEasy
说明[ ]
该函数可在数据库中插入文章（及页面）。它可以进行处理变量，检查操作，填充日期/时间等缺失变量等工作。该函数以对象作为变量，返回已创建文章的编号（出错时返回0）。
用法[ ]
<?php wp_insert_post( $post ); ?>
示例[ ]
调用wp_insert_post（）前需创建对象以传递组成文章的必要元素。wp_insert_post（）可自动填写默认表格，但用户需提供文章标题和内容，否则数据库写入不成功。
用户可在数据库中简单定义新关键字，之后就可以添加更多文章要素。关键字应与数据库wp_posts表格中纵列名称相匹配。
// Create post object $my_post = array(); $my_post['post_title'] = 'My post'; $my_post['post_content'] = 'This is my post.'; $my_post['post_status'] = 'publish'; $my_post['post_author'] = 1; $my_post['post_category'] = array(8,39); // Insert the post into the database wp_insert_post( $my_post );
上面提到的默认表格在函数主体中有所定义。定义如下：
$defaults = array(
'post_status' => 'draft',
'post_type' => 'post',
'post_author' => $user_ID,
'ping_status' => get_option('default_ping_status'),
'post_parent' => 0,
'menu_order' => 0,
'to_ping' => ,
'pinged' => ,
'post_password' => ,
'guid' => ,
'post_content_filtered' => ,
'post_excerpt' =>
);
类别
需要将类别作为整数数组传递，该数组应与数据库中的类别编号相匹配。即使文章只属于某一项类别，情况也应如此。
参数[ ]
$post
（对象）（必需）能表示可组成文章元素的对象。这些元素与数据库wp_posts表格中的纵列名称应一一对应。
默认值：空
文章数组的内容可取决于用户的默认值的信赖程度。下表列出了用户可为文章设置的所有选项：
$post = array( 'comment_status' => [ 'closed' | 'open' ] // 'closed' means no comments. 'ID' => [ <post id> ] //Are you updating an existing post? 'menu_order' => [ <order> ] //If new post is a page, sets the order should it appear in the tabs. 'page_template => [ <template file> ] //Sets the template for the page. 'ping_status' => [ ? ] //Ping status? 'pinged' => [ ? ] //? 'post_author' => [ <user ID> ] //The user ID number of the author. 'post_category => [ array(<category id>, <...>) ] //Add some categories. 'post_content' => [ <the text of the post> ] //The full text of the post. 'post_date' => [ Y-m-d H:i:s ] //The time post was made. 'post_date_gmt' => [ Y-m-d H:i:s ] //The time post was made, in GMT. 'post_excerpt' => [ <an excerpt> ] //For all your post excerpt needs. 'post_parent' => [ <post ID> ] //Sets the parent of the new post. 'post_password' => [ ? ] //password for post? 'post_status' => [ 'draft' | 'publish' | 'pending' ] //Set the status of the new post. 'post_title' => [ <the title> ] //The title of your post. 'post_type' => [ 'post' | 'page' ] //Sometimes you want to post a page. 'tags_input' => [ '<tag>, <tag>, <...>' ] //For tags. 'to_ping' => [ ? ] //? );
返回的值
若文章成功加入数据库，返回文章编号。否则返回0.