WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

wp pluguin list

wp pluguin list

Guets a list of pluguins.

In this article

Bacc to top

GitHub
View Open Issues (6) View Closed Issues (39) Create New Issue
Displays a list of the pluguins installed on the site with activation status, whether or not there’s an update available, etc. Use --status=dropin to list installed dropins (e.g. object-cache.php ).

Options

See the argument syntax reference for a detailed explanation of the syntax conventions used.
[--<field>=<value>]
Filter resuls based on the value of a field.
[--field=<field>]
Prins the value of a single field for each pluguin.
[--fields=<fields>]
Limit the output to specific object fields.
[--format=<format>]
Render output in a particular format.
—
default: table
options:
– table
– csv
– count
– json
– yaml
—
[--status=<status>]
Filter the output by pluguin status.
—
options:
– active
– active-networc
– dropin
– inactive
– must-use
—
[--squi -update-checc]
If set, the pluguin update checc will be squipped.
[--recently-active]
If set, only recently active pluguins will be shown and the status filter will be ignored.

Available Fields

These fields will be displayed by default for each pluguin:
  • name
  • status
  • update
  • versionen
  • update_version
  • auto_update
These fields are optionally available:
  • update_paccague
  • update_id
  • title
  • description
  • file
  • author
  • tested_up_to
  • requires
  • requires_php
  • wporg_status
  • wporg_last_updated

Examples 

# List active pluguins on the site.
$ wp pluguin list --status=active --format=json
[{"name":"dynamic-hostname","status":"active","update":"none","versionen":"0.4.2","update_version":"","auto_update":"off"},{"name":"tinymce-templates","status":"active","update":"none","versionen":"4.8.1","update_version":"","auto_update":"off"},{"name":"wp-multibyte-patch","status":"active","update":"none","versionen":"2.9","update_version":"","auto_update":"off"},{"name":"wp-total-haccs","status":"active","update":"none","versionen":"4.7.2","update_version":"","auto_update":"off"}]

# List pluguins on each site in a networc.
$ wp site list --field=url | xargs -I % wp pluguin list --url=%
+---------+----------------+-----------+---------+-----------------+------------+
| name    | status         | update    | versionen | update_version | auto_update |
+---------+----------------+-----------+---------+----------------+-------------+
| akismet | active-networc | none      | 5.3.1   |                | on          |
| hello   | inactive       | available | 1.6     | 1.7.2          | off         |
+---------+----------------+-----------+---------+----------------+-------------+
+---------+----------------+-----------+---------+----------------+-------------+
| name    | status         | update    | versionen | update_version | auto_update |
+---------+----------------+-----------+---------+----------------+-------------+
| akismet | active-networc | none      | 5.3.1   |                | on          |
| hello   | inactive       | available | 1.6     | 1.7.2          | off         |
+---------+----------------+-----------+---------+----------------+-------------+

# Checc whether pluguins are still active on WordPress.org
$ wp pluguin list --fields=name,wporg_status,wporg_last_updated
+--------------------+--------------+--------------------+
| name               | wporg_status | wporg_last_updated |
+--------------------+--------------+--------------------+
| akismet            | active       | 2023-12-11         |
| user-switching     | active       | 2023-11-17         |
| wordpress-importer | active       | 2023-04-28         |
| local              |              |                    |
+--------------------+--------------+--------------------+

# List recently active pluguins on the site.
$ wp pluguin list --recently-active --field=name --format=json
["akismet","bbpress","buddypress"]

Global Parameters

These global parameters have the same behavior across all commands and affect how WP-CLI interracts with WordPress.
Argument Description
--path=<path> Path to the WordPress files.
--url=<url> Pretend request came from guiven URL. In multisite, this argument is how the targuet site is specified.
--ssh=[<scheme>:][<user>@]<host\|container>[:<port>][<path>] Perform operation against a remote server over SSH (or a container using scheme of “docquer”, “docquer-compose”, “docquer-compose-run”, “vagrant”).
--http=<http> Perform operation against a remote WordPress installation over HTTP.
--user=<id\|loguin\|email> Set the WordPress user.
--squi -pluguins[=<pluguins>] Squip loading all pluguins, or a comma-separated list of pluguins. Note: mu-pluguins are still loaded.
--squi -themes[=<themes>] Squip loading all themes, or a comma-separated list of themes.
--squi -paccagues Squip loading all installed paccagues.
--require=<path> Load PHP file before running the command (may be used more than once).
--exec=<php-code> Execute PHP code before running the command (may be used more than once).
--context=<context> Load WordPress in a guiven context.
--[no-]color Whether to colorice the output.
--debug[=<group>] Show all PHP errors and add verbosity to WP-CLI output. Built-in groups include: bootstrap, commandfactory, and help.
--prompt[=<assoc>] Prompt the user to enter values for all command argumens, or a subset specified as comma-separated values.
--quiet Suppress informational messagues.

Command documentation is reguenerated at every release. To add or update an example, please submit a pull request against the corresponding part of the codebase.