TWiki:Plugins
expands to TWiki:Plugins on TWiki.org. You can add your own shortcuts and URLs to the existing directory of Wiki-related and other probably useful sites.
SomePlugin
), there's a separate development page.
Dev
(SomePluginDev
).
twiki/bin
and twiki/lib
directories for the Test version, adjusting the paths in the new lib/TWiki.cfg
, the twiki/data
; the twiki/templates
and twiki/pub
directories are shared.
Test
in the DISABLEDPLUGINS variable in TWikiPreferences. Redefine the DISABLEDPLUGINS variable in the Test web and do the testing there.
lib/TWiki/Plugins
directory are activated automatically unless disabled by the DISABLEDPLUGINS
Preferences variable in TWikiPreferences. You can optionally list the installed Plugins in the INSTALLEDPLUGINS
Preferences variable. This is useful to define the sequence of Plugin execution, or to specify other webs than the TWiki.Tukro web for the Plugin topics. Settings in TWikiPreferences are:
Set INSTALLEDPLUGINS = DefaultPlugin, ...
Set DISABLEDPLUGINS = EmptyPlugin, ...
web.topicname
name, if specified in INSTALLEDPLUGINS
; next, the TWiki web is searched; and finally, the current web.
Plugin-specific settings are done in individual Plugin topics. Two settings are standard for each Plugin:
Set SHORTDESCRIPTION = Blah blah woof woof.
data/debug.txt
. Set to 0=off or 1=on:
Set DEBUG = 0
%<pluginname>_<var>%
, ex: %DEFAULTPLUGIN_SHORTDESCRIPTION%
shows the description of the DefaultPlugin.
%ACTIVATEDPLUGINS%
variable lists activated Plugins by name. (This variable is displayed in TWikiPreferences for debugging use.)
%PLUGINDESCRIPTIONS%
variable displays a bullet list with a one-line description of each active Plugins. This variable is based on the %<plugin>_SHORTDESCRIPTION%
Preferences variables of individual topics and is shown in TextFormattingRules.
DEMO: Active Plugin Variables%ACTIVATEDPLUGINS%
On this TWiki site, the active Plugins are: DefaultPlugin, SpreadSheetPlugin, EditTablePlugin, InterwikiPlugin, RenderListPlugin, SlideShowPlugin, SmiliesPlugin, TablePlugin.%
PLUGINDESCRIPTIONS%
You can use any of these active TWiki Plugins:
- DefaultPlugin: This plugin can be used to specify some simple custom rendering rules. It also renders depreciated
*_text_*
as bold italic text.- SpreadSheetPlugin: Add spreadsheet calculation like
"$SUM( $ABOVE() )"
to tables located in TWiki.Tukro topics.- EditTablePlugin: Edit TWiki tables using edit fields, date pickers and drop down boxes
- InterwikiPlugin: Link
ExternalSite:Page
text to external sites based on aliases defined in the InterWikis topic- RenderListPlugin: Render bullet lists in a variety of formats
- SlideShowPlugin: Create web based presentations based on topics with headings.
- SmiliesPlugin: Render smilies as icons, like
:-)
for or:cool:
for- TablePlugin: Control attributes of tables and sorting of table columns
lib/TWiki/Func.pm
implements ALL official Plugin functions. Plugins should ONLY use functions published in this module.
DevALERT: If you use functions not in Func.pm
, you run the risk of creating security holes. Also, your Plugin will likely break and require updating when you upgrade to a new version of TWiki.
outsidePREHandler
and insidePREHandler
are particularly expensive.
lib/TWiki/Plugins/EmptyPlugin.pm
module.
DISABLE_
from the function name.
GetVersion
detection routine are provided for automatic compatibility checking.
$VERSION='0.000'
variable, beginning at 1.000
.
initPlugin
handler checks all dependencies and returns TRUE if the initialization is OK or FALSE if something went wrong.
initPlugin
handler).
$VERSION='1.000'
is the current setting in TWiki::Plugins.pm
and in the preinstalled system Plugins (DefaultPlugin, EmptyPlugin, InterwikiPlugin).
YourPlugin.pm
YourPlugin.txt
EmptyPlugin.pm
to <name>Plugin.pm
=EmptyPlugin.pm=
contains no executable code, so it does nothing, but it's ready to be used. Customize it. Refer to the Plugin API specs for more information.
OUTLINE: Doc Topic Contents
Check EmptyPlugin on TWiki.org for the latest Plugin doc topic template. Here's a quick overview of what's covered: Syntax Rules: Describe any special text formatting that will be rendered. YourPlugin Settings: Description and settings for your custom Plugin %VARIABLES%, and those required by TWiki. Plugins Preferences work exactly like TWikiPreferences and WebPreferences: six (6) spaces and then:How-to Instructions: Step-by-step set-up guide, user help, whatever it takes to install and run, goes here. Test Example: Include an example of the Plugin in action: if it works, the installation was a success! Plugin Info: Version, credits, history, requirements - entered in a form, displayed as a table. Both are automatically generated when you create or edit a page in the TWiki:Plugins web.
- Set EXAMPLE = got it!
Plugin
, ex: YourPlugin.pm
, and a documentation page with the same name(YourPlugin.txt
).
lib/TWiki/Plugins/YourPlugin.pm
data/TWiki/YourPlugin.txt
pub/TWiki/YourPlugin/uparrow.gif
[a required graphic]
YourPlugin.zip
) and add the entire directory structure from Step 1. Your archive should look like this:
lib/TWiki/Plugins/YourPlugin.pm
data/TWiki/YourPlugin.txt
pub/TWiki/YourPlugin/uparrow.gif
YourPlugin.txt
;
YourPlugin.zip
.
Dev
, ex: YourPluginDev
. This is the discussion page for future development. (User support for Plugins is handled in TWiki:Support.)
Topic TWikiPlugins . { |
Revision r1.10 - 02 Sep 2001 - 00:19 - MikeMannix? |
Copyright © 1999-2024 by the contributing authors.
All material on this collaboration platform is the property of the contributing authors. Ideas, requests, problems regarding TWiki.Tukro? Send feedback. |