Allows tags and categories to be set when creating/editing posts with the JSON REST API (WP API)
| Author: | Ray Rodriguez (profile at wordpress.org) |
| WordPress version required: | 3.9 |
| WordPress version tested: | 4.0 |
| Plugin version: | 1.01 |
| Added to WordPress repository: | 17-09-2014 |
| Last updated: | 20-09-2014
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
|
| Rating, %: | 100 |
| Rated by: | 2 |
| Plugin URI: | |
| Total downloads: | 6 336 |
| Active installs: | 50+ |
 Click to start download |
|
The JSON REST API (WP API) as of version 1.1.1 does not allow you to specify tags or categories when createing or editing posts (it appears this will be added in a later release). This plugin addresses that problem by allowing categories and tags to be passed in the JSON data when creating/editing posts.
An example JSON post that can be made using the JSON REST API (WP API) (described in detail here) to create a post in WordPress would be:
{"title":"Hello World!","content_raw":"Content","excerpt_raw":"Excerpt"}In order to add tags/categories you would add an array called "x-categories" and/or and array called "x-tags" to the JSON data, for example:
{"title":"Hello World!","content_raw":"Content","excerpt_raw":"Excerpt","x-tags":["tag1","tag2"],"x-categories":["General","15"]}The example creates a post and assignes the tags "tag1" and "tag2" as well as placing the post in the category named "General" and category ID 15. The tags do not have to exist prior to use. Categories must exist prior to use and may be expressed and either category names or category IDs. The "x-" prefixes were used to avoid any conflicts in functionality with the JSON REST API (WP API) plugin.
Because this plugin relies on the JSON parsing functionallity provided by the JSON REST API (WP API) plugin the alternate syntax using a multi-part-form body should also work.
By default the tags/categories specified when editing a post will replace any tags/categories already assigned to the post. This behavior can be changed so that tags/categories are appened instead, simply open the json-rest-api-wp-api-categories-and-tags folder in the WordPress plugins folder and edit json-rest-api-patch.php. On
line 12 of the file is a variable that should be set to true in order to have tags/categories appended instead of replaced.
ChangeLog