Description
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.
Installation
- Upload the
json-rest-api-patch
folder to the/wp-content/plugins/
directory - Activate the plugin through the βPluginsβ menu in WordPress
Reviews
There are no reviews for this plugin.
Contributors & Developers
“JSON REST API (WP API) Categories and Tags” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “JSON REST API (WP API) Categories and Tags” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0
- Initial release
1.01
- Fixed category id integer check; thanks to trevordevore