-## Plugin installation
+# Plugins
-There is a bunch of plugins shipped with Shaarli, where there is nothing to do to install them.
+## Installation
-If you want to install a third party plugin:
+For plugins shipped with Shaarli, no installation is required.
- * Download it.
- * Put it in the `plugins` directory in Shaarli's installation folder.
- * Make sure you put it correctly:
+If you want to install a third party plugin, download it to the `plugins` directory in Shaarli's installation folder:
-```
+```bash
+# example directory structure
| index.php
| plugins/
|---| custom_plugin/
```
- * Make sure your webserver can read and write the files in your plugin folder.
+Make sure your webserver can read and write the files in your plugin folder.
-## Plugin configuration
-In Shaarli's administration page (`Tools` link), go to `Plugin administration`.
+## Configuration
-Here you can enable and disable all plugins available, and configure them.
+From Shaarli's administration page (`Tools` link), go to `Plugin administration`. Here you can enable and disable all plugins available, and configure them.
![administration screenshot](https://camo.githubusercontent.com/5da68e191969007492ca0fbeb25f3b2357b748cc/687474703a2f2f692e696d6775722e636f6d2f766837544643712e706e67)
-## Plugin order
+
+## Order
In the plugin administration page, you can move enabled plugins to the top or bottom of the list. The first plugins in the list will be processed first.
-This is important in case plugins are depending on each other. Read plugins README details for more information.
+This is important in case plugins depend on each other. Read plugins READMEs for more information.
**Use case**: The (non existent) plugin `shaares_footer` adds a footer to every shaare in Markdown syntax. It needs to be processed *before* (higher in the list) the Markdown plugin. Otherwise its syntax won't be translated in HTML.
-## File mode
-Enabled plugin are stored in your `config.php` parameters file, under the `array`:
+## Configuration file
-```php
-$GLOBALS['config']['ENABLED_PLUGINS']
-```
+Enabled plugins are stored in your [Configuration file](Shaarli-configuration).
-You can edit them manually here.
-Example:
+## Usage
-```php
-$GLOBALS['config']['ENABLED_PLUGINS'] = array(
- 'qrcode',
- 'archiveorg',
- 'wallabag',
- 'markdown',
-);
-```
-
-### Plugin usage
-
-#### Official plugins
+### Official plugins
Usage of each plugin is documented in it's README file:
- * `addlink-toolbar`: Adds the addlink input on the linklist page
- * `archiveorg`: For each link, add an Archive.org icon
+ * `addlink-toolbar`: Adds the addlink input on the Shaares list page
+ * `archiveorg`: For each Shaare, add a link to the archived page on Archive.org
+ * `default_colors`: Override default theme colors.
+ * `isso`: Let visitor comment your shaares on permalinks with Isso.
* [`markdown`](https://github.com/shaarli/Shaarli/blob/master/plugins/markdown/README.md): Render shaare description with Markdown syntax.
+ * `piwik`: A plugin that adds Piwik tracking code to Shaarli pages.
* [`playvideos`](https://github.com/shaarli/Shaarli/blob/master/plugins/playvideos/README.md): Add a button in the toolbar allowing to watch all videos.
- * `qrcode`: For each link, add a QRCode icon.
- * [`wallabag`](https://github.com/shaarli/Shaarli/blob/master/plugins/wallabag/README.md): For each link, add a Wallabag icon to save it in your instance.
-
+ * `pubsubhubbub`: Enable PubSubHubbub feed publishing
+ * `qrcode`: For each Shaare, add a QRCode icon.
+ * [`wallabag`](https://github.com/shaarli/Shaarli/blob/master/plugins/wallabag/README.md): For each Shaare, add a Wallabag icon to save it in your instance.
-#### Third party plugins
+### Third party plugins
-See [Community & related software](https://github.com/shaarli/Shaarli/wiki/Community-%26-Related-software#third-party-plugins)
+See [Community & related software](https://shaarli.readthedocs.io/en/master/Community-and-Related-software/)