To list installed plugins, use –list:
wordshell mysite --list
It will give you an output something like this:
mysite akismet (i) 2.5.6 Akismet mysite cart66-lite 1.4.7 Cart66 Lite mysite cimy-user-extra-fields 2.3.6 (2.3.7) Cimy User Extra Fields mysite myplugin (-) 1.0.1 My custom plugin mysite wpsc-support-tickets 0.9.5 wpsc Support Tickets mysite wp-super-faq 0.5.6 WP Super FAQ
The output is a simple four-column view: the site name, the plugin name, the installed version, the plugin description.
Extra information may be present next to the plugin name:
- (i) Means that the plugin is inactive
- (-) Means that the plugin was not known in the WordPress plugins directory; this means either that it was subsequently removed from there, or that it was never there (it is third party). If you have zips of your third party plugins, then you should copy them into ~/.wordshell/customimports.plugin and then WordShell will know more about that plugin.
If there is a second version number shown in brackets (e.g. like for cimy-user-extra-fields in the example above), then it is telling you about a known available update for the version you have. (This may be known because it is in the online WordPress plugins directory, or because you have imported it yourself (either by installing it on another site, or by manually copying it into ~/.wordshell/customimports.plugin).
Listing only one plugin
You can specify a plugin, if you only wish to list that particular plugin:
wordshell mysite akismet --list
Searching for which sites have a particular plugin installed
If you want to only list one particular plugin across all sites (i.e. answer the question, where do I have such-and-such plugin installed?), then simply specify the site as “all”:
wordshell all akismet --list
Listing which plugins have been modified
To learn about how to list plugins which have been modified (i.e. are not exactly the same as when installed), see the manual page for dealing with changes/modifications to plugins.
- List only third party plugins (i.e. ones not found in the WordPress plugins directory) by adding the switch –listonlythirdparty, e.g.:
wordshell mysite --list --listonlythirdparty
- List only plugins for which there are updates available by adding –listonlyupdates:
wordshell mysite --list --listonlyupdates
In fact, since this option is so common, you do not need to supply –list (it is assumed), and can shorted to –listupdates:
wordshell mysite --listupdates
- By default, WordShell pattern matches your plugin name. So, for example, contact-form-7 will match both the plugin with that exact name, and also others containing it, e.g. contact-form-7-database-extension. If you only want an exact match, then add –listexact.
- You can also specify –active or –inactive to only list plugins that are in the corresponding state. e.g. To list all inactive plugins on all your sites:
wordshell all --list --inactive