Feature: Manage WordPress posts

Background:

Given a WP install

Scenario: Creating/updating/deleting posts

When I run `wp post create --post_title='Test post' --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `wp post create --post_title='Test post' --post_type="test" --porcelain`

Then STDOUT should be a number

And save STDOUT as {CUSTOM_POST_ID}

When I run `wp post exists {CUSTOM_POST_ID}`

Then STDOUT should be:

"""

And the return code should be 0

When I try `wp post exists 1000`

Then STDOUT should be empty

And the return code should be 1

When I run `wp post update {POST_ID} --post_title='Updated post'`

Then STDOUT should be:

"""

When I run `wp post delete {POST_ID}`

Then STDOUT should be:

"""

When I run the previous command again

Then STDOUT should be:

"""

When I run `wp post delete {CUSTOM_POST_ID}`

Then STDOUT should be:

"""

When I run the previous command again

Then STDOUT should be:

"""

Scenario: Force-deleting a custom post type post skips trash

When I run `wp post create --post_title='Test CPT post' --post_type='book' --porcelain`

Then STDOUT should be a number

And save STDOUT as {BOOK_POST_ID}

When I run `wp post delete {BOOK_POST_ID} --force`

Then STDOUT should be:

"""

When I try the previous command again

Then the return code should be 1

Scenario: Deleting already trashed custom post type posts

When I run `wp post create --post_title='Test CPT post' --post_type='book' --porcelain`

Then STDOUT should be a number

And save STDOUT as {BOOK_POST_ID}

When I run `wp post update {BOOK_POST_ID} --post_status='trash'`

Then STDOUT should be:

"""

When I run `wp post delete {BOOK_POST_ID}`

Then STDOUT should be:

"""

Scenario: Updating an invalid post should exit with an error

Given a WP install

When I try `wp post update 22 --post_title=Foo`

Then the return code should be 1

And STDERR should contain:

"""

Scenario: Setting post categories

When I run `wp term create category "First Category" --porcelain`

Then save STDOUT as {TERM_ID}

When I run `wp term create category "Second Category" --porcelain`

Then save STDOUT as {SECOND_TERM_ID}

When I run `wp post create --post_title="Test category" --post_category="First Category" --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `wp post term list {POST_ID} category --field=term_id`

Then STDOUT should be:

"""

When I run `wp post update {POST_ID} --post_category={SECOND_TERM_ID}`

Then STDOUT should be:

"""

When I run `wp post term list {POST_ID} category --field=term_id`

Then STDOUT should be:

"""

When I run `wp post update {POST_ID} --post_category='Uncategorized,{TERM_ID},Second Category'`

Then STDOUT should be:

"""

When I run `wp post term list {POST_ID} category --field=term_id`

And save STDOUT as {MULTI_CATEGORIES_STDOUT}

Then STDOUT should contain:

"""

And STDOUT should contain:

"""

And STDOUT should contain:

"""

When I run `wp post update {POST_ID} --post_category='Uncategorized, ,{TERM_ID},Second Category,'`

Then STDOUT should be:

"""

When I run `wp post term list {POST_ID} category --field=term_id`

Then STDOUT should be:

"""

When I try `wp post update {POST_ID} --post_category=0`

Then STDOUT should be:

"""

When I run `wp post term list {POST_ID} category --field=term_id`

Then STDOUT should be:

"""

When I try `wp post update {POST_ID} --post_category=,`

Then STDOUT should be:

"""

When I run `wp post term list {POST_ID} category --field=term_id`

Then STDOUT should be:

"""

When I try `wp post update {POST_ID} --post_category=' '`

Then STDOUT should be:

"""

When I run `wp post term list {POST_ID} category --field=term_id`

Then STDOUT should be empty

When I try `wp post update {POST_ID} --post_category=test`

Then STDERR should be:

"""

When I try `wp post create --post_title="Non-existent Category" --post_category={SECOND_TERM_ID},Test --porcelain`

Then STDERR should be:

"""

When I try `wp post create --post_title="More than one non-existent Category" --post_category={SECOND_TERM_ID},Test,Bad --porcelain`

Then STDERR should be:

"""

Scenario: Creating/getting/editing posts

Given a content.html file:

"""

And a create-post.sh file:

"""

When I run `bash create-post.sh`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `wp post get --field=excerpt {POST_ID}`

Then STDOUT should be:

"""

When I run `wp post get --field=content {POST_ID} | diff -Bu content.html -`

Then STDOUT should be empty

When I run `wp post get --format=table {POST_ID}`

Then STDOUT should be a table containing rows:

When I run `wp post get {POST_ID} --format=csv --fields=post_title,type | wc -l | tr -d ' '`

Then STDOUT should be:

"""

When I run `wp post get --format=json {POST_ID}`

Then STDOUT should be JSON containing:

"""

When I try `EDITOR="ex -i NONE -c q!" wp post edit {POST_ID}`

Then STDERR should contain:

"""

And the return code should be 0

When I run `EDITOR="ex -i NONE -c %s/content/bunkum -c wq" wp post edit {POST_ID}`

Then STDERR should be empty

And STDOUT should contain:

"""

When I run `wp post get --field=content {POST_ID}`

Then STDOUT should contain:

"""

When I run `wp post list --post__in=1,{POST_ID} --post_type=any --orderby=post__in --field=url`

Then STDOUT should be:

"""

When I run `wp post get 1 --field=url`

Then STDOUT should be:

"""

Scenario: Update a post from file or STDIN

Given a content.html file:

"""

And a content-2.html file:

"""

When I run `wp post create --post_title="Testing update via STDIN" --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `cat content.html | wp post update {POST_ID} -`

Then STDOUT should contain:

"""

When I run `wp post get --field=post_content {POST_ID}`

Then STDOUT should be:

"""

When I run `wp post create --post_title="Testing update via STDIN. Again!" --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID_TWO}

When I run `wp post update {POST_ID} {POST_ID_TWO} content-2.html`

Then STDOUT should contain:

"""

When I run `wp post get --field=post_content {POST_ID_TWO}`

Then STDOUT should be:

"""

When I try `wp post update {POST_ID} invalid-file.html`

Then STDERR should be:

"""

And the return code should be 1

Scenario: Creating/listing posts

When I run `wp post create --post_title='Publish post' --post_content='Publish post content' --post_status='publish' --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `wp post create --post_title='Draft post' --post_content='Draft post content' --post_status='draft' --porcelain`

Then STDOUT should be a number

When I run `wp post list --post_type='post' --fields=post_title,post_name,post_status --format=csv`

Then STDOUT should be CSV containing:

When I run `wp post list --post_type='post' --fields=title,name,status --format=csv`

Then STDOUT should be CSV containing:

When I run `wp post list --post_type='post' --fields="title, name, status" --format=csv`

Then STDOUT should be CSV containing:

When I run `wp post list --post__in={POST_ID} --format=count`

Then STDOUT should be:

"""

When I run `wp post list --post_type='page' --field=title`

Then STDOUT should contain:

"""

When I run `wp post list --post_type=any --fields=post_title,post_name,post_status --format=csv --orderby=post_title --order=ASC`

Then STDOUT should be CSV containing:

Scenario: List posts with date query

When I run `wp post create --post_title='old post' --post_date='2023-01-24T09:52:00.000Z'`

And I run `wp post create --post_title='new post' --post_date='2025-01-24T09:52:00.000Z'`

And I run `wp post list --field=post_title --date_query='{"before":{"year":"2024"}}'`

Then STDOUT should contain:

"""

And STDOUT should not contain:

"""

Scenario: List posts with tax query

When I run `wp term create category "First Category" --porcelain`

And I run `wp term create category "Second Category" --porcelain`

And I run `wp post create --post_title='post-1' --post_category="First Category"`

And I run `wp post create --post_title='post-2' --post_category="Second Category"`

And I run `wp post create --post_title='new post' --post_date='2025-01-24T09:52:00.000Z'`

And I run `wp post list --field=post_title --tax_query='[{"taxonomy":"category","field":"slug","terms":"first-category"}]'`

Then STDOUT should contain:

"""

And STDOUT should not contain:

"""

Scenario: Creating/updating posts with taxonomies

When I run `wp term create category "First Category" --porcelain`

And save STDOUT as {CAT_1}

And I run `wp term create category "Second Category" --porcelain`

And save STDOUT as {CAT_2}

And I run `wp term create post_tag "Term One" --porcelain`

And I run `wp term create post_tag "Term Two" --porcelain`

And I run `wp post create --post_title='Test Post' --post_content='Test post content' --tax_input='{"category":[{CAT_1},{CAT_2}],"post_tag":["term-one", "term-two"]}' --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `wp post term list {POST_ID} category post_tag --format=table --fields=name,taxonomy`

Then STDOUT should be a table containing rows:

When I run `wp post update {POST_ID} --tax_input='{"category":[{CAT_1}],"post_tag":["term-one"]}'`

Then STDOUT should contain:

"""

When I run `wp post term list {POST_ID} category post_tag --format=table --fields=name,taxonomy`

Then STDOUT should be a table containing rows:

Scenario: Update categories on a post

When I run `wp term create category "Test Category" --porcelain`

Then save STDOUT as {TERM_ID}

When I run `wp post update 1 --post_category={TERM_ID}`

And I run `wp post term list 1 category --format=json --fields=name`

Then STDOUT should be:

"""

Scenario: Make sure WordPress receives the slashed data it expects

When I run `wp post create --post_title='My\Post' --porcelain`

Then save STDOUT as {POST_ID}

When I run `wp post get {POST_ID} --field=title`

Then STDOUT should be:

"""

When I run `wp post update {POST_ID} --post_content="var isEmailValid = /^\S+@\S+.\S+$/.test(email);"`

Then STDOUT should not be empty

When I run `wp post get {POST_ID} --field=content`

Then STDOUT should be:

"""

@require-wp-4.4

Scenario: Creating/updating posts with meta keys

When I run `wp post create --post_title='Test Post' --post_content='Test post content' --meta_input='{"key1":"value1","key2":"value2"}' --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `wp post meta list {POST_ID} --format=table`

Then STDOUT should be a table containing rows:

When I run `wp post update {POST_ID} --meta_input='{"key2":"value2b","key3":"value3"}'`

And I run `wp post meta list {POST_ID} --format=table`

Then STDOUT should be a table containing rows:

When I run `wp post list --field=post_title --meta_query='[{"key":"key2","value":"value2b"}]'`

Then STDOUT should contain:

"""

Scenario: Publishing a post and setting a date fails if the edit_date flag is not passed.

Given a WP install

When I run `wp post create --post_title='test' --porcelain`

Then save STDOUT as {POST_ID}

When I run `wp post update {POST_ID} --post_date='2005-01-24T09:52:00.000Z' --post_status='publish'`

Then STDOUT should contain:

"""

When I run `wp post get {POST_ID} --field=post_date`

Then STDOUT should not contain:

"""

Scenario: Publishing a post and setting a date succeeds if the edit_date flag is passed.

Given a WP install

When I run `wp post create --post_title='test' --porcelain`

Then save STDOUT as {POST_ID}

When I run `wp post update {POST_ID} --post_date='2005-01-24T09:52:00.000Z' --post_status='publish' --edit_date=1`

Then STDOUT should contain:

"""

When I run `wp post get {POST_ID} --field=post_date`

Then STDOUT should contain:

"""

@require-wp-5.0

Scenario: Get block_version field for post with blocks

Given a block-post.html file:

"""

When I run `wp post create block-post.html --post_title='Block Post' --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `wp post get {POST_ID} --field=block_version`

Then STDOUT should be:

"""

@require-wp-5.0

Scenario: Get block_version field for post without blocks

Given a classic-post.html file:

"""

When I run `wp post create classic-post.html --post_title='Classic Post' --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `wp post get {POST_ID} --field=block_version`

Then STDOUT should be:

"""

@require-wp-5.0

Scenario: Get block_version field included in default output

Given a heading-post.html file:

"""

When I run `wp post create heading-post.html --post_title='Test Post' --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `wp post get {POST_ID} --format=json`

Then STDOUT should be JSON containing:

"""

Scenario: Filtering by the wp_posts column names

When I run `wp post create --post_title='Alpha' --post_status=publish --porcelain`

Then STDOUT should be a number

When I run `wp post list --title='Hello world!' --format=count`

Then STDOUT should be:

"""

When I run `wp post list --post_title='Hello world!' --format=count`

Then STDOUT should be:

"""

When I run `wp post list --name=alpha --format=count`

Then STDOUT should be:

"""

When I run `wp post list --post_name=alpha --format=count`

Then STDOUT should be:

"""

When I run `wp post list --author=1 --format=count`

Then STDOUT should be:

"""

When I run `wp post list --post_author=1 --format=count`

Then STDOUT should be:

"""

When I run `wp post list --p=1 --format=count`

Then STDOUT should be:

"""

When I run `wp post list --ID=1 --format=count`

Then STDOUT should be:

"""

Scenario: Filtering drafts by slug needs a user

When I run `wp post create --post_title='Beta' --post_name=beta --post_status=draft --porcelain`

Then STDOUT should be a number

When I run `wp post list --name=beta --field=ID`

Then STDOUT should be empty

When I run `wp post list --name=beta --user=1 --field=ID`

Then STDOUT should not be empty

Scenario: Trashed posts need their status named

When I run `wp post create --post_title='Doomed' --post_status=publish --porcelain`

Then STDOUT should be a number

And save STDOUT as {DOOMED_ID}

When I run `wp post delete {DOOMED_ID}`

Then STDOUT should contain:

"""

When I run `wp post list --field=ID`

Then STDOUT should not contain:

"""

When I run `wp post list --post_status=trash --field=ID`

Then STDOUT should contain:

"""

Scenario: Filtering by category and tag

When I run `wp term create category 'Alpha Cat' --porcelain`

Then save STDOUT as {CAT_ID}

When I run `wp term create post_tag 'Alpha Tag' --slug=alpha-tag --porcelain`

Then save STDOUT as {TAG_ID}

When I run `wp post create --post_title='Tagged' --post_status=publish --post_category={CAT_ID} --tags_input=alpha-tag --porcelain`

Then STDOUT should be a number

When I run `wp post list --cat={CAT_ID} --format=count`

Then STDOUT should be:

"""

When I run `wp post list --cat=-{CAT_ID} --field=post_title`

Then STDOUT should not contain:

"""

When I run `wp post list --tag=alpha-tag --format=count`

Then STDOUT should be:

"""

When I run `wp post list --category_name=alpha-cat --format=count`

Then STDOUT should be:

"""

Scenario: Filtering by meta, time of day and order

When I run `wp post create --post_title='Timed' --post_status=publish --post_date='2020-03-04 05:06:07' --porcelain`

Then STDOUT should be a number

And save STDOUT as {TIMED_ID}

When I run `wp post meta add {TIMED_ID} color blue`

Then STDOUT should not be empty

When I run `wp post create --post_title='Locked' --post_status=publish --post_password=secret --porcelain`

Then STDOUT should be a number

When I run `wp post list --hour=5 --minute=6 --field=post_title`

Then STDOUT should be:

"""

When I run `wp post list --second=7 --field=post_title`

Then STDOUT should be:

"""

When I run `wp post list --meta_key=color --field=post_title`

Then STDOUT should be:

"""

When I run `wp post list --meta_key=color --meta_value=red --format=count`

Then STDOUT should be:

"""

When I run `wp post list --orderby=title --order=ASC --field=post_title`

Then STDOUT should be:

"""

When I run `wp post list --orderby=title --order=DESC --field=post_title`

Then STDOUT should be:

"""

Scenario: Filtering by lists and JSON queries

When I run `wp post create --post_title='Zebra Title' --post_content='nothing' --post_status=publish --porcelain`

Then save STDOUT as {TITLED}

When I run `wp post create --post_title='Plain' --post_name=plain --post_content='zebra in body' --post_status=publish --porcelain`

Then save STDOUT as {BODIED}

When I run `wp post meta add {TITLED} rank 5`

Then STDOUT should not be empty

When I run `wp post list --post__in={TITLED},{BODIED} --format=count`

Then STDOUT should be:

"""

When I run `wp post list --post__not_in={TITLED},{BODIED} --format=count`

Then STDOUT should be:

"""

When I run `wp post list --post_name__in=plain --field=post_title`

Then STDOUT should be:

"""

When I run `wp post list --s=zebra --format=count`

Then STDOUT should be:

"""

When I run `wp post list --meta_query='[{"key":"rank","value":"5"}]' --field=post_title`

Then STDOUT should be:

"""

When I run `wp post list --meta_key=rank --meta_value=4 --meta_compare=">" --field=post_title`

Then STDOUT should be:

"""

When I run `wp post list --posts_per_page=10 --offset=1 --format=count`

Then STDOUT should be:

"""

When I run `wp post list --posts_per_page=1 --nopaging=1 --format=count`

Then STDOUT should be:

"""

@require-wp-6.2

Scenario: Narrowing a search to particular columns

When I run `wp post create --post_title='Zebra Title' --post_content='nothing' --post_status=publish --porcelain`

Then STDOUT should be a number

When I run `wp post create --post_title='Plain' --post_content='zebra in body' --post_status=publish --porcelain`

Then STDOUT should be a number

When I run `wp post list --s=zebra --format=count`

Then STDOUT should be:

"""

When I run `wp post list --s=zebra --search_columns=post_title --field=post_title`

Then STDOUT should be:

"""

When I run `wp post list --s=zebra --search_columns=post_content --field=post_title`

Then STDOUT should be:

"""

When I run `wp post list --s=zebra --search_columns=post_title,post_content --format=count`

Then STDOUT should be:

"""

Scenario: Set a post's modification date on update

Given a WP install

When I run `wp option update timezone_string 'America/New_York'`

Then STDOUT should not be empty

When I run `wp post create --post_title='A post' --post_status=publish --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `wp post update {POST_ID} --post_modified='2020-01-01 12:00:00'`

Then STDOUT should be:

"""

When I run `wp post get {POST_ID} --field=post_modified`

Then STDOUT should be:

"""

When I run `wp post get {POST_ID} --field=post_modified_gmt`

Then STDOUT should be:

"""

Scenario: Set a post's modification date on create

Given a WP install

When I run `wp option update timezone_string 'America/New_York'`

Then STDOUT should not be empty

When I run `wp post create --post_title='Another post' --post_date='2019-05-05 10:00:00' --post_modified='2020-01-01 12:00:00' --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `wp post get {POST_ID} --field=post_modified`

Then STDOUT should be:

"""

When I run `wp post get {POST_ID} --field=post_modified_gmt`

Then STDOUT should be:

"""

Scenario: A post's modification date defaults to the current time

Given a WP install

When I run `wp post create --post_title='Undated post' --post_status=publish --post_modified='2019-02-03 04:05:06' --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `wp post get {POST_ID} --field=post_modified`

Then STDOUT should be:

"""

When I run `wp post update {POST_ID} --post_title='Retitled'`

Then STDOUT should be:

"""

When I run `wp post get {POST_ID} --field=post_modified`

Then STDOUT should not contain:

"""

And STDOUT should not be empty

Scenario: Setting only the GMT modification date derives the local one

Given a WP install

When I run `wp option update timezone_string 'America/New_York'`

Then STDOUT should not be empty

When I run `wp post create --post_title='GMT only' --post_status=publish --post_modified_gmt='2020-01-01 12:00:00' --porcelain`

Then STDOUT should be a number

And save STDOUT as {POST_ID}

When I run `wp post get {POST_ID} --field=post_modified_gmt`

Then STDOUT should be:

"""

When I run `wp post get {POST_ID} --field=post_modified`

Then STDOUT should be:

"""

When I run `wp post update {POST_ID} --post_modified_gmt='2020-06-01 12:00:00'`

Then STDOUT should be:

"""

When I run `wp post get {POST_ID} --field=post_modified_gmt`

Then STDOUT should be:

"""

When I run `wp post get {POST_ID} --field=post_modified`