您的当前位置:首页 > 知识博客 > wordpress建站

WordPress插入文章函数:wp_insert_post

时间:2024-03-10

WordPress函数wp_insert_post用于插入一篇新的文章。

wp_insert_post( array $postarr, bool $wp_error = false, bool $fire_after_hooks = true )

函数参数

$postarr

数组

  • ID:文章的ID,如果传递0以外的值,则更新相应ID的文章而不是插入新的文章;

  • post_author:作者的ID,默认为当前作者;

  • post_date:发表时间,格式为Y-m-d H:i:s,默认为当前时间;

  • post_date_gmt:发表文章的格林时间,与国内时区相差8小时;

  • post_content:文章内容;

  • post_content_filtered:文章内容过滤;

  • post_title:文章标题;

  • post_excerpt:文章摘要;

  • post_status:文章状态,默认值:draft

  • post_type:文章类型,默认值:post

  • comment_status:是否允许评论,可用值:open或closed,默认取wp_options表中default_comment_status的值,即后台讨论设置中“允许他人在新文章上发表评论”选项;

  • ping_status:是否允许其他博客发送链接通知,可用值:open或closed,默认取wp_options表中default_ping_status的值,即后台讨论设置中“允许其他博客发送链接通知(pingback和trackback)到新文章”选项;

  • post_password:访问密码,默认为空;

  • post_name:文章别名;

  • to_ping:使用空格或回车分隔要ping的URL列表;

  • pinged:空格或回车分隔已ping的url列表;

  • post_modified:文章的修改时间,格式为Y-m-d H:i:s,默认为当前时间;

  • post_modified_gmt:修改文章的格林时间;

  • post_parent:父级ID;

  • menu_order:文章的显示顺序;

  • post_mime_type:MIME类型,适用于插入附件时;

  • guid:文章链接,当设置固定链接后为伪静态格式,默认为动态链接;

  • post_category:数组,文章分类的ID;

  • tags_input:数组,标签名称、别名或ID;

  • tax_input:数组,自定义分类法名称;

  • meta_input:数组,post meta的键值对;

$wp_error

布尔值,默认值:false

是否返回错误信息

$fire_after_hooks

布尔值,默认值:true

是否启用插入文章后的hooks

函数使用示例

$my_post = array(
	'post_title'    => wp_strip_all_tags( $_POST['post_title'] ),
	'post_content'  => $_POST['post_content'],
	'post_status'   => 'publish',
	'post_author'   => 1,
	'post_category' => array( 8,39 )
);
wp_insert_post( $my_post );

扩展阅读

wp_insert_post()函数位于:wp-includes/post.php

相关函数:

  • wp_after_insert_post()

  • wp_update_post()

  • sanitize_post()


欢迎咨询/Welcome to inquire
tel/vx:18842938855
qq:1685522781
email:1685522781@qq.com

Copyright © 2019-2024 wangyesheji.net


Whatsapp