Installing plugins

NOTE
This feature is available since:
WikkaWiki 1.1.6.6


Plugin path screenshotThe release of 1.1.6.6 introduces a preliminary plugin architecture that allows Wikka users to override core functionality with custom actions, headers, formatters, and templates. The advantages of such a setup are numerous:

How to use the plugin folder

To use the new plugin folders for your add-ons, you will have to create the /plugins tree and add the corresponding paths in wikka.config.php file (automatically added in fresh installs since 1.1.6.6). Components will be loaded following the path order specified in the config file (so for instance a custom action called /plugins/actions/contact.php will override the default actions/contact.php). You can use a comma (,) a colon (:) or a semicolon (;) as a path separator in the config file. For example:

'wikka_formatter_path' => 'plugins/formatters,formatters',
'wikka_template_path' => 'plugins/templates,templates',
'handler_path' => 'plugins/handlers,handlers',
'action_path' => 'plugins/actions,actions'


Version 2.0 will herald an even more robust plugin architecture (backwards-compatible with the one in this release) that will include "hooks" that can be called from a user's custom component, eliminating the need to modify code in the Wikka core.

Plugins and mod_rewrite

If your wiki runs on an Apache server and is configured to use clean URLs via ModRewrite, you will need to disable redirection for files in the /plugins tree. Just save the following file in the /plugins folder:

plugins/.htaccess
<IfModule mod_rewrite.c>
        # turn on rewrite engine
        RewriteEngine off
</IfModule>


What's next

WikkaCase has been set up as a repository for Wikka plugins. While the use of WikkaCase is beyond the scope of this document, we will be updating the WikkaCase documentation as progress on the new architecture continues. Currently, SVN and bug tracker access is available for developers who want to start building plugin modules for Wikka. Please visit the WikkaCase development page for details.


CategoryEN
There are 2 comments on this page. [Show comments]
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki