wordpress函数wp_insert_post的详细用法解析

函数wp_insert_post是WordPress中用于创建或更新文章的函数。下面模板兔说一下它的详细用法：

1. 语法：wp_insert_post( $postarr,$wp_error )
2. 参数：

• $postarr：必选参数，是一个数组，包含了要创建或更新的文章的各种属性和内容。该数组至少应包含以下键值对：
  • 'post_title'：文章标题；
  • 'post_content'：文章正文；
  • 'post_status'：文章状态，例如：'publish'、'draft'、'pending'等；
  • 'post_author'：文章作者的用户ID；
  • 'post_type'：文章类型，例如：'post'、'page'等；
  • 'post_category'：文章所属的分类ID数组；
  • 'tags_input'：文章标签数组。
• $wp_error：可选参数，如果设置为true，则在创建或更新文章时遇到错误时返回WP_Error对象；如果设置为false，则返回0或文章ID。

3. 返回值：

• 如果创建或更新文章成功，则返回文章的ID；
• 如果遇到错误，则返回0或WP_Error对象。

4. 示例：

// 创建一篇新文章
$new_post = array(
    'post_title' => '这是一篇新文章',
    'post_content' => '这是新文章的正文内容。',
    'post_status' => 'publish',
    'post_author' => 1,
    'post_type' => 'post',
    'post_category' => array(1, 2),
    'tags_input' => array('tag1', 'tag2'),
);
$post_id = wp_insert_post($new_post);

// 更新一篇已有文章
$existing_post = array(
    'ID' => 123,
    'post_title' => '这是更新后的文章标题',
    'post_content' => '这是更新后的文章正文内容。',
    'post_status' => 'publish',
    'post_author' => 1,
    'post_type' => 'post',
    'post_category' => array(1, 3),
    'tags_input' => array('tag1', 'tag3'),
);
$post_id = wp_insert_post($existing_post);