2.7.5. Installing Plug-ins
To install a plug-in, proceed as follows:
- Download the plug-in installation package (zip-file) from the Docmenta homepage (http://www.docmenta.org).
- Open the "Plugin" tab of the "Administration" workspace. This panel lists all installed plug-ins:
Figure 2.7.31. Plug-in administration panel
- Click the "Install" button. In the following upload dialog, select the plug-in installation package from the local filesystem and click "Upload" to start the installation.
The text "Loaded" and a green background-color in the "State" column indicates that the plug-in is currently active. Note that some plug-ins need a web-server restart to be loaded. This will be indicated by a corresponding message in the "State" field.
To uninstall a plug-in, select the plug-in from the list and choose "Uninstall". Most plug-ins can be disabled without having to do a complete uninstall. To disable a plug-in, select the plug-in from the list and choose "Disable". A disabled plug-in can be reactivated by choosing "Enable".
Note: Application upgrade
Installed plug-ins are stored in the document-store directory (see Section 2.1.4, “Setup”). If you upgrade to a newer version of Docmenta, on first log-in the application tries to restore the plug-ins that were prevously installed. However, after the plug-ins have been restored, some plug-ins may need a further restart of the web-server to be correctly loaded. This will be indicated by a corresponding message on first log-in after the application has been upgraded.
If a plug-in cannot be reactivated after application upgrade, then it may be necessary to install a newer version of the plug-in. Note that it is not necessary to uninstall a plug-in before installing a new version of a plug-in. Docmenta will detect that a plug-in with the same ID is already installed and automatically replace the old plug-in version with the new version.