## <a name="Empty_TWiki_Plugin"> Empty TWiki Plugin </a>

This is an empty plugin you can use as a template to build your own %TWIKIWEB%.TWikiPlugins. This plugin does nothing, but is ready to be used.

To create your own plugin:

* Copy file <code>**TWiki/Plugins/EmptyPlugin.pm**</code> to <code>**&lt;name&gt;Plugin.pm**</code> and customize the plugin.
* Create a <code>**&lt;name&gt;Plugin**</code> topic in the %TWIKIWEB% 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.
* See details in %TWIKIWEB%.TWikiPlugins.

### <a name="Syntax_Rules"> Syntax Rules </a>

(none)

## <a name="Test_of_the_new_functionality"> Test of the new functionality </a>

<table border="1" cellpadding="1" cellspacing="0">
  <tr>
    <th bgcolor="#99CCCC"><strong>test case</strong></th>
    <th bgcolor="#99CCCC"><strong>input</strong></th>
    <th bgcolor="#99CCCC"><strong>output</strong></th>
    <th bgcolor="#99CCCC"><strong>expected</strong></th>
  </tr>
  <tr>
    <td> found </td>
    <td><nop>TestTopic1 </nop></td>
    <td><span style="background:"><font color="">Test Topic 1</font></span><a href="http://LOCATION/TestTopic1">?</a></td>
    <td><nop>TestTopic1 </nop></td>
  </tr>
  <tr>
    <td> found singular </td>
    <td><nop>SingularTopics </nop></td>
    <td><span style="background:"><font color="">Singular Topics</font></span><a href="http://LOCATION/SingularTopics">?</a></td>
    <td><nop>SingularTopic </nop></td>
  </tr>
  <tr>
    <td> found other web </td>
    <td><nop>CodingStandard </nop></td>
    <td><span style="background:"><font color="">Coding Standard</font></span><a href="http://LOCATION/CodingStandard">?</a></td>
    <td><nop>Digi.CodingStandard </nop></td>
  </tr>
  <tr>
    <td> found singular </td>
    <td><nop>CodingStandards </nop></td>
    <td><span style="background:"><font color="">Coding Standards</font></span><a href="http://LOCATION/CodingStandards">?</a></td>
    <td><nop>Digi.CodingStandards </nop></td>
  </tr>
  <tr>
    <td> found singular </td>
    <td><nop>WikiWord </nop></td>
    <td><span style="background:"><font color="">Wiki Word</font></span><a href="http://LOCATION/WikiWord">?</a></td>
    <td><nop>TWiki.WikiWord </nop></td>
  </tr>
</table>

## <a name="Don_t_break_other_types_of_wiki_"> Don't break other types of wiki words </a>

<table border="1" cellpadding="1" cellspacing="0">
  <tr>
    <th bgcolor="#99CCCC"><strong>input</strong></th>
    <th bgcolor="#99CCCC"><strong>output</strong></th>
  </tr>
  <tr>
    <td><nop>TestFindElsewhere#TopicAnchor </nop></td>
    <td><span style="background:"><font color="">Test Find Elsewhere#Topic Anchor</font></span><a href="http://LOCATION/TestFindElsewhere">?</a></td>
  </tr>
  <tr>
    <td><nop>Test.WebHome </nop></td>
    <td><span style="background:"><font color="">Web Home</font></span><a href="http://LOCATIONTest/WebHome">?</a></td>
  </tr>
  <tr>
    <td><nop>WebHome </nop></td>
    <td><span style="background:"><font color="">Web Home</font></span><a href="http://LOCATION/WebHome">?</a></td>
  </tr>
  <tr>
    <td> [<nop>[Test.WebHome]] </nop></td>
    <td><span style="background:"><font color="">Test.Web Home</font></span><a href="http://LOCATIONTest/WebHome">?</a></td>
  </tr>
  <tr>
    <td> [<nop>[Digi.CodingStandard]] </nop></td>
    <td><span style="background:"><font color="">Digi.Coding Standard</font></span><a href="http://LOCATIONDigi/CodingStandard">?</a></td>
  </tr>
  <tr>
    <td> [<nop>[Digi.CodingStandards]] </nop></td>
    <td><span style="background:"><font color="">Digi.Coding Standards</font></span><a href="http://LOCATIONDigi/CodingStandards">?</a></td>
  </tr>
  <tr>
    <td><nop>Digi.CodingStandard </nop></td>
    <td><span style="background:"><font color="">Coding Standard</font></span><a href="http://LOCATIONDigi/CodingStandard">?</a></td>
  </tr>
  <tr>
    <td><nop>Digi.CodingStandards </nop></td>
    <td><span style="background:"><font color="">Coding Standards</font></span><a href="http://LOCATIONDigi/CodingStandards">?</a></td>
  </tr>
</table>

<a name="TopicAnchor"></a>

### <a name="_TOPIC_Settings"> %TOPIC% Settings </a>

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>

* One line description, is shown in the %TWIKIWEB%.TextFormattingRules topic:
  * Set SHORTDESCRIPTION = This plugin does nothing, but can be used as a template for your own plugins.

* Your own setting, i.e.:
  * Set EXAMPLE = Digi

* List other webs in which to look for topics that don't exist
  * Set LOOKHERE = Digi
  * Set LOOKHEREMULTI = Digi, TWiki

* If the [[TWiki/WikiWord]] is plural but doesn't exist, also look for the singular word
  * Set PLURALTOSINGULAR = 1

* Debug plugin: (See output in `data/debug.txt`)
  * Set DEBUG = 1

### <a name="Plugin_Installation_Instructions"> Plugin Installation Instructions </a>

* This plugin is preinstalled, you do not need to install it.

### <a name="Plugin_Info"> Plugin Info </a>

<table border="1" cellpadding="1" cellspacing="0">
  <tr>
    <td align="right"> Plugin Author: </td>
    <td> %TWIKIWEB%.AndreaSterbini, %TWIKIWEB%.PeterThoeny </td>
  </tr>
  <tr>
    <td align="right"> Plugin Version: </td>
    <td> 14 Jul 2001 </td>
  </tr>
  <tr>
    <td align="right"> Change History: </td>
    <td> 14 Jul 2001: Changed to plug&amp;amp;play <br /> 27 Feb 2001: Initial version </td>
  </tr>
  <tr>
    <td align="right"> CPAN Dependencies: </td>
    <td> none </td>
  </tr>
  <tr>
    <td align="right"> Other Dependencies: </td>
    <td> none </td>
  </tr>
  <tr>
    <td align="right"> Perl Version: </td>
    <td> 5.0 </td>
  </tr>
  <tr>
    <td align="right"> Plugin Home: </td>
    <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td>
  </tr>
  <tr>
    <td align="right"> Feedback: </td>
    <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>
  </tr>
</table>

**_Related Topics:_** %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins, [[DefaultPlugin]]

-- %TWIKIWEB%.AndreaSterbini - 27 Feb 2001 <br /> -- %TWIKIWEB%.PeterThoeny - 14 Jul 2001 <br />