69 lines
2.5 KiB
Markdown
69 lines
2.5 KiB
Markdown
#Plugin installation & configuration
|
|
## Plugin installation
|
|
|
|
There is a bunch of plugins shipped with Shaarli, where there is nothing to do to install them.
|
|
|
|
If you want to install a third party plugin:
|
|
|
|
* Download it.
|
|
* Put it in the `plugins` directory in Shaarli's installation folder.
|
|
* Make sure you put it correctly:
|
|
|
|
```
|
|
| index.php
|
|
| plugins/
|
|
|---| custom_plugin/
|
|
| |---| custom_plugin.php
|
|
| |---| ...
|
|
|
|
```
|
|
|
|
* 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`.
|
|
|
|
Here you can enable and disable all plugins available, and configure them.
|
|
|
|
[](.html)
|
|
|
|
## Plugin 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.
|
|
|
|
**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`:
|
|
|
|
```php
|
|
$GLOBALS['config'['ENABLED_PLUGINS']]('ENABLED_PLUGINS'].html)
|
|
```
|
|
|
|
You can edit them manually here.
|
|
Example:
|
|
|
|
```php
|
|
$GLOBALS['config'['ENABLED_PLUGINS'] = array(]('ENABLED_PLUGINS']-=-array(.html)
|
|
'qrcode',
|
|
'archiveorg',
|
|
'wallabag',
|
|
'markdown',
|
|
);
|
|
```
|
|
|
|
### Plugin usage
|
|
|
|
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
|
|
* [`markdown`](https://github.com/shaarli/Shaarli/blob/master/plugins/markdown/README.md): Render shaare description with Markdown syntax.[](.html)
|
|
* [`playvideos`](https://github.com/shaarli/Shaarli/blob/master/plugins/playvideos/README.md): Add a button in the toolbar allowing to watch all videos.[](.html)
|
|
* `qrcode`: For each link, add a QRCode icon.
|
|
* `readityourself`: For each link, add a ReadItYourself icon to save the shaared URL
|
|
* [`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.[](.html)
|