X-Git-Url: https://git.openafs.org/?p=openafs-wiki.git;a=blobdiff_plain;f=TWiki%2FEmptyPlugin.mdwn;h=dd06c94ac7af3800b31e2337dbe2f76548518aed;hp=37fd24ea591fbb3700d01a74047fec5d60b4dddd;hb=a1173b6de0034b12460d1ab8eeb1df2ed88c9049;hpb=da36eac078602606663eb25f2b02b8402a0dbea8
diff --git a/TWiki/EmptyPlugin.mdwn b/TWiki/EmptyPlugin.mdwn
index 37fd24e..dd06c94 100644
--- a/TWiki/EmptyPlugin.mdwn
+++ b/TWiki/EmptyPlugin.mdwn
@@ -1,32 +1,59 @@
-## Empty TWiki Plugin
+# Empty TWiki Plugin
This is an empty plugin you can use as a template to build your own [[TWikiPlugins]]. This plugin does nothing, but is ready to be used.
To create your own plugin:
- Copy file **TWiki/Plugins/EmptyPlugin.pm**
to **<name>Plugin.pm**
and customize the plugin.
-- Copy this topic to **<name>Plugin**
and customize it.
+- Create a **<name>Plugin**
topic in the TWiki web. Do so by visiting **%<plugin name>\_<preference name>%**
, i.e. **%EMPTYPLUGIN\_SHORTDESCRIPTION%**
+Plugin settings are stored as preferences variables. To reference a plugin setting write **%<plugin>\_<setting>%**
, for example, **%EMPTYPLUGIN\_SHORTDESCRIPTION%**
-- One line description, is included in the [[TextFormattingRules]] topic:
+- One line description, shown in the [[TextFormattingRules]] topic:
- Set SHORTDESCRIPTION = This plugin does nothing, but can be used as a template for your own plugins.
-- Your own preferences, i.e.:
- - Set COLOR = red
+- Your own settings, for example:
+ - Set EXAMPLE = got it!
-### Plugin Installation Instructions
+- Debug plugin: (See output in `data/debug.txt`)
+ - Set DEBUG = 0
-- This plugin is preinstalled, you do not need to install it.
+## Plugin Installation Instructions
-### Plugin Info
+(This plugin is preinstalled, you do not need to install it.)
+
+**_Note:_** You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where TWiki is running.
+
+- Download the ZIP file from the Plugin web (see below)
+- Unzip **%TOPIC%.zip**
in your twiki installation directory. Content:
File: | +Description: | +
---|---|
data/TWiki/%TOPIC%.txt |
+ Plugin topic | +
data/TWiki/%TOPIC%.txt,v |
+ Plugin topic repository | +
lib/TWiki/Plugins/%TOPIC%.pm |
+ Plugin Perl module | +
Plugin Version: | -08 Jul 2001 | +14 Jul 2001 (V1.000) |
Change History: | - 08 Jul 2001: Changed to plug&play 27 Feb 2001: Initial version |
+ Â | +
14 Jul 2001: | +Changed to plug&play | +|
27 Feb 2001: | +Initial version | |
CPAN Dependencies: | @@ -51,7 +86,7 @@ Plugin preferences are stored as preferences variables. To reference a plugin pr||
Perl Version: | -5.0 | +5.005 |
Plugin Home: | @@ -65,4 +100,4 @@ Plugin preferences are stored as preferences variables. To reference a plugin pr **_Related Topics:_** [[TWikiPreferences]], [[TWikiPlugins]], [[DefaultPlugin]] --- [[AndreaSterbini]] - 27 Feb 2001