====== Plugin Management Interface ======

=====Introduction=====

The plugin management interface allow to perform all task which are related to plugins management. This interface which is accessible through the **settings** section, is only available for administrators.


=====Plugin Installation=====

To install a plugin, you must in order:

  - Login as admin and go to the plugin management interface
  - Upload the plugin archive
  - Click on the **Update Plugins** button
  - Click on the installation icon

=====Plugin Activation=====

To activate a plugin, you must in order:

  - Login as admin and go to the plugin management interface
  - Click on the activation icon

=====Plugin Protection=====

In some cases, it can be interesting to protect a specific plugin __against deactivation__. For instance, the first administrator, which has full access to the server, can create other administrator accounts which have the same permissions on the panel but not an SSH access.

To protect a plugin, you must in order:

  - Login as admin and go to the plugn management interface
  - Click on the protect icon

**Note:** When clicking on the protect icone, the plugin manager creates or updates a **protected_plugins.php** file into the **gui/data/persistent** directory. This file contains a list of all protected plugins. If a plugin is listed in this file, the **deactivate** icone is no longer available for it in the plugin management interface.

=====Plugin Update=====

To update a plugin, you must in order:

  - Login as admin and go to the plugin management interface
  - Upload the plugin archive
  - Click on the **Update Plugins** button

=====Plugin Configuration Change=====

To change the configuration for a specific plugin, you must in order:

  - Edit the plugin configuration file
  - Login as admin and go to the plugin management interface
  - Click on the **Update Plugins** button

See [[plugins:configuration|Plugin Configuration]] for further details.


=====Plugin Deactivation=====

To deactivate a plugin, you must in order:

  - Unprotect the plugin by removing it from the **gui/data/persistent/protected_plugins.php** (only needed if the plugin is protected)
  - Login as admin and go to the plugin management interface
  - Click on the deactivation icon

=====Plugin Uninstallation=====

To uninstall a plugin, you must in order

  - Login as admin and go to the plugin management interface
  - Click on the uninstallation icon

=====Plugin Deletion=====

To delete a plugin you must in order:

  - Login as admin and go to the plugin mangement interface
  - Deactivate and/or uninstall the plugin
  - Click on the delete icon

 --- //[[l.declercq@nuxwin.com|Nuxwin]] 2014/02/24 05:50//