From 5409ade28c5f0acf99dbadd4d95e6f8efda5d395 Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Thu, 14 Apr 2016 14:20:23 +0200 Subject: Update docs from Wiki --- doc/Plugin-installation-&-configuration.html | 154 +++++++++++++++++++++++++++ 1 file changed, 154 insertions(+) create mode 100644 doc/Plugin-installation-&-configuration.html (limited to 'doc/Plugin-installation-&-configuration.html') diff --git a/doc/Plugin-installation-&-configuration.html b/doc/Plugin-installation-&-configuration.html new file mode 100644 index 00000000..3d2f9704 --- /dev/null +++ b/doc/Plugin-installation-&-configuration.html @@ -0,0 +1,154 @@ + + + + + + + Shaarli – Plugin installation & configuration + + + + + + + +

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.

administration screenshot

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:

$GLOBALS['config'['ENABLED_PLUGINS']]('ENABLED_PLUGINS'].html)

You can edit them manually here.
+Example:

$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: Render shaare description with Markdown syntax.
playvideos: Add a button in the toolbar allowing to watch all videos.
qrcode: For each link, add a QRCode icon.
readityourself: For each link, add a ReadItYourself icon to save the shaared URL
wallabag: For each link, add a Wallabag icon to save it in your instance.

+ + -- cgit v1.2.3