WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Plugins Screen

Contents

Plugins → Plugins

The Plugins Screen enables you to manage your Plugins. Management of Plugins entails activating, deactivating, updating, editing, and deleting Plugins that are installed. Visit the Plugins Add New Screen to install new plugins.

Plugins Screen


Back to Administration Screens.

Manage Plugins

Once a plugin is installed, you may activate it, deactivate it, edit the Plugin file, delete the Plugin, or Upgrade the Plugin. As a special note regarding the Plugin Upgrade process--when Plugins need to be updated, the left navigation menu Plugin option will display a Red balloon, with a number inside the balloon. That number represents the number of Plugins that need to be Updated.

On visiting the Plugins Screen, there may be a splash warning message, similar to, The plugin "some plugin name" has been deactivated due to an error: xxxxxxxxxxxx. If such a message is displayed, investigation is required to find out why a particular Plugin was deactivaed. Possible causes for the deactivation are, (1) an incomplete set of plugin files, (2) the plugin is coded incorrectly, or (3) the Plugin is dependent on another Plugin, and that Plugin is missing, deactivated, or has problems.

Using Selection, Actions, and Apply

Selection

The various Tables in this Screen allow Actions to be performed on one or more Plugins. For Actions to be performed on multiple Plugins at once, those Plugins must be first selected via one of these methods:
  • Select one Plugin at a time - To select a Plugin, the checkbox to the left of the Plugin entry must be checked (clicked). It is possible to keep selecting more Plugins by checking their respective checkbox.
  • Select all Plugins in given Table - All Plugins in a given table can be selected by checking the checkbox in the Table's title, or footer bar. Of course, unchecking the header or footer title bar checkbox will cause all entries in that Table to be unchecked (NOT selected).
  • Reverse Selection - A Reverse Selection means checked items become unchecked, and unchecked items become checked. A Reverse Selection is accomplished by holding the Shift key on the keyboard and clicking the header or footer title bar checkbox.

Actions

Actions describe the process to be performed on particular Plugins. There are two styles of Actions that will be referred to as Bulk Actions and Immediate Actions. The follow describes these Actions:
  • Bulk Actions - These Actions can be performed on one, or more Plugins, at one time, if those Plugins have been previously selected. Bulk Actions are available, when appropriate, as choices in the Actions pulldown box, above each Table. The Bulk Actions are Activate, Deactivate, and Delete.
  • Immediate Actions - Immediate Actions are performed immediately, on an individual Plugin, by clicking the Activate, Deactivate, or Edit links, displayed under the Action column in that Plugin row. The Upgrade Action is also an Immediate Action, but the Upgrade link is seen in the upgrade message below the Plugin row, and the Upgrade nag message only appears if there is an upgrade available at the WordPress Extend Plugins site.
The list of Actions available are described below:
  • Activate - This Action enables a Plugin, or better yet, turns the Plugin on. Activating a Plugin is necessary to use the features of a Plugin. Note that some Plugins make Widgets available for use in the Appearance Widgets Screen. Only Inactive Plugins can be activated. Activate can be either a Bulk Action, or an Immediate Action.
Note: Successful activation will display a splash message at the top of the Screen (e.g. Plugin activated. or Selected plugins activated.) Failure to activate a Plugin results in the message Plugin could not be activated because it triggered a fatal error - this should be further investigated. Likely causes of failure are (1) an incomplete set of plugin files, (2) the plugin is coded incorrectly, (3) or the Plugin is dependent on another Plugin before it can be successfully activated.
  • Deactivate - This Action disables, or turns off, a Plugin. Only Active Plugins can be deactivated. Deactivate is either a Bulk Action, or an Immediate Action.
Note: Successful deactivation will display a splash message at the top of the Screen (e.g. Plugin deactivated. or Selected plugins deactivated.)
  • Delete - This Action deletes the Plugins files. Only Inactive Plugins can be deleted. See the Deleting Plugins section for details of the deletion process. Delete is available only as a Bulk Action.
  • Upgrade - This Immediate Action initiates the Plugin upgrade process. See the Upgrading Plugins section for details on upgrading Plugins.
  • Edit - This Immediate Action places the Plugin code in the Plugins Editor text box for editing. Warning: Making changes to active plugins is not recommended. If your changes cause a fatal error, the plugin will be automatically deactivated. See Plugins Editor for details on editing a Plugin.

Apply

After one or more Plugins are selected, and after a Bulk Action is specified, the Apply button performs the given Action on the selected Plugins.
  • Apply - Click the Apply button to execute the Bulk Action, specified in the Actions pulldown, on the selected Plugins. Remember, prior to executing Actions, one or more Plugins must be selected, as described before.
Successful application of the Action is noted in a splash message at the top of the Screen. For instance, when the Activate Action is applied, the message Selected plugins activated." is displayed.

Deleting Plugins

When the Delete Action is Applied to selected Plugin(s), a Screen similar to the follow is displayed:
Deleting the selected plugins will remove the following plugin(s) and their files:
* Plugin xyx by John Doe
* Plugin abc by Jane Joe
Are you sure you wish to delete these files?
  • Yes Delete these Files - This is the final chance, because clicking this will delete the Plugin(s), and return to the Plugins Screen with the The selected plugins have been deleted. splash message displayed.
Note: If deletion is unsuccessful The message Plugin could not be deleted due to an error: xxxxxxxxx. This should be further investigated.
  • No, Return me to the plugin list - Click this to be returned to the Plugins Screen
  • Click to view entire list of files which will be deleted - Clicking this causes a listing of all the files that are part of the Plugins being deleted.

Upgrading Plugins

Important note: If a Plugin is hosted at the WordPress Extend Plugins site Upgrade notices will be displayed, when appropriate, for a given Plugin. If the Plugin is hosted elsewhere, such as the Plugin author's site, it is incumbent on you to check for available updates for those Plugins!
When a Plugin has an upgrade available, no matter in what Table (e.g. Currently Active Plugins) the Plugins resides, under each Plugin row, a message similar to this will display:
There is a new version of WordPress Database Backup available. View version 2.2.1 Details or upgrade automatically.
  • View Details - Click to see a description of the Plugin details and then click the Install Now button to begin the upgrade.
  • Upgrade Automatically - Click this to begin the upgrade. A screen with messages similar to this will display:
Downloading update from http://downloads.wordpress.org/plugin/wp-db-backup.2.2.1.zip
Unpacking the update
Deactivating the plugin
Removing the old version of the plugin
Installing the latest version
Plugin upgraded successfully
Attempting reactivation of the plugin
Plugin reactivated successfully.
  • Actions: Return to Plugins page - Click this to return to the Plugins Screen.

Currently Active Plugins

This Table displays the list Plugins that are currently active. Note that each Active Plugin is displayed in a light green background. The Actions allowed in this Table are Deactivate, Edit, and Upgrade.

Recently Active Plugins

The Plugins listed in this table are Plugins that were recently deactivated. When a plugin has been inactive for more than 7 days it will be moved to the Inactive Plugins Table. The Actions allowed in this Table are Activate, Delete, Edit, and Upgrade.
  • Clear List - Click the Clear List button to clear all the Plugins listed in this Table. The Table is not displayed again until another Plugin is deactived.

Inactive Plugins

Plugins listed here are installed, but inactive. The Actions of Activate, Delete, Edit, and Upgrade can be performed on Plugins in this Table.

Get More Plugins

You can find additional plugins for your site by using the new Plugin Browser/Installer functionality, or by browsing the WordPress Plugin Directory directly and installing manually.
To manually install a plugin you generally just need to upload the plugin file into your /htdocs/wordpress/wp-content/plugins directory.
Once a plugin has been installed, you may activate it here.


Back to Administration Screens.

Changelog

  • 3.0 : Renamed menu "Installed" -> "Plugins".

See Also

See also Administration Screens and Network Admin.