cordova-plugins

NPM package to list/download available Phonegap plugins from http://registry.cordova.io/ and/or http://plugreg.com/

Comparison between the two repos:

http://plugreg.com	http://registry.cordova.io
REST API	REST API
~1300 plugins	~450 plugins
Git plugin project URL	.tgz plugin tarball URL
Supports platform filter	No support for platform filter
Supports version number	Supports version number
Supports modified date	Supports modified date

*Modified date is color coded to give an indication on the activity.

Bright Green - activity within the previous month

Bright Yellow - activity between 1 and 2 months ago

Bright Red - activity more than 2 months ago

Installation

sudo npm install -g cordova-plugins

Usage

cordova-plugins [options] command [term]

commands:
    list       - display all available plugins
    search     - search plugins for a specfic term/phrase

options:
    -p         - comma delimited (no spaces) platforms to filter by.
                Valid platforms are: ios, android, blackberry10, wp7, wp8, firefoxos.
                Default is all.
    -r         - the url/name of the repo to use.
                Valid urls are: http://plugreg.com (shortform plugreg) and
                http://registry.cordova.io (shortform cordova).
                Default is http://registry.cordova.io

term           - term to use when using the `search` command.
                Wrap the term in quotes if there are spaces.

Examples

cordova-plugins -p ios,android list

• will list all plugins from http://registry.cordova.io (the -p option has no effect)

cordova-plugins -p ios,android -u http://plugreg.com (or plugreg) list

• will list all plugins from http://plugreg.com that are on the ios and/or android platforms

cordova-plugins search camera

• will list all plugins from http://registry.cordova.io that have the term camera in the name or description. The search term matches will be highlighted and CAPITALIZED to notice easier.

Changed

Commandline argument -u has been changed to -r to reflect the naming convention of repo instead of url.

New

Support for default repo url. Valid urls are: http://plugreg.com (shortform plugreg) and http://registry.cordova.io (shortform cordova). Default is http://registry.cordova.io.

Support to customize output foreground colors. Currently you can change the color of the url and description output. This is done by creating a .cordova-plugins valid JSON file in your HOME directory.

Ex:

{
    "repo": "plugreg",
    "urlColor": "blue",
    "descriptionColor": "whiteBright"
}

Supported colors are (taken from https://github.com/medikoo/cli-color):

black
red
green
yellow
blue
magenta
cyan
white
blackBright
redBright
greenBright
yellowBright
blueBright
magentaBright
cyanBright
whiteBright

Future Considerations

• Hook into cordova-cli add plugin command.
• Optimize and clean up code