Listing plugins

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.

Advanced options

  • 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

Read next:

Leave a Reply