Creating a Wiki Plugin is a great way to get started contributing to Tiki as plugins can stand alone and minimum PHP programming skills are needed.

Wiki plugins extend the function of wiki syntax with more specialized commands. Usually expressed in {curly brackets} plugins compact a chunk of PHP or HTML code into something that can be understood by non-programmers.

Here are all the current Wiki plugins: https://gitlab.com/tikiwiki/tiki/-/tree/master/lib/wiki-plugins

Example

Let's use and example where we want to create a plugin to allow text formatting in any font and size:

{FONT(size=>20,face=>arial)} some text {FONT}

If a plugin doesn't require parameters, the syntax will be:

{EXAMPLE()} content {EXAMPLE}

When tiki finds a plugin the engine will look at the plugin name and look for the file:

lib/wiki-plugins/wikiplugin_name.php

Don't be too creative with plugin names. For instance, any number in a plugin names seems to make the plugin fail. A plugin name containing only alphabetical character will be valid.

For example:

lib/wiki-plugins/wikiplugin_font.php

That file should be a PHP file defining both functions:

function wikiplugin_font($data,$params) {}

and

function wikiplugin_font_info() {}

Info function

The info function defines the plugin's parameters and is used by the PLUGINMANAGER plugin for documenting an individual plugin, so it is important to populate this function as completely and accurately as possible. In our example there are only two parameters, these will be face and size but they each have a number of 'settings'.
For example:

function wikiplugin_font_info()
{
        return array(
                'name' => tra('Font'),
                'documentation' => 'PluginFont',
                'description' => tra('Create a an HTML (deprecated) font tag.'),
                'tags' => array( 'basic' ),
                'prefs' => array( 'wikiplugin_font' ),
				'introduced' => 9,
                'params' => array(
                        'size' => array(
                                'required' => false,
                                'name' => tra('Font size'),
                                'description' => tra('Choose font size in pixels. Enter numbers only'),
                                'filter' => 'digits',
                                'default' => '12',
                                'since' => '9.0',
                        ),
                        'face' => array(
                                'required' => false,
                                'name' => tra('Font face'),
                                'description' => tra('Choose font face.'),
                                'filter' => 'alpha',
                                'default' => 'normal',
                                'since' => '9.0',
                        ),
                ),
        );
}

Individual plugins may have parameters that need additional 'settings' but the settings above ie 'required', 'name', 'description', 'filter', 'default' (but only if 'required is false) and 'since', are the minimum number that should be set for every parameter.

Body function

The function receives the plugin content in $data and the parameters in the $params associative array. The function manipulates the content and must return a string with the HTML that will replace the plugin content when rendering the wiki page (it can be just text if no HTML markup is needed).

For example:

function wikiplugin_example($data,$params) {

extract($params, EXTR_SKIP);

if(!isset($face)) {
return ("<b>missing face parameter for plugin</b><br/>");
}
if(!isset($size)) {
return ("<b>missing size parameter for plugin</b><br/>");
}
$ret = "<span style='font-face: $face; font-size: $size'>$data</span>";
return $ret;
}

The return of your plugin will be wiki parsed. If you do not want it to be parsed again, you must enclose the value like this

return ' '.$ret.' ';

Special Plugins

These aren't real plugins but, like plugins, use a slightly different curly braces syntax. Unlike plugins, you don't "close" them. e.g., use {maketoc} instead of {maketoc()}{maketoc}. These can also appear in template (.tpl) files.

See also Plugin parameters

Related docs

How to add an item on the toolbar by default (once you add a plugin, you likely want it to be easy for people to use in text areas)

For notes on the future of plugins (and modules) see Gadgets.

Related links

• Wiki Plugins
• Hello World

• Create a Plugin