TWiki/SmiliesPlugin.mdwn

   1 # <a name="The Smilies Plugin :-)"></a> The Smilies Plugin :-)
   2
   3 Smilies are common in e-mail messages and bulletin board posts. They are used to convey an emotion, such as a smile :-) or a frown :-( . This plugin automatically converts certain smilies to a nice small icon.
   4
   5 Here is the list of smilies supported by this plugin. To add others, attach new icons to this topic and tweak the table below.
   6
   7 <table border="1" cellpadding="0" cellspacing="0">
   8   <tr>
   9     <th bgcolor="#99CCCC"><strong> You type </strong></th>
  10     <th bgcolor="#99CCCC"><strong> You see </strong></th>
  11     <th bgcolor="#99CCCC"><strong> Emotion </strong></th>
  12   </tr>
  13   <tr>
  14     <td> :-) </td>
  15     <td><img alt="smile.gif" src="http://www.dementia.org/twiki//view/smile.gif" /></td>
  16     <td> "smile" </td>
  17   </tr>
  18   <tr>
  19     <td> :) </td>
  20     <td><img alt="smile.gif" src="http://www.dementia.org/twiki//view/smile.gif" /></td>
  21     <td> "smile" </td>
  22   </tr>
  23   <tr>
  24     <td> 8-) </td>
  25     <td><img alt="cool.gif" src="http://www.dementia.org/twiki//view/cool.gif" /></td>
  26     <td> "cool!" </td>
  27   </tr>
  28   <tr>
  29     <td> :cool: </td>
  30     <td><img alt="cool.gif" src="http://www.dementia.org/twiki//view/cool.gif" /></td>
  31     <td> "cool!" </td>
  32   </tr>
  33   <tr>
  34     <td> :-I </td>
  35     <td><img alt="indifferent.gif" src="http://www.dementia.org/twiki//view/indifferent.gif" /></td>
  36     <td> "indifferent" </td>
  37   </tr>
  38   <tr>
  39     <td> :( </td>
  40     <td><img alt="frown.gif" src="http://www.dementia.org/twiki//view/frown.gif" /></td>
  41     <td> "frown" </td>
  42   </tr>
  43   <tr>
  44     <td> :-( </td>
  45     <td><img alt="frown.gif" src="http://www.dementia.org/twiki//view/frown.gif" /></td>
  46     <td> "frown" </td>
  47   </tr>
  48   <tr>
  49     <td> :o </td>
  50     <td><img alt="redface.gif" src="http://www.dementia.org/twiki//view/redface.gif" /></td>
  51     <td> "embarrassment" </td>
  52   </tr>
  53   <tr>
  54     <td> :D </td>
  55     <td><img alt="biggrin.gif" src="http://www.dementia.org/twiki//view/biggrin.gif" /></td>
  56     <td> "big grin" </td>
  57   </tr>
  58   <tr>
  59     <td> :-D </td>
  60     <td><img alt="biggrin.gif" src="http://www.dementia.org/twiki//view/biggrin.gif" /></td>
  61     <td> "big grin" </td>
  62   </tr>
  63   <tr>
  64     <td> ;) </td>
  65     <td><img alt="wink.gif" src="http://www.dementia.org/twiki//view/wink.gif" /></td>
  66     <td> "wink" </td>
  67   </tr>
  68   <tr>
  69     <td> ;-) </td>
  70     <td><img alt="wink.gif" src="http://www.dementia.org/twiki//view/wink.gif" /></td>
  71     <td> "wink" </td>
  72   </tr>
  73   <tr>
  74     <td> :p </td>
  75     <td><img alt="tongue.gif" src="http://www.dementia.org/twiki//view/tongue.gif" /></td>
  76     <td> "razz (stick out tongue)" </td>
  77   </tr>
  78   <tr>
  79     <td> :rolleyes: </td>
  80     <td><img alt="rolleyes.gif" src="http://www.dementia.org/twiki//view/rolleyes.gif" /></td>
  81     <td> "roll eyes (sarcastic)" </td>
  82   </tr>
  83   <tr>
  84     <td> :mad: </td>
  85     <td><img alt="mad.gif" src="http://www.dementia.org/twiki//view/mad.gif" /></td>
  86     <td> "mad!" </td>
  87   </tr>
  88   <tr>
  89     <td> :eek: </td>
  90     <td><img alt="eek.gif" src="http://www.dementia.org/twiki//view/eek.gif" /></td>
  91     <td> "eek!" </td>
  92   </tr>
  93   <tr>
  94     <td> :confused: </td>
  95     <td><img alt="confused.gif" src="http://www.dementia.org/twiki//view/confused.gif" /></td>
  96     <td> "confused" </td>
  97   </tr>
  98   <tr>
  99     <td>  &gt;:-) </td>
 100     <td><img alt="devil.gif" src="http://www.dementia.org/twiki//view/devil.gif" /></td>
 101     <td> "hehe!" </td>
 102   </tr>
 103   <tr>
 104     <td> :devil: </td>
 105     <td><img alt="devil.gif" src="http://www.dementia.org/twiki//view/devil.gif" /></td>
 106     <td> "hehe!" </td>
 107   </tr>
 108   <tr>
 109     <td>  &gt;;-) </td>
 110     <td><img alt="devilwink.gif" src="http://www.dementia.org/twiki//view/devilwink.gif" /></td>
 111     <td> "hehe! (friendly)" </td>
 112   </tr>
 113   <tr>
 114     <td> :devilish: </td>
 115     <td><img alt="devilwink.gif" src="http://www.dementia.org/twiki//view/devilwink.gif" /></td>
 116     <td> "hehe! (friendly)" </td>
 117   </tr>
 118 </table>
 119
 120 ## <a name="%TOPIC% Global Settings"></a> %TOPIC% Global Settings
 121
 122 Plugin settings are stored as preferences variables. To reference a plugin setting write <code>**%&lt;plugin&gt;\_&lt;setting&gt;%**</code>, for example, <code>**%INTERWIKIPLUGIN\_SHORTDESCRIPTION%**</code>
 123
 124 - One line description, shown in the [[TextFormattingRules]] topic:
 125   - Set SHORTDESCRIPTION = Render smilies as icons, like ` :-)` for :-) or ` :cool:` for :cool:
 126
 127 - Set DEBUG to 1 to get debug messages in `data/debug.txt`. Default: `0`
 128   - Set DEBUG = 0
 129
 130 - The name of the topic containig your Smilies. Default: <code>**%WEB%.SmiliesPlugin**</code>
 131   - #Set TOPIC = [[SmiliesPlugin]]
 132
 133 - The way the _emoticon_ is displayed. You can use <code>**$emoticon**</code> (e.g. `:D`), <code>**$url**</code> (e.g. `%ATTACHURL%/biggrin.gif`) and <code>**$tooltip**</code> (e.g. `"big grin"`). Default: <code>**&lt;img src="$url" alt="$tooltip" /&gt;**</code>
 134
 135           * #Set FORMAT = <img src="$url" alt="$emoticon" />
 136
 137 ## <a name="Plugin Installation Instructions"></a> Plugin Installation Instructions
 138
 139 - Download the ZIP file from the Plugin web (see below)
 140 - Unzip <code>**%TOPIC%.zip**</code> in your twiki installation directory. Content: <table border="1" cellpadding="0" cellspacing="0">
 141   <tr>
 142     <th bgcolor="#99CCCC"><strong> File: </strong></th>
 143     <th bgcolor="#99CCCC"><strong> Description: </strong></th>
 144   </tr>
 145   <tr>
 146     <td><code><b>data/TWiki/%TOPIC%.txt</b></code></td>
 147     <td> Plugin topic </td>
 148   </tr>
 149   <tr>
 150     <td><code><b>data/TWiki/%TOPIC%.txt,v</b></code></td>
 151     <td> Plugin topic repository </td>
 152   </tr>
 153   <tr>
 154     <td><code><b>lib/TWiki/Plugins/%TOPIC%.pm</b></code></td>
 155     <td> Plugin Perl module </td>
 156   </tr>
 157   <tr>
 158     <td><code><b>pub/TWiki/%TOPIC%/*.gif</b></code></td>
 159     <td> Plugin icon files </td>
 160   </tr>
 161 </table>
 162 - Test if the plugin is correctly installed:
 163   - You will see a series of icons on next line: <br /> :-) :) :cool: :( :o :D ;) :p :rolleyes: :mad: :eek: :confused: &gt;:-) &gt;;-)
 164
 165 ## <a name="Plugin Info"></a> Plugin Info
 166
 167 <table border="1" cellpadding="0" cellspacing="0">
 168   <tr>
 169     <td align="right"> Plugin Author: </td>
 170     <td> TWiki:Main.AndreaSterbini </td>
 171   </tr>
 172   <tr>
 173     <td align="right"> Plugin Version: </td>
 174     <td> 16 Feb 2004 (v1.002) </td>
 175   </tr>
 176   <tr>
 177     <td align="right"> Change History: </td>
 178     <td>  </td>
 179   </tr>
 180   <tr>
 181     <td align="right"> 16 Feb 2004: </td>
 182     <td> Added "devil" and "devilwink" smilies (by TWiki:Main.CrawfordCurrie) </td>
 183   </tr>
 184   <tr>
 185     <td align="right"> 26 Feb 2003: </td>
 186     <td> Added "indifferent" smilie </td>
 187   </tr>
 188   <tr>
 189     <td align="right"> 20 Oct 2002: </td>
 190     <td> Fixed STDERR warning for non-initialized Plugin </td>
 191   </tr>
 192   <tr>
 193     <td align="right"> 20 Apr 2002: </td>
 194     <td> Improved performance; removed non-standard Plugin API dependencies; added standard plugin topic content -- TWiki:Main.PeterThoeny </td>
 195   </tr>
 196   <tr>
 197     <td align="right"> 23 Nov 2001: </td>
 198     <td> Added TOPIC and FORMAT setting </td>
 199   </tr>
 200   <tr>
 201     <td align="right"> 10 Jun 2001: </td>
 202     <td> Packaged into ZIP </td>
 203   </tr>
 204   <tr>
 205     <td align="right"> 28 Feb 2001: </td>
 206     <td> Initial version </td>
 207   </tr>
 208   <tr>
 209     <td align="right"> CPAN Dependencies: </td>
 210     <td> none </td>
 211   </tr>
 212   <tr>
 213     <td align="right"> Other Dependencies: </td>
 214     <td> none </td>
 215   </tr>
 216   <tr>
 217     <td align="right"> Perl Version: </td>
 218     <td> 5.0 </td>
 219   </tr>
 220   <tr>
 221     <td align="right"> Plugin Home: </td>
 222     <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td>
 223   </tr>
 224   <tr>
 225     <td align="right"> Feedback: </td>
 226     <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>
 227   </tr>
 228 </table>
 229
 230 **_Related Topics:_** [[TWikiPreferences]], [[TWikiPlugins]]
 231
 232 -- TWiki:Main.AndreaSterbini - 28 Dec 2000 <br /> -- TWiki:Main.PeterThoeny - 16 Feb 2004