75de54f2b7d4b6c30258e8bddd8b0c6a6877ce1c
[openafs-wiki.git] / TWiki / EmptyPlugin.mdwn
1 # <a name="Empty TWiki Plugin"></a> Empty TWiki Plugin
2
3 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.
4
5 To create your own plugin:
6
7 - Copy file <code>**TWiki/Plugins/EmptyPlugin.pm**</code> to <code>**&lt;name&gt;Plugin.pm**</code> and customize the plugin.
8 - Create a <code>**&lt;name&gt;Plugin**</code> topic in the TWiki web. Do so by visiting <http://TWiki.org/cgi-bin/view/Plugins/> and starting a new topic to get the default plugin topic text (don't save the topic). Customize your plugin topic to your needs.
9 - See details in [[TWikiPlugins]].
10
11 ## <a name="Syntax Rules"></a> Syntax Rules
12
13 (none)
14
15 ## <a name="Plugin Settings"></a> Plugin Settings
16
17 Plugin settings are stored as preferences variables. To reference a plugin setting write <code>**%&lt;plugin&gt;\_&lt;setting&gt;%**</code>, i.e. <code>**%EMPTYPLUGIN\_SHORTDESCRIPTION%**</code>
18
19 - One line description, is shown in the [[TextFormattingRules]] topic:
20   - Set SHORTDESCRIPTION = This plugin does nothing, but can be used as a template for your own plugins.
21
22 - Your own setting, for example:
23   - Set EXAMPLE = got it!
24
25 - Debug plugin: (See output in `data/debug.txt`)
26   - Set DEBUG = 0
27
28 ## <a name="Plugin Installation Instructions"></a> Plugin Installation Instructions
29
30 - This plugin is preinstalled, you do not need to install it.
31
32 ## <a name="Plugin Info"></a> Plugin Info
33
34 <table border="1" cellpadding="0" cellspacing="0">
35   <tr>
36     <td align="right"> Plugin Author: </td>
37     <td> TWiki:Main.AndreaSterbini, TWiki:Main.PeterThoeny </td>
38   </tr>
39   <tr>
40     <td align="right"> Plugin Version: </td>
41     <td> 21 Mar 2004 </td>
42   </tr>
43   <tr>
44     <td align="right"> Change History: </td>
45     <td>  </td>
46   </tr>
47   <tr>
48     <td align="right"> 21 Mar 2004: </td>
49     <td> Added afterSaveHandler </td>
50   </tr>
51   <tr>
52     <td align="right"> 14 Jul 2001: </td>
53     <td> Changed to plug&amp;play </td>
54   </tr>
55   <tr>
56     <td align="right"> 27 Feb 2001: </td>
57     <td> Initial version </td>
58   </tr>
59   <tr>
60     <td align="right"> CPAN Dependencies: </td>
61     <td> none </td>
62   </tr>
63   <tr>
64     <td align="right"> Other Dependencies: </td>
65     <td> none </td>
66   </tr>
67   <tr>
68     <td align="right"> Perl Version: </td>
69     <td> 5.0 </td>
70   </tr>
71   <tr>
72     <td align="right"> TWiki:Plugins/Benchmark: </td>
73     <td>[[TWiki/GoodStyle]] 99%, [[TWiki/FormattedSearch]] 99%, %TOPIC% 99% </td>
74   </tr>
75   <tr>
76     <td align="right"> Plugin Home: </td>
77     <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td>
78   </tr>
79   <tr>
80     <td align="right"> Feedback: </td>
81     <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a></td>
82   </tr>
83   <tr>
84     <td align="right"> Appraisal: </td>
85     <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Appraisal" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Appraisal</a></td>
86   </tr>
87 </table>
88
89 **_Related Topics:_** [[DeveloperDocumentationCategory]], [[AdminDocumentationCategory]], [[TWikiPreferences]], [[TWikiPlugins]]