Merge pull request #111 from vigilanteweb/kg/define-known-fields

Define known fields as allowed arguments for `wp post (create|update)`

Author: danielbachhuber

src/Post_Command.php

@@ -38,7 +38,82 @@ public function __construct() {
 	 * Create a new post.
 	 *
 	 * ## OPTIONS
-	 *
+	 * 
+	 * [--post_author=<post_author>]
+	 * : The ID of the user who added the post. Default is the current user ID.
+	 * 
+	 * [--post_date=<post_date>]
+	 * : The date of the post. Default is the current time.
+	 * 
+	 * [--post_date_gmt=<post_date_gmt>]
+	 * : The date of the post in the GMT timezone. Default is the value of $post_date.
+	 *
+	 * [--post_content=<post_content>]
+	 * : The post content. Default empty.
+	 * 
+	 * [--post_content_filtered=<post_content_filtered>]
+	 * : The filtered post content. Default empty.
+	 * 
+	 * [--post_title=<post_title>]
+	 * : The post title. Default empty.
+	 * 
+	 * [--post_excerpt=<post_excerpt>]
+	 * : The post excerpt. Default empty.
+	 * 
+	 * [--post_status=<post_status>]
+	 * : The post status. Default 'draft'.
+	 * 
+	 * [--post_type=<post_type>]
+	 * : The post type. Default 'post'.
+	 * 
+	 * [--comment_status=<comment_status>]
+	 * : Whether the post can accept comments. Accepts 'open' or 'closed'. Default is the value of 'default_comment_status' option.
+	 * 
+	 * [--ping_status=<ping_status>]
+	 * : Whether the post can accept pings. Accepts 'open' or 'closed'. Default is the value of 'default_ping_status' option.
+	 * 
+	 * [--post_password=<post_password>]
+	 * : The password to access the post. Default empty.
+	 * 
+	 * [--post_name=<post_name>]
+	 * : The post name. Default is the sanitized post title when creating a new post.
+	 * 
+	 * [--to_ping=<to_ping>]
+	 * : Space or carriage return-separated list of URLs to ping. Default empty.
+	 * 
+	 * [--pinged=<pinged>]
+	 * : Space or carriage return-separated list of URLs that have been pinged. Default empty.
+	 * 
+	 * [--post_modified=<post_modified>]
+	 * : The date when the post was last modified. Default is the current time.
+	 * 
+	 * [--post_modified_gmt=<post_modified_gmt>]
+	 * : The date when the post was last modified in the GMT timezone. Default is the current time.
+	 * 
+	 * [--post_parent=<post_parent>]
+	 * : Set this for the post it belongs to, if any. Default 0.
+	 * 
+	 * [--menu_order=<menu_order>]
+	 * : The order the post should be displayed in. Default 0.
+	 * 
+	 * [--post_mime_type=<post_mime_type>]
+	 * : The mime type of the post. Default empty.
+	 * 
+	 * [--guid=<guid>]
+	 * : Global Unique ID for referencing the post. Default empty.
+	 * 
+	 * [--post_category=<post_category>]
+	 * : Array of category names, slugs, or IDs. Defaults to value of the 'default_category' option.
+	 * 
+	 * [--tags_input=<tags_input>]
+	 * : Array of tag names, slugs, or IDs. Default empty.
+	 * 
+	 * [--tax_input=<tax_input>]
+	 * : Array of taxonomy terms keyed by their taxonomy name. Default empty.
+	 * 
+	 * [--meta_input=<meta_input>]
+	 * : Array of post meta values keyed by their post meta key. Default empty.
+	 * 
 	 * [<file>]
 	 * : Read post content from <file>. If this value is present, the
 	 *     `--post_content` argument will be ignored.
@@ -58,6 +133,7 @@ public function __construct() {
 	 * [--porcelain]
 	 * : Output just the new post id.
 	 *
+	 *
 	 * ## EXAMPLES
 	 *
 	 *     # Create post and schedule for future
@@ -99,6 +175,81 @@ public function create( $args, $assoc_args ) {
 	 *
 	 * <id>...
 	 * : One or more IDs of posts to update.
+	 * 
+	 * [--post_author=<post_author>]
+	 * : The ID of the user who added the post. Default is the current user ID.
+	 * 
+	 * [--post_date=<post_date>]
+	 * : The date of the post. Default is the current time.
+	 * 
+	 * [--post_date_gmt=<post_date_gmt>]
+	 * : The date of the post in the GMT timezone. Default is the value of $post_date.
+	 *
+	 * [--post_content=<post_content>]
+	 * : The post content. Default empty.
+	 * 
+	 * [--post_content_filtered=<post_content_filtered>]
+	 * : The filtered post content. Default empty.
+	 * 
+	 * [--post_title=<post_title>]
+	 * : The post title. Default empty.
+	 * 
+	 * [--post_excerpt=<post_excerpt>]
+	 * : The post excerpt. Default empty.
+	 * 
+	 * [--post_status=<post_status>]
+	 * : The post status. Default 'draft'.
+	 * 
+	 * [--post_type=<post_type>]
+	 * : The post type. Default 'post'.
+	 * 
+	 * [--comment_status=<comment_status>]
+	 * : Whether the post can accept comments. Accepts 'open' or 'closed'. Default is the value of 'default_comment_status' option.
+	 * 
+	 * [--ping_status=<ping_status>]
+	 * : Whether the post can accept pings. Accepts 'open' or 'closed'. Default is the value of 'default_ping_status' option.
+	 * 
+	 * [--post_password=<post_password>]
+	 * : The password to access the post. Default empty.
+	 * 
+	 * [--post_name=<post_name>]
+	 * : The post name. Default is the sanitized post title when creating a new post.
+	 * 
+	 * [--to_ping=<to_ping>]
+	 * : Space or carriage return-separated list of URLs to ping. Default empty.
+	 * 
+	 * [--pinged=<pinged>]
+	 * : Space or carriage return-separated list of URLs that have been pinged. Default empty.
+	 * 
+	 * [--post_modified=<post_modified>]
+	 * : The date when the post was last modified. Default is the current time.
+	 * 
+	 * [--post_modified_gmt=<post_modified_gmt>]
+	 * : The date when the post was last modified in the GMT timezone. Default is the current time.
+	 * 
+	 * [--post_parent=<post_parent>]
+	 * : Set this for the post it belongs to, if any. Default 0.
+	 * 
+	 * [--menu_order=<menu_order>]
+	 * : The order the post should be displayed in. Default 0.
+	 * 
+	 * [--post_mime_type=<post_mime_type>]
+	 * : The mime type of the post. Default empty.
+	 * 
+	 * [--guid=<guid>]
+	 * : Global Unique ID for referencing the post. Default empty.
+	 * 
+	 * [--post_category=<post_category>]
+	 * : Array of category names, slugs, or IDs. Defaults to value of the 'default_category' option.
+	 * 
+	 * [--tags_input=<tags_input>]
+	 * : Array of tag names, slugs, or IDs. Default empty.
+	 * 
+	 * [--tax_input=<tax_input>]
+	 * : Array of taxonomy terms keyed by their taxonomy name. Default empty.
+	 * 
+	 * [--meta_input=<meta_input>]
+	 * : Array of post meta values keyed by their post meta key. Default empty.
 	 *
 	 * [<file>]
 	 * : Read post content from <file>. If this value is present, the