Plugin Manager plugin

The Plugin Manager plugin allows superusers to administrate installed plugins and install new ones.

The Plugin is bundled with DokuWiki and does not need to be installed separately. The Plugin Manager is accessible from the admin screen (Login as superuser, click “Admin” and choose “Manage Plugins”).

This is the default action of the Plugin Manager. Each plugin is shown in its own row. A checkbox in front of the name indicates if the plugin is enabled or not.

Plugins listed with a light red background can not be deleted. Plugins with a light blue background are currently disabled.

To disable a plugin, uncheck the checkbox in front of its name and press the save button. Plugins are disabled by placing a disabled file into the plugin directory.

Disabled plugins will no longer be loaded by DokuWiki, their Stylesheets and JavaScript won't be loaded and their syntax will no longer have any effect.

Pressing the info button will display some basic information about the chosen plugin and its components. The Source and Installed fields are only available when the plugin was installed through the Plugin Manager.

The plugin manager can download, unpack and install plugins for you. To install a new plugin follow these steps:

1. Find the plug in you want in the plugins page
2. Copy the link (URL) to the plugin package (in .tgz or .zip format) from the plugin's detail page
3. Paste the link into the URL box on your Plugin Manager page and hit “Download”

When you install a plugin with the plugin manager it will remember the download URL. To update a plugin you can simply press the “Update” button next to it and the Plugin Manager will redownload the plugin and install it again, overwriting the older version.

Note: This only works when the plugin maintainer always uses the same URL for the plugin or provides some redirection to the latest version through a common URL. If this is not the case just get the new URL and install it like a new plugin. The Plugin Manager then will update your old plugin.

Plugins that were not installed through the plugin manager can not be updated with this method. The “Update” button is disabled for these plugins.

To be able to install and modify your plugins, the webserver needs to be able to write to the lib/plugins directory and all files below. Refer to permissions on details how set file permissions on various systems.

The plugin manager will detect missing file permissions and warn you when a plugin could not be installed. You have to install plugins manually in this case, by downloading and unpacking them in lib/plugins your self.

If you try to install plugins using the automatic download and install tool and get the error message “No plugins found, or there has been an unknown problem during downloading and installing.”, then you should check whether your server has activated the zlib (and/or bzip2) extension for php. To be sure, try the following: Download a plugin, extract it, and rearchive it into a .tar file (without compression). Now try to use the download and install tool on that .tar file. If it works now, it is most likely that you just need to install the php-zlib package.

The source code is available from Git.

Submit bugs and feature wishes in the DokuWiki Bugtracker.