Plugin Alias is a new feature for Tiki3 to make new plugins based on previously existing plugins in your tiki site.
Were you looking for Wiki page alias links instead?
- Permits the creation of new plugins directly from the admin panel, without FTP access
- These new plugins use an existing plugin as a base
- These new plugins can have any name
- Have some internal documentation (which appears in Plugin Help)
- Can be distributed via profiles
- Permits to create very specialized plugins without duplicating code
- It permits to specify from a single location, arguments that are passed to these plugins.
- for confidentiality
- for simplicity
- central management/reduce potential errors
- So if a plugin is used in hundreds of wiki pages, and you want to change a setting, you change it in one place.
The Plugin Alias Manager can be found at the "Editing and Plugins" admin panel under the "Plugin Aliases" tab (tiki-admin.php?page=textarea&cookietab=3).
Plugin name can't contain special characters like a hyphen (-).
Plugin aliases permit you to go from this:
Here is how to configure the alias:
Problem : The syntax of a plugin alias is different from a standard plugin.
For instance, here is the syntax for a PluginBox, with a width of 100% and "hello" in the body :
You can create a plugin alias based on a box with a predefined width of 100% and a pre-defined content that will in the wiki look like :
There is no way here to let an user change the body
To do that, here is a configuration example. In this example the body will be pre-filled with the word "hello" and an user will be able to complete it with anything :
- plugin name : "my_plugin"
- base plugin : "box"
- simple plugin arguments
- width, default : "100%"
- my_var, default : (empty)
- plugin parameter documentation
- my_var, name : "my_var"
- plugin body
- default content : "hello %my_var%"
- parameters : "my_var", default : "world"
Now, the following code :
will look like
And the following code :
will look like
When using plugin alias to show just some items from PluginTrackerList, the parameter to filter results at the "Plugin Parameter documentation" need to be also added as arguments of your plugin alias, at the section "Simple plugin arguments" with no value (in this example: "filtervalue").
If you need to delete one argument or one parameter after you already created it, remove its name and value and save changes using "Change Preferences" button in order to have it deleted.
To see real life examples of how it is used, you can install one of profiles where it is being used:
The plugin makes a COL plugin to create bootstrap grid columns
- Plugin Alias Handler for Profiles
- For an alternate explanation, you can read http://dev.tiki.org/item2156