TWiki/TablePlugin.mdwn

   1 # <a name="Table Plugin"></a> Table Plugin
   2
   3 Gives extra control of table display:
   4
   5 - Allows sorting
   6 - Changing table properties like border width, cell spacing and cell padding
   7 - Changing background color and text color for header cells
   8 - Changing background color and text color for data cells - colors can _alternate_
   9 - Table attributes can be set and overridden in this order:
  10   - Default `TABLEATTRIBUTES` Plugin setting in this topic.
  11   - A `TABLEATTRIBUTES` preferences setting on site-level ([[TWikiPreferences]]) or web-level (any [[WebPreferences]]), e.g.
  12     - `Set TABLEATTRIBUTES = tableborder="0" cellpadding="1" ...`
  13   - Before a table using `%TABLE{...}%`
  14 - Row spans
  15
  16 ## <a name="Sorting"></a> Sorting
  17
  18 Click on column heading text to sort by a column. Initial column will be sorted in descending order, click again to get ascending order. The type of data in the cell is determined automatically:
  19
  20 - date if format is:
  21   - dd MMM YYY - hh:mm
  22   - dd-MMM-YY or dd-MMM-YYYY (can be / or space in place of -)
  23   - MMM is Jan, Feb, etc
  24 - number is digits, with optional decimal point
  25 - otherwise treated as text
  26
  27 ## <a name="Row spans"></a> Row spans
  28
  29 Table cells with a single caret indicate follow-up rows of multi-row spans. For example,
  30
  31 <table width="100%">
  32   <tr>
  33     <td><pre>
  34 | One One | One Two | One Three |
  35 | ^ | Two Two | Two Three |
  36 | Three One | ^ | Three Three |
  37 </pre></td>
  38     <td align="right">
  39       <table border="1" cellpadding="0" cellspacing="0" style="border-width: 1px">
  40         <tr>
  41           <td bgcolor="#ecf2f8" rowspan="2" style=""> One One </td>
  42           <td bgcolor="#ecf2f8" style=""> One Two </td>
  43           <td bgcolor="#ecf2f8" style=""> One Three </td>
  44         </tr>
  45         <tr>
  46           <td bgcolor="#ffffff" rowspan="2" style=""> Two Two </td>
  47           <td bgcolor="#ffffff" style=""> Two Three </td>
  48         </tr>
  49         <tr>
  50           <td bgcolor="#ecf2f8" style=""> Three One </td>
  51           <td bgcolor="#ecf2f8" style=""> Three Three </td>
  52         </tr>
  53       </table>
  54     </td>
  55   </tr>
  56 </table>
  57
  58 ## <a name="%TOPIC% Global Settings"></a> %TOPIC% Global Settings
  59
  60 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>
  61
  62 - One line description, shown in the [[TextFormattingRules]] topic:
  63   - Set SHORTDESCRIPTION = Control attributes of tables and sorting of table columns
  64
  65 - Set DEBUG to 1 to get debug messages in `data/debug.txt`. Default: `0`
  66   - Set DEBUG = 0
  67
  68 - Make all tables in a topic sortable. If this is set to `all`, all tables that have a header row (including those that do not have %TABLE before them) will be made sortable. If set to `none`, only tables with %TABLE will be sortable. Topic rendering is faster if this is set to `none`.
  69   - #Set SORT = none
  70   - Set SORT = all
  71
  72 - Default table attributes:
  73   - Set TABLEATTRIBUTES = tableborder="0" cellpadding="1" cellspacing="1" headerbg="#dadada" headercolor="#000000" databg="#eaeaea, #ffffff"
  74   - Classic skin table attributes:
  75     - #Set TABLEATTRIBUTES = tableborder="1" cellpadding="0" cellspacing="1" headerbg="#99CCCC" databg="#FFFFCC, #FFFFFF"
  76
  77 ## <a name="Table Attributes"></a> Table Attributes
  78
  79 Attributes are defined as a `TABLEATTRIBUTES` Plugin setting in this topic, a `TABLEATTRIBUTES` preferences setting, or on line before the table using `%TABLE{...}%`:
  80
  81 <table border="1" cellpadding="0" cellspacing="0" style="border-width: 1px">
  82   <tr>
  83     <th bgcolor="#6b7f93" maxcols="0" style=""><a href="http://localhost?sortcol=0;table=2;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#ffffff">Argument</font></a></th>
  84     <th bgcolor="#6b7f93" maxcols="0" style=""><a href="http://localhost?sortcol=1;table=2;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#ffffff">Comment</font></a></th>
  85     <th bgcolor="#6b7f93" maxcols="0" style=""><a href="http://localhost?sortcol=2;table=2;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#ffffff">Example</font></a></th>
  86   </tr>
  87   <tr>
  88     <td bgcolor="#ecf2f8" style=""><code>sort</code></td>
  89     <td bgcolor="#ecf2f8" style=""> Set table sorting <code>"on"</code> or <code>"off"</code></td>
  90     <td bgcolor="#ecf2f8" style=""><code>sort="on"</code></td>
  91   </tr>
  92   <tr>
  93     <td bgcolor="#ffffff" style=""><code>initsort</code></td>
  94     <td bgcolor="#ffffff" style=""> Column to sort initially (<code>"1"</code> to number of columns) </td>
  95     <td bgcolor="#ffffff" style=""><code>initsort="2"</code></td>
  96   </tr>
  97   <tr>
  98     <td bgcolor="#ecf2f8" style=""><code>initdirection</code></td>
  99     <td bgcolor="#ecf2f8" style=""> Initial sorting direction for <code>initsort</code>, set to <code>"up"</code> or <code>"down"</code></td>
 100     <td bgcolor="#ecf2f8" style=""><code>initdirection="up"</code></td>
 101   </tr>
 102   <tr>
 103     <td bgcolor="#ffffff" style=""><code>headerbg</code></td>
 104     <td bgcolor="#ffffff" style=""> Header cell background colour. Choose one of the [[TWiki/StandardColors]]</td>
 105     <td bgcolor="#ffffff" style=""><code>headerbg="#99CCCC"</code></td>
 106   </tr>
 107   <tr>
 108     <td bgcolor="#ecf2f8" style=""><code>headercolor</code></td>
 109     <td bgcolor="#ecf2f8" style=""> Header cell text colour </td>
 110     <td bgcolor="#ecf2f8" style=""><code>headercolor="#0000CC"</code></td>
 111   </tr>
 112   <tr>
 113     <td bgcolor="#ffffff" style=""><code>databg</code></td>
 114     <td bgcolor="#ffffff" style=""> Data cell background colour, a comma separated list. Specify <code>"none"</code> for no colour, that is to use the colour/background of the page the table is on. </td>
 115     <td bgcolor="#ffffff" style=""><code>databg="#C8CB8F, #DBDDB5"</code></td>
 116   </tr>
 117   <tr>
 118     <td bgcolor="#ecf2f8" style=""><code>datacolor</code></td>
 119     <td bgcolor="#ecf2f8" style=""> Data cell text colour, a comma separated list </td>
 120     <td bgcolor="#ecf2f8" style=""><code>datacolor="#0000CC, #000000"</code></td>
 121   </tr>
 122   <tr>
 123     <td bgcolor="#ffffff" style=""><code>tableborder</code></td>
 124     <td bgcolor="#ffffff" style=""> Table border width (pixels) </td>
 125     <td bgcolor="#ffffff" style=""><code>tableborder="2"</code></td>
 126   </tr>
 127   <tr>
 128     <td bgcolor="#ecf2f8" style=""><code>tableframe</code></td>
 129     <td bgcolor="#ecf2f8" style=""> Table frame, set to <code>"void"</code> (no sides), <code>"above"</code> (the top side only), <code>"below"</code> (the bottom side only), <code>"hsides"</code> (the top and bottom sides only), <code>"lhs"</code> (the left-hand side only), <code>"rhs"</code> (the right-hand side only), <code>"vsides"</code> (the right and left sides only), <code>"box"</code> (all four sides), <code>"border"</code> (all four sides); default <code>"void"</code></td>
 130     <td bgcolor="#ecf2f8" style=""><code>tableframe="hsides"</code></td>
 131   </tr>
 132   <tr>
 133     <td bgcolor="#ffffff" style=""><code>tablerules</code></td>
 134     <td bgcolor="#ffffff" style=""> Table rules, set to <code>"none"</code> (no rules), <code>"groups"</code> (rules will appear between row groups and column groups only), <code>"rows"</code> (rules will appear between rows only), <code>"cols"</code> (rules will appear between columns only), <code>"all"</code> (rules will appear between all rows and columns); default <code>"none"</code></td>
 135     <td bgcolor="#ffffff" style=""><code>tablerules="rows"</code></td>
 136   </tr>
 137   <tr>
 138     <td bgcolor="#ecf2f8" style=""><code>cellpadding</code></td>
 139     <td bgcolor="#ecf2f8" style=""> Cell padding (pixels) </td>
 140     <td bgcolor="#ecf2f8" style=""><code>cellpadding="0"</code></td>
 141   </tr>
 142   <tr>
 143     <td bgcolor="#ffffff" style=""><code>cellspacing</code></td>
 144     <td bgcolor="#ffffff" style=""> Cell spacing (pixels) </td>
 145     <td bgcolor="#ffffff" style=""><code>cellspacing="3"</code></td>
 146   </tr>
 147   <tr>
 148     <td bgcolor="#ecf2f8" style=""><code>valign</code></td>
 149     <td bgcolor="#ecf2f8" style=""> Vertical alignment of cells, set to <code>"top"</code>, <code>"middle"</code>, <code>"bottom"</code> or <code>"baseline"</code></td>
 150     <td bgcolor="#ecf2f8" style=""><code>valign="top"</code></td>
 151   </tr>
 152   <tr>
 153     <td bgcolor="#ffffff" style=""><code>headeralign</code></td>
 154     <td bgcolor="#ffffff" style=""> Header cell alignment, one value for all columns, or a comma separated list for different alignment of individual columns. Set to <code>"left"</code>, <code>"center"</code>, <code>"right"</code> or <code>"justify"</code>. Overrides individual cell settings </td>
 155     <td bgcolor="#ffffff" style=""><code>headeralign="left, right"</code></td>
 156   </tr>
 157   <tr>
 158     <td bgcolor="#ecf2f8" style=""><code>dataalign</code></td>
 159     <td bgcolor="#ecf2f8" style=""> Data cell alignment, one value for all columns, or a comma separated list for different alignment of individual columns. Set to <code>"left"</code>, <code>"center"</code>, <code>"right"</code> or <code>"justify"</code>. Overrides individual cell settings </td>
 160     <td bgcolor="#ecf2f8" style=""><code>dataalign="center"</code></td>
 161   </tr>
 162   <tr>
 163     <td bgcolor="#ffffff" style=""><code>tablewidth</code></td>
 164     <td bgcolor="#ffffff" style=""> Table width: Percentage of window width, or absolute pixel value. Default is unspecified. </td>
 165     <td bgcolor="#ffffff" style=""><code>tablewidth="100%"</code></td>
 166   </tr>
 167   <tr>
 168     <td bgcolor="#ecf2f8" style=""><code>columnwidths</code></td>
 169     <td bgcolor="#ecf2f8" style=""> Column widths: Comma delimited list of column widths, percentage or absolute pixel value. Default is unspecified. </td>
 170     <td bgcolor="#ecf2f8" style=""><code>columnwidths="80%, 20%"</code></td>
 171   </tr>
 172   <tr>
 173     <td bgcolor="#ffffff" style=""><code>headerrows</code></td>
 174     <td bgcolor="#ffffff" style=""> Number of header rows to exclude from sort; default <code>"1"</code></td>
 175     <td bgcolor="#ffffff" style=""><code>headerrows="1"</code></td>
 176   </tr>
 177   <tr>
 178     <td bgcolor="#ecf2f8" style=""><code>footerrows</code></td>
 179     <td bgcolor="#ecf2f8" style=""> Number of footer rows to exclude from sort; default <code>"0"</code></td>
 180     <td bgcolor="#ecf2f8" style=""><code>footerrows="1"</code></td>
 181   </tr>
 182   <tr>
 183     <td bgcolor="#ffffff" style=""><code>id</code></td>
 184     <td bgcolor="#ffffff" style=""> Table identifier string. Default is unspecified. </td>
 185     <td bgcolor="#ffffff" style=""><code>id="userTable"</code></td>
 186   </tr>
 187   <tr>
 188     <td bgcolor="#ecf2f8" style=""><code>summary</code></td>
 189     <td bgcolor="#ecf2f8" style=""> Table summary used by screenreaders: A summary of what the table presents. It should provide an orientation for someone who listens to the table. Default is unspecified. </td>
 190     <td bgcolor="#ecf2f8" style=""><code>summary="List of subscribed users"</code></td>
 191   </tr>
 192   <tr>
 193     <td bgcolor="#ffffff" style=""><code>caption</code></td>
 194     <td bgcolor="#ffffff" style=""> Table caption: A title that will be displayed just above the table. Default is unspecified. </td>
 195     <td bgcolor="#ffffff" style=""><code>caption="Users"</code></td>
 196   </tr>
 197 </table>
 198
 199 The `%TABLE{...}%` settings override `TABLEATTRIBUTES` preferences settings, which override the `TABLEATTRIBUTES` Plugin settings.
 200
 201 ## <a name="Examples"></a> Examples
 202
 203 ### <a name="Use of %TABLE{...}%"></a> Use of %TABLE\{...\}%
 204
 205 Line before table: `%TABLE{ sort="on" tableborder="0" cellpadding="1" cellspacing="3" headerbg="#D5CCB1" headercolor="#666666" databg="#FAF0D4, #F3DFA8" headerrows="2" footerrows="1" }%`
 206
 207 <table border="0" cellpadding="1" cellspacing="3" style="border-width: 0px">
 208   <tr>
 209     <th bgcolor="#D5CCB1" colspan="6" maxcols="0" style=""><span><font color="#666666"> <strong> Table with two Header Rows and Footer Row </strong> </font></span></th>
 210   </tr>
 211   <tr>
 212     <th bgcolor="#D5CCB1" maxcols="0" style=""><a href="http://localhost?sortcol=0;table=3;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#666666">Num</font></a></th>
 213     <th bgcolor="#D5CCB1" maxcols="0" style=""><a href="http://localhost?sortcol=1;table=3;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#666666">Status</font></a></th>
 214     <th bgcolor="#D5CCB1" maxcols="0" style=""><a href="http://localhost?sortcol=2;table=3;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#666666">Action</font></a></th>
 215     <th bgcolor="#D5CCB1" maxcols="0" style=""><a href="http://localhost?sortcol=3;table=3;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#666666">Who</font></a></th>
 216     <th bgcolor="#D5CCB1" maxcols="0" style=""><a href="http://localhost?sortcol=4;table=3;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#666666">When</font></a></th>
 217     <th bgcolor="#D5CCB1" maxcols="0" style=""><a href="http://localhost?sortcol=5;table=3;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#666666">Progress</font></a></th>
 218   </tr>
 219   <tr>
 220     <td bgcolor="#FAF0D4" style=""> 1 </td>
 221     <td bgcolor="#FAF0D4" style=""> C </td>
 222     <td bgcolor="#FAF0D4" style=""> Chose new colours </td>
 223     <td bgcolor="#FAF0D4" style=""> John </td>
 224     <td bgcolor="#FAF0D4" style=""> 1-Dec-02 </td>
 225     <td bgcolor="#FAF0D4" style="">   </td>
 226   </tr>
 227   <tr>
 228     <td bgcolor="#F3DFA8" style=""> 2 </td>
 229     <td bgcolor="#F3DFA8" style=""> X </td>
 230     <td bgcolor="#F3DFA8" style=""> Release </td>
 231     <td bgcolor="#F3DFA8" style=""> John </td>
 232     <td bgcolor="#F3DFA8" style=""> 1-Apr-02 </td>
 233     <td bgcolor="#F3DFA8" style="">   </td>
 234   </tr>
 235   <tr>
 236     <td bgcolor="#FAF0D4" style=""> 3 </td>
 237     <td bgcolor="#FAF0D4" style="">   </td>
 238     <td bgcolor="#FAF0D4" style=""> Get feedback </td>
 239     <td bgcolor="#FAF0D4" style=""> Anne </td>
 240     <td bgcolor="#FAF0D4" style=""> 1-Feb-02 </td>
 241     <td bgcolor="#FAF0D4" style="">   </td>
 242   </tr>
 243   <tr>
 244     <td bgcolor="#F3DFA8" style=""> 12 </td>
 245     <td bgcolor="#F3DFA8" style=""> C </td>
 246     <td bgcolor="#F3DFA8" style=""> Spec error handling </td>
 247     <td bgcolor="#F3DFA8" style=""> Jack </td>
 248     <td bgcolor="#F3DFA8" style=""> 1-Dec-02 </td>
 249     <td bgcolor="#F3DFA8" style="">   </td>
 250   </tr>
 251   <tr>
 252     <td bgcolor="#FAF0D4" style=""> 5 </td>
 253     <td bgcolor="#FAF0D4" style="">   </td>
 254     <td bgcolor="#FAF0D4" style=""> Abc </td>
 255     <td bgcolor="#FAF0D4" style=""> John </td>
 256     <td bgcolor="#FAF0D4" style="">   </td>
 257     <td bgcolor="#FAF0D4" style="">   </td>
 258   </tr>
 259   <tr>
 260     <th bgcolor="#D5CCB1" maxcols="0" style=""><span><font color="#666666"> <strong> Num </strong> </font></span></th>
 261     <th bgcolor="#D5CCB1" maxcols="0" style=""><span><font color="#666666"> <strong> Status </strong> </font></span></th>
 262     <th bgcolor="#D5CCB1" maxcols="0" style=""><span><font color="#666666"> <strong> Action </strong> </font></span></th>
 263     <th bgcolor="#D5CCB1" maxcols="0" style=""><span><font color="#666666"> <strong> Who </strong> </font></span></th>
 264     <th bgcolor="#D5CCB1" maxcols="0" style=""><span><font color="#666666"> <strong> When </strong> </font></span></th>
 265     <th bgcolor="#D5CCB1" maxcols="0" style=""><span><font color="#666666"> <strong> Progress </strong> </font></span></th>
 266   </tr>
 267 </table>
 268
 269 ### <a name="Table with 4 digit year dates an"></a> Table with 4 digit year dates and no use of %TABLE\{...\}%
 270
 271 <table border="1" cellpadding="0" cellspacing="0" style="border-width: 1px">
 272   <tr>
 273     <th bgcolor="#6b7f93" maxcols="0" style=""><a href="http://localhost?sortcol=0;table=4;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#ffffff">When</font></a></th>
 274   </tr>
 275   <tr>
 276     <td bgcolor="#ecf2f8" style=""> 1-Jan-2004 </td>
 277   </tr>
 278   <tr>
 279     <td bgcolor="#ffffff" style=""> 1-Jan-2003 </td>
 280   </tr>
 281   <tr>
 282     <td bgcolor="#ecf2f8" style=""> 2-Jan-2005 </td>
 283   </tr>
 284 </table>
 285
 286 ## <a name="Plugin Installation Instructions"></a> Plugin Installation Instructions
 287
 288 This plugin is pre-installed with your TWiki release. You should not have to install it other than to do an upgrade.
 289
 290 - Download the ZIP file from the Plugin web (see below)
 291 - Unzip <code>**%TOPIC%.zip**</code> in your twiki installation directory. Content: <table border="1" cellpadding="0" cellspacing="0" style="border-width: 1px">
 292   <tr>
 293     <th bgcolor="#6b7f93" maxcols="0" style=""><a href="http://localhost?sortcol=0;table=5;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#ffffff">File:</font></a></th>
 294     <th bgcolor="#6b7f93" maxcols="0" style=""><a href="http://localhost?sortcol=1;table=5;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#ffffff">Description:</font></a></th>
 295   </tr>
 296   <tr>
 297     <td bgcolor="#ecf2f8" style=""><code><b>data/TWiki/%TOPIC%.txt</b></code></td>
 298     <td bgcolor="#ecf2f8" style=""> Plugin topic </td>
 299   </tr>
 300   <tr>
 301     <td bgcolor="#ffffff" style=""><code><b>data/TWiki/%TOPIC%.txt,v</b></code></td>
 302     <td bgcolor="#ffffff" style=""> Plugin topic repository </td>
 303   </tr>
 304   <tr>
 305     <td bgcolor="#ecf2f8" style=""><code><b>lib/TWiki/Plugins/%TOPIC%.pm</b></code></td>
 306     <td bgcolor="#ecf2f8" style=""> Plugin Perl module </td>
 307   </tr>
 308   <tr>
 309     <td bgcolor="#ffffff" style=""><code><b>pub/TWiki/%TOPIC%/diamond.gif</b></code></td>
 310     <td bgcolor="#ffffff" style=""> Diamond symbol </td>
 311   </tr>
 312   <tr>
 313     <td bgcolor="#ecf2f8" style=""><code><b>pub/TWiki/%TOPIC%/down.gif</b></code></td>
 314     <td bgcolor="#ecf2f8" style=""> Down arrow </td>
 315   </tr>
 316   <tr>
 317     <td bgcolor="#ffffff" style=""><code><b>pub/TWiki/%TOPIC%/up.gif</b></code></td>
 318     <td bgcolor="#ffffff" style=""> Up arrow </td>
 319   </tr>
 320 </table>
 321 - (Dakar) Visit `configure` in your TWiki installation, and enable the plugin in the \{Plugins\} section.
 322 - Test if the plugin is correctly installed:
 323   - Check above example if the table renders as expected
 324   - Try click on heading to sort. Other tables should also be sortable
 325
 326 ## <a name="Plugin Info"></a> Plugin Info
 327
 328 <table border="1" cellpadding="0" cellspacing="0" style="border-width: 1px">
 329   <tr>
 330     <td align="right" bgcolor="#ecf2f8" style=""> Plugin Author: </td>
 331     <td bgcolor="#ecf2f8" style=""> TWiki:Main/JohnTalintyre, TWiki:Main/PeterThoeny </td>
 332   </tr>
 333   <tr>
 334     <td align="right" bgcolor="#ffffff" style=""> Plugin Version: </td>
 335     <td bgcolor="#ffffff" style=""> 1.014 </td>
 336   </tr>
 337   <tr>
 338     <td align="right" bgcolor="#ecf2f8" style=""> Change History: </td>
 339     <td bgcolor="#ecf2f8" style="">  </td>
 340   </tr>
 341   <tr>
 342     <td align="right" bgcolor="#ffffff" style=""> 13 Dec 2005 </td>
 343     <td bgcolor="#ffffff" style=""> AC: Added support for id, summary and caption </td>
 344   </tr>
 345   <tr>
 346     <td align="right" bgcolor="#ecf2f8" style=""> 5 Mar 2005 </td>
 347     <td bgcolor="#ecf2f8" style=""> 1.014: Crawford Currie eliminated deprecated handlers for Dakar </td>
 348   </tr>
 349   <tr>
 350     <td align="right" bgcolor="#ffffff" style=""> 01 Aug 2004: </td>
 351     <td bgcolor="#ffffff" style=""> AC: Added CSS support for first column and ascending/descending table headers </td>
 352   </tr>
 353   <tr>
 354     <td align="right" bgcolor="#ecf2f8" style=""> 21 Mar 2004: </td>
 355     <td bgcolor="#ecf2f8" style=""> PTh: Internal change: Fixed reference to unofficial variable </td>
 356   </tr>
 357   <tr>
 358     <td align="right" bgcolor="#ffffff" style=""> 01 Jan 2004: </td>
 359     <td bgcolor="#ffffff" style=""> PTh: Alternating data row colors restart again after each header row </td>
 360   </tr>
 361   <tr>
 362     <td align="right" bgcolor="#ecf2f8" style=""> 01 Dec 2003: </td>
 363     <td bgcolor="#ecf2f8" style=""> PTh: Fixed error when footerrows was specified on an empty table, contributed by TWiki:Main/PaulineCheung </td>
 364   </tr>
 365   <tr>
 366     <td align="right" bgcolor="#ffffff" style=""> 24 May 2003: </td>
 367     <td bgcolor="#ffffff" style=""> PTh: New <code>|^|</code> rule for multi row span (TWiki:Main/WalterMundt); added tableframe and tablerules (TWiki:Main/JohannesMartin); ignore columnwidths for multi column span; validate headerrows and footerrows (TWiki:Main/DarrylGreen); fixed link color problem and up/down icon color problem for dark header background </td>
 368   </tr>
 369   <tr>
 370     <td align="right" bgcolor="#ecf2f8" style=""> 17 Dec 2002: </td>
 371     <td bgcolor="#ecf2f8" style=""> PTh: Removed individual table Plugin settings; added TABLEATTRIBUTES Plugins setting and TABLEATTRIBUTES preferences setting </td>
 372   </tr>
 373   <tr>
 374     <td align="right" bgcolor="#ffffff" style=""> 15 Dec 2002: </td>
 375     <td bgcolor="#ffffff" style=""> PTh: Added headerrows and footerrows params (TWiki:Main/DarrylGreen, TWiki:Main/WoutMertens); added tablewidth and columnwidths params (TWiki:Main/ThorstenSommermann) </td>
 376   </tr>
 377   <tr>
 378     <td align="right" bgcolor="#ecf2f8" style=""> 09 Dec 2002: </td>
 379     <td bgcolor="#ecf2f8" style=""> PTh: Added headercolor and datacolor parameters </td>
 380   </tr>
 381   <tr>
 382     <td align="right" bgcolor="#ffffff" style=""> 05 Jun 2002: </td>
 383     <td bgcolor="#ffffff" style=""> PTh: Added "none" value to databg parameter (suggested by TWiki:Main/TaitCyrus); fixed sorting by stripping HTML tags, removing links and making sort ignore case (suggested by TWiki:Main/ShawnBradford) </td>
 384   </tr>
 385   <tr>
 386     <td align="right" bgcolor="#ecf2f8" style=""> 13 Mar 2002: </td>
 387     <td bgcolor="#ecf2f8" style=""> PTh: Added TWiki:Main/ShawnBradford 's initsort and initdirection </td>
 388   </tr>
 389   <tr>
 390     <td align="right" bgcolor="#ffffff" style=""> 12 Mar 2002: </td>
 391     <td bgcolor="#ffffff" style=""> PTh: Added valign, headeralign and dataalign; fixed bug of swapped cellpadding/cellspacing; fixed warning of uninitialized value </td>
 392   </tr>
 393   <tr>
 394     <td align="right" bgcolor="#ecf2f8" style=""> 05 Jan 2002: </td>
 395     <td bgcolor="#ecf2f8" style=""> PTh: Fixed sorting bug of cells with leading white space </td>
 396   </tr>
 397   <tr>
 398     <td align="right" bgcolor="#ffffff" style=""> 06 Dec 2001: </td>
 399     <td bgcolor="#ffffff" style=""> PTh: Fixed date sorting bug <br /> 03 Dec 2001 PTh: Fixed sort="off" bug and more </td>
 400   </tr>
 401   <tr>
 402     <td align="right" bgcolor="#ecf2f8" style=""> 29 Nov 2001: </td>
 403     <td bgcolor="#ecf2f8" style=""> PTh: Fixed Perl warnings </td>
 404   </tr>
 405   <tr>
 406     <td align="right" bgcolor="#ffffff" style=""> 16 Nov 2001: </td>
 407     <td bgcolor="#ffffff" style=""> PTh: Added table border, cell spacing, cell padding, gif files </td>
 408   </tr>
 409   <tr>
 410     <td align="right" bgcolor="#ecf2f8" style=""> 07 Oct 2001: </td>
 411     <td bgcolor="#ecf2f8" style=""> JT: Initial version </td>
 412   </tr>
 413   <tr>
 414     <td align="right" bgcolor="#ffffff" style=""> CPAN Dependencies: </td>
 415     <td bgcolor="#ffffff" style=""> none </td>
 416   </tr>
 417   <tr>
 418     <td align="right" bgcolor="#ecf2f8" style=""> Other Dependencies: </td>
 419     <td bgcolor="#ecf2f8" style=""> none </td>
 420   </tr>
 421   <tr>
 422     <td align="right" bgcolor="#ffffff" style=""> Perl Version: </td>
 423     <td bgcolor="#ffffff" style=""> 5.0 </td>
 424   </tr>
 425   <tr>
 426     <td align="right" bgcolor="#ecf2f8" style=""> Plugin Home: </td>
 427     <td bgcolor="#ecf2f8" style=""><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td>
 428   </tr>
 429   <tr>
 430     <td align="right" bgcolor="#ffffff" style=""> Feedback: </td>
 431     <td bgcolor="#ffffff" style=""><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a></td>
 432   </tr>
 433 </table>
 434
 435 **_Related Topics:_** [[TWikiPreferences]], [[TWikiPlugins]], [[StandardColors]]