WordPress 插入文章函数 wp_insert_post()

wp_insert_post() 简介：

wp_insert_post() 是 WordPress 中的一个核心函数，用于在 WordPress 数据库中插入或更新一篇文章（包括页面和其他自定义文章类型）。这个函数非常强大且灵活，允许开发者或插件作者以编程方式创建新的文章记录。

基本语法：

wp_insert_post( $postarr, $wp_error );

参数说明：

$postarr （必需）：这是一个关联数组，包含要插入或更新的文章的所有属性，比如标题、内容、状态、自定义字段、分类等。常见的键可能包括但不限于：

post_title — 文章标题
post_content — 文章正文内容
post_status — 文章状态（如 ‘publish’、’draft’、’pending’ 等）
post_date 或 post_date_gmt — 发布日期
post_author — 文章作者的用户 ID
post_name — 文章别名（slug）
post_type — 文章类型（通常是 ‘post’，也可以是自定义文章类型）
comment_status — 评论状态
ping_status — 追踪回访（pingback/trackback）状态
post_category 或 categories — 分类数组（如果是整数，则表示分类 ID；如果是字符串，则表示分类 slug）
tags_input 或 tax_input — 自定义分类法或标签的关联数组

$wp_error （可选，默认为 false）：如果设置为 true，则函数会返回 WP_Error 对象而不是文章 ID，当插入失败时可以用来获取错误信息。

示例用法：

// 示例：插入一个新的草稿文章
$new_post = array(
    'post_title' => 'My New Post Title',
    'post_content' => 'This is the content of my new post.',
    'post_status' => 'draft',
    'post_author' => 1, // 用户 ID
    'post_type' => 'post',
);


// 插入文章并获取新文章的 ID
$post_id = wp_insert_post( $new_post );


if ( is_wp_error( $post_id ) ) {
    // 如果插入失败，输出错误信息
    echo $post_id->get_error_message();
} else {
    // 成功插入，可以在此处进一步处理，如添加分类或元数据等
}

如果你发现使用 wp_insert_post() 函数插入的内容中的 HTML 标签被自动去除，通常是因为经过了某种形式的自动格式化或净化。这可能与 WordPress 的默认kses过滤器有关，可以通过移除或修改这些过滤器来保留HTML标签。但请注意，这样做可能带来安全风险，因此确保正确地处理和验证用户提交的内容是非常重要的。