<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>Installing third party plugins</title> <meta name="viewport" content="width=device-width, initial-scale=1" /> <link rel="stylesheet" href="../style.css" type="text/css" /> <link rel="stylesheet" href="../local.css" type="text/css" /> </head> <body> <div class="page"> <div class="pageheader"> <div class="header"> <span> <span class="parentlinks"> <a href="../index.html">ikiwiki</a>/ <a href="../plugins.html">plugins</a>/ </span> <span class="title"> Installing third party plugins </span> </span> </div> </div> <div id="pagebody"> <div id="content" role="main"> <p>Most ikiwiki 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 <code>perl -V</code> 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 <code>/usr/local/lib/site_perl</code> for modules, you can locally install ikiwiki plugins to <code>/usr/local/lib/site_perl/IkiWiki/Plugin</code></p> <p>You can use the <code>libdirs</code> and/or <code>libdir</code> configuration options to add directories to the search path. For example, if you set <code>libdir</code> to <code>/home/you/.ikiwiki/</code>, then ikiwiki will look for plugins in <code>/home/you/.ikiwiki/IkiWiki/Plugin</code>.</p> <p>Ikiwiki also supports plugins that are external programs. These are typically written in some other language than perl. Ikiwiki searches for these in <code>/usr/lib/ikiwiki/plugins</code> by default. If <code>libdirs</code> or <code>libdir</code> are set, it will also look under those directories, for example in <code>/home/you/.ikiwiki/plugins</code>. Note that this type of plugin has to be executable for ikiwiki to use it.</p> </div> </div> <div id="footer" class="pagefooter" role="contentinfo"> <div id="pageinfo"> <div id="backlinks"> Links: <a href="./contrib.html">contrib</a> <a href="./contrib/opengraph.html">contrib/opengraph</a> <a href="../plugins.html">plugins</a> <a href="./write/tutorial.html">write/tutorial</a> </div> <div class="pagedate"> Last edited <span class="date">Tue Feb 26 23:01:54 2019</span> <!-- Created <span class="date">Tue Feb 26 23:01:54 2019</span> --> </div> </div> <!-- from ikiwiki --> </div> </div> </body> </html>