Add WP-CLI command documentation

[sc0ttkclark]

In relation to #3301, we need documentation brought over from https://github.com/pods-framework/pods-wp-cli

[anandamd]

I can help with documentation. Give me a head start on what needs doing and I'll help.

[sc0ttkclark]

@anandamd Current documentation is over at https://github.com/pods-framework/pods-wp-cli

We just need to document it in our new documentation site. @jimtrue can help you get into that to help probably. Join us in our Slack chat http://pods.io/chat/ in the #dev-docs-io channel.

[jimtrue]

The links in this give a 404, so if documentation was brought over, it's gone now.

[jimtrue]

@sc0ttkclark that link for documentation is dead so not sure where or if it got retained anywhere.

[jimtrue]

From @sc0ttkclark

wp pods and wp pods-api

This is a package that implements the wp pods and wp pods-api commands for WP-CLI.

It provides access to add/save/duplicate/delete in the Pods class and add_pod/save_pod/duplicate_pod/reset_pod/delete_pod in the PodsAPI class in the Pods Framework.

Importing and Exporting methods are still in development.

Requirements

• Composer
• WP-CLI 0.11 or newer
• PHP 5.3 or newer
• WordPress 3.5 or newer

Installation

First, make sure you have the package index configured:

cd ~/.wp-cli/
php composer.phar config repositories.wp-cli composer http://wp-cli.org/package-index/

Then, just install the package:

php composer.phar require pods-framework/pods-wp-cli=dev-master

Usage

Just run it:

wp pods

$ wp pods add --pod=my_pod --field1=Value --field2="Another Value"
Pod item added
ID: 123
$ wp pods save --pod=my_pod --item=123 --field1=Value2 --field2="Another Value2"
Pod item saved
ID: 123
$ wp pods duplicate --pod=my_pod --item=123
Pod item duplicated
New ID: 124
$ wp pods delete --pod=my_pod --item=123
Pod item deleted

See http://pods.io/docs/code/pods/ for more information about the various methods.

wp pods-api

$ wp pods-api add-pod --name=apple --type=post_type --label=Apples --singular_label=Apple
Pod added
ID: 125
$ wp pods-api save-pod --name=apple --label="Apple Types" --singular_label="Apple Type"
Pod saved
ID: 125
$ wp pods-api duplicate --name=apple --new_name=apple2
Pod duplicated
New ID: 126
$ wp pods-api reset --name=apple
Pod content reset
$ wp pods-api delete --name=apple
Pod deleted

Field operations for wp pods-api is still in development.

See http://pods.io/docs/code/pods-api/ for more information about the various methods.