aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins.mdwn
blob: 7773e71a9ea17bdee09bf1bd780aa50ced38340c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
Plugins can be used to add additional features to ikiwiki. Ikiwiki's
backend RCS support is also pluggable, so support for new revision control
systems can be added to ikiwiki. It's possible to [[write]] your own plugins,
or you can install and use plugins contributed by others. 

The ikiiki package includes some standard plugins that are installed and
by default. These include [[inline]], [[pagecount]], and [[brokenlinks]].
Of these, [[inline]] is enabled by default.

To enable other plugins, use the `--plugin` switch described in [[usage]],
or the equivalent line in [[ikiwiki.setup]].

## Plugin directory

Add your contributed plugins here.

[[inline pages="plugins/* !plugins/write !*/Discussion" archive="yes" rootpage="plugins/contrib" show="30"]]

## Installing third party plugins

Plugins are perl modules and should be installed somewhere in the perl
module search path. See the @INC list at the end of the output of `perl -V`
for a list of the directories in that path. All plugins are in the
IkiWiki::Plugin namespace, so they go in a IkiWiki/Plugin subdirectory
inside the perl search path. For example, if your perl looks in
`/usr/local/lib/site_perl` for modules, you can locally install ikiwiki
plugins to `/usr/local/lib/site_perl/IkiWiki/Plugin`