title: "wp post create" post_status: publish comment_status: open taxonomy: category: - wp-cli-handbook post_tag: - Post - Commands - Repos

wp post create

创建一篇新文章。

选项

有关所用语法约定的详细说明，请参阅参数语法参考。

[--post_author=<post_author>] : 添加文章的用户 ID。默认为当前用户 ID。

[--post_date=<post_date>] : 文章的发布日期。默认为当前时间。

[--post_date_gmt=<post_date_gmt>] : 文章在 GMT 时区的发布日期。默认为 $post_date 的值。

[--post_content=<post_content>] : 文章内容。默认为空。

[--post_content_filtered=<post_content_filtered>] : 过滤后的文章内容。默认为空。

[--post_title=<post_title>] : 文章标题。默认为空。

[--post_excerpt=<post_excerpt>] : 文章摘要。默认为空。

[--post_status=<post_status>] : 文章状态。默认为 'draft'（草稿）。

[--post_type=<post_type>] : 文章类型。默认为 'post'（文章）。

[--comment_status=<comment_status>] : 文章是否允许评论。接受 'open'（开放）或 'closed'（关闭）。默认为 'default_comment_status' 选项的值。

[--ping_status=<ping_status>] : 文章是否允许 ping。接受 'open'（开放）或 'closed'（关闭）。默认为 'default_ping_status' 选项的值。

[--post_password=<post_password>] : 访问文章的密码。默认为空。

[--post_name=<post_name>] : 文章名称（别名）。创建新文章时，默认为经过清理的文章标题。

[--from-post=<post_id>] : 要复制的文章 ID。

[--to_ping=<to_ping>] : 要 ping 的 URL 列表，以空格或回车分隔。默认为空。

[--pinged=<pinged>] : 已 ping 过的 URL 列表，以空格或回车分隔。默认为空。

[--post_modified=<post_modified>] : 文章最后修改日期。默认为当前时间。

[--post_modified_gmt=<post_modified_gmt>] : 文章在 GMT 时区的最后修改日期。默认为当前时间。

[--post_parent=<post_parent>] : 设置此文章所属的父文章 ID（如果有的话）。默认为 0。

[--menu_order=<menu_order>] : 文章的显示顺序。默认为 0。

[--post_mime_type=<post_mime_type>] : 文章的 MIME 类型。默认为空。

[--guid=<guid>] : 用于引用文章的全局唯一标识符。默认为空。

[--post_category=<post_category>] : 分类名称、别名或 ID 的数组。默认为 'default_category' 选项的值。

[--tags_input=<tags_input>] : 标签名称、别名或 ID 的数组。默认为空。

[--tax_input=<tax_input>] : 按分类法名称索引的分类法术语数组。默认为空。

[--meta_input=<meta_input>] : 按文章元数据键索引的文章元数据值 JSON 格式数组。默认为空。

[<file>] : 从 <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'
成功：已创建文章 1921。

# 使用指定文件的内容创建文章
$ wp post create ./post-content.txt --post_category=201,345 --post_title='来自文件的文章'
成功：已创建文章 1922。

# 创建包含多个元数据的文章。
$ wp post create --post_title='一篇文章' --post_content='只是一篇小文章。' --meta_input='{"key1":"value1","key2":"value2"}'
成功：已创建文章 1923。

# 从现有文章创建重复文章。
$ wp post create --from-post=123 --post_title='不同的标题'
成功：已创建文章 2350。

GLOBAL PARAMETERS

These global parameters have the same behavior across all commands and affect how WP-CLI interacts with WordPress.