NPM package to list/download available Phonegap plugins from http://plugins.cordova.io/ and/or http://plugreg.com/
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
scripts
.gitignore
.npmignore
LICENSE
README.md
package.json

README.md

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