WordPress 插入文章函数 wp_insert_post()

本文被收录到:

WordPress 开发文档

WordPress是一款能让您建立出色网站、博客或应用程序的开源软件。美观的设计,强大的功能,助您自由发挥心中所想。WordPress既是免费的,也是无价的。全世界 43% 的网站都在使用WordPress,小到兴趣博客,大到新闻网站。

目录

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标签。但请注意,这样做可能带来安全风险,因此确保正确地处理和验证用户提交的内容是非常重要的。

声明:本站所有文章和图片,如无特殊说明,均为原创发布。商业转载请联系作者获得授权,非商业转载请注明出处。
真诚赞赏,手留余香
赞赏
搜神记
763 文章
4 教程
8 项目
随机推荐
WordPress 数据库操作
Node.js 模块概念
WordPress 侧边栏小工具
WordPress 常用函数 / sanitize_user
curl 的用法指南
JavaScript 类
FFmpeg 修改默认音轨
Node.js MySQL2 如何编写事务