云策 WordPress 开发者社区

WP CLI说明文档

wp post create

查看官方原文 ↗

命令概述

用于创建一篇新文章，支持通过参数指定文章标题、内容、状态、分类、标签、元数据等所有标准字段。

适合在自动化脚本、批量内容导入或从文件读取内容时使用，也可从现有文章复制创建。

参数列表

参数 说明
--post_author 添加文章的用户ID。默认为当前用户ID。
--post_date 文章的日期。默认为当前时间。
--post_date_gmt 文章在GMT时区的日期。默认为$post_date的值。
--post_content 文章内容。默认为空。
--post_content_filtered 过滤后的文章内容。默认为空。
--post_title 文章标题。默认为空。
--post_excerpt 文章摘要。默认为空。
--post_status 文章状态。默认为’draft’。
--post_type 文章类型。默认为’post’。
--comment_status 文章是否允许评论。接受’open’或’closed’。默认为’default_comment_status’选项的值。
--ping_status 文章是否允许ping。接受’open’或’closed’。默认为’default_ping_status’选项的值。
--post_password 访问文章的密码。默认为空。
--post_name 文章别名。默认为创建新文章时清理后的文章标题。
--from-post 要复制的文章ID。
--to_ping 用空格或回车分隔的要ping的URL列表。默认为空。
--pinged 用空格或回车分隔的已ping的URL列表。默认为空。
--post_modified 文章最后修改日期。默认为当前时间。
--post_modified_gmt 文章在GMT时区最后修改的日期。默认为当前时间。
--post_parent 设置文章所属的父文章。默认为0。
--menu_order 文章显示顺序。默认为0。
--post_mime_type 文章的MIME类型。默认为空。
--guid 用于引用文章的全局唯一ID。默认为空。
--post_category 分类名称、别名或ID的数组。默认为’default_category’选项的值。
--tags_input 标签名称、别名或ID的数组。默认为空。
--tax_input 以分类法名称为键的分类术语数组。默认为空。
--meta_input 以文章元键为键的文章元值的JSON格式数组。默认为空。
<file> 从文件读取文章内容。如果存在此值，则--post_content参数将被忽略。传递-作为文件名将导致文章内容从STDIN读取。
--<field>=<value> 新文章的关联参数。参见wp_insert_post()。
--edit 立即打开系统编辑器来编写或编辑文章内容。如果从文件、STDIN或--post_content参数读取内容，该文本将被加载到编辑器中。
--porcelain 仅输出新文章ID。

常用示例

创建文章并安排未来发布

$ wp post create --post_type=post --post_title='未来发布的文章' --post_status=future --post_date='2030-12-01 07:00:00'

从给定文件创建文章内容

$ wp post create ./post-content.txt --post_category=201,345 --post_title='Post from file'

创建带有多个元值的文章

$ wp post create --post_title='A post' --post_content='Just a small post.' --meta_input='{"key1":"value1","key2":"value2"}'

从现有文章创建重复文章

$ wp post create --from-post=123 --post_title='Different Title'