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 YYYY - hh:mm (MMM is Jan, Feb, etc.)
  22   - dd-MMM-YY or dd-MMM-YYYY (can be / or space in place of -) (MMM is Jan, Feb, etc)
  23 - number is digits, with optional decimal point
  24 - otherwise treated as text
  25
  26 ## <a name="Row spans"></a> Row spans
  27
  28 Table cells with a single caret indicate follow-up rows of multi-row spans. For example,
  29
  30 <table width="100%">
  31   <tr>
  32     <td><pre>
  33 | One One | One Two | One Three |
  34 | ^ | Two Two | Two Three |
  35 | Three One | ^ | Three Three |
  36 </pre></td>
  37     <td align="right">
  38       <table border="1" cellpadding="0" cellspacing="0" style="border-width: 1px">
  39         <tr>
  40           <td bgcolor="#ecf2f8" rowspan="2" style=""> One One </td>
  41           <td bgcolor="#ecf2f8" style=""> One Two </td>
  42           <td bgcolor="#ecf2f8" style=""> One Three </td>
  43         </tr>
  44         <tr>
  45           <td bgcolor="#ffffff" rowspan="2" style=""> Two Two </td>
  46           <td bgcolor="#ffffff" style=""> Two Three </td>
  47         </tr>
  48         <tr>
  49           <td bgcolor="#ecf2f8" style=""> Three One </td>
  50           <td bgcolor="#ecf2f8" style=""> Three Three </td>
  51         </tr>
  52       </table>
  53     </td>
  54   </tr>
  55 </table>
  56
  57 ## <a name="%TOPIC% Global Settings"></a> %TOPIC% Global Settings
  58
  59 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>
  60
  61 - One line description, shown in the [[TextFormattingRules]] topic:
  62   - Set SHORTDESCRIPTION = Control attributes of tables and sorting of table columns
  63
  64 - Set DEBUG to 1 to get debug messages in `data/debug.txt`. Default: `0`
  65   - Set DEBUG = 0
  66
  67 - 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`.
  68   - #Set SORT = none
  69   - Set SORT = all
  70
  71 - Default table attributes:
  72   - Set TABLEATTRIBUTES = tableborder="1" cellpadding="0" cellspacing="0" valign="top" headercolor="#ffffff" headerbg="#687684" headerbgsorted="#334455" databg="#ffffff,#edf4f9" databgsorted="#f1f7fc,#ddebf6" tablerules="rows"
  73
  74 ## <a name="Table Attributes"></a> Table Attributes
  75
  76 Attributes are defined as a `TABLEATTRIBUTES` Plugin setting in this topic, a `TABLEATTRIBUTES` preferences setting, or on line before the table using `%TABLE{...}%`:
  77
  78 The `%TABLE{...}%` settings override `TABLEATTRIBUTES` preferences settings, which override the `TABLEATTRIBUTES` Plugin settings.
  79
  80 The setting `disableallsort` is normally not used as a TABLE or TABLEATTRIBUTES setting. Plugins such as [[EditTablePlugin]] dynamically sets `disableallsort` to disable sorting while editing a table. For this to work it is important that [[EditTablePlugin]] runs before [[TablePlugin]], which is the default. The setting `sort` can be overwritten by a URL parameter or hidden formfield of the same name. Plugins such as [[EditTablePlugin]] can use this to disable table header sorting while in edit mode.
  81
  82 ## <a name="Examples"></a> Examples
  83
  84 ### <a name="Use of %TABLE{...}%"></a> Use of %TABLE\{...\}%
  85
  86 Line before table: `%TABLE{ sort="on" tableborder="0" cellpadding="4" cellspacing="3" cellborder="0" headerbg="#D5CCB1" headercolor="#666666" databg="#FAF0D4, #F3DFA8" headerrows="2" footerrows="1" }%`
  87
  88 <table border="0" cellpadding="4" cellspacing="3" style="border-width: 0px">
  89   <tr>
  90     <th bgcolor="#D5CCB1" colspan="6" maxcols="0" style="border-width: 0px"><span><font color="#666666"> <strong> Table with two Header Rows and Footer Row </strong> </font></span></th>
  91   </tr>
  92   <tr>
  93     <th bgcolor="#D5CCB1" maxcols="0" style="border-width: 0px"><a href="http://localhost?sortcol=0;table=2;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#666666">Num</font></a></th>
  94     <th bgcolor="#D5CCB1" maxcols="0" style="border-width: 0px"><a href="http://localhost?sortcol=1;table=2;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#666666">Status</font></a></th>
  95     <th bgcolor="#D5CCB1" maxcols="0" style="border-width: 0px"><a href="http://localhost?sortcol=2;table=2;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#666666">Action</font></a></th>
  96     <th bgcolor="#D5CCB1" maxcols="0" style="border-width: 0px"><a href="http://localhost?sortcol=3;table=2;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#666666">Who</font></a></th>
  97     <th bgcolor="#D5CCB1" maxcols="0" style="border-width: 0px"><a href="http://localhost?sortcol=4;table=2;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#666666">When</font></a></th>
  98     <th bgcolor="#D5CCB1" maxcols="0" style="border-width: 0px"><a href="http://localhost?sortcol=5;table=2;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#666666">Progress</font></a></th>
  99   </tr>
 100   <tr>
 101     <td bgcolor="#FAF0D4" style="border-width: 0px"> 1 </td>
 102     <td bgcolor="#FAF0D4" style="border-width: 0px"> C </td>
 103     <td bgcolor="#FAF0D4" style="border-width: 0px"> Chose new colours </td>
 104     <td bgcolor="#FAF0D4" style="border-width: 0px"> John </td>
 105     <td bgcolor="#FAF0D4" style="border-width: 0px"> 1-Dec-02 </td>
 106     <td bgcolor="#FAF0D4" style="border-width: 0px">   </td>
 107   </tr>
 108   <tr>
 109     <td bgcolor="#F3DFA8" style="border-width: 0px"> 2 </td>
 110     <td bgcolor="#F3DFA8" style="border-width: 0px"> X </td>
 111     <td bgcolor="#F3DFA8" style="border-width: 0px"> Release </td>
 112     <td bgcolor="#F3DFA8" style="border-width: 0px"> John </td>
 113     <td bgcolor="#F3DFA8" style="border-width: 0px"> 1-Apr-02 </td>
 114     <td bgcolor="#F3DFA8" style="border-width: 0px">   </td>
 115   </tr>
 116   <tr>
 117     <td bgcolor="#FAF0D4" style="border-width: 0px"> 3 </td>
 118     <td bgcolor="#FAF0D4" style="border-width: 0px">   </td>
 119     <td bgcolor="#FAF0D4" style="border-width: 0px"> Get feedback </td>
 120     <td bgcolor="#FAF0D4" style="border-width: 0px"> Anne </td>
 121     <td bgcolor="#FAF0D4" style="border-width: 0px"> 1-Feb-02 </td>
 122     <td bgcolor="#FAF0D4" style="border-width: 0px">   </td>
 123   </tr>
 124   <tr>
 125     <td bgcolor="#F3DFA8" style="border-width: 0px"> 12 </td>
 126     <td bgcolor="#F3DFA8" style="border-width: 0px"> C </td>
 127     <td bgcolor="#F3DFA8" style="border-width: 0px"> Spec error handling </td>
 128     <td bgcolor="#F3DFA8" style="border-width: 0px"> Jack </td>
 129     <td bgcolor="#F3DFA8" style="border-width: 0px"> 1-Dec-02 </td>
 130     <td bgcolor="#F3DFA8" style="border-width: 0px">   </td>
 131   </tr>
 132   <tr>
 133     <td bgcolor="#FAF0D4" style="border-width: 0px"> 5 </td>
 134     <td bgcolor="#FAF0D4" style="border-width: 0px">   </td>
 135     <td bgcolor="#FAF0D4" style="border-width: 0px"> Abc </td>
 136     <td bgcolor="#FAF0D4" style="border-width: 0px"> John </td>
 137     <td bgcolor="#FAF0D4" style="border-width: 0px">   </td>
 138     <td bgcolor="#FAF0D4" style="border-width: 0px">   </td>
 139   </tr>
 140   <tr>
 141     <th bgcolor="#D5CCB1" maxcols="0" style="border-width: 0px"><span><font color="#666666"> <strong> Num </strong> </font></span></th>
 142     <th bgcolor="#D5CCB1" maxcols="0" style="border-width: 0px"><span><font color="#666666"> <strong> Status </strong> </font></span></th>
 143     <th bgcolor="#D5CCB1" maxcols="0" style="border-width: 0px"><span><font color="#666666"> <strong> Action </strong> </font></span></th>
 144     <th bgcolor="#D5CCB1" maxcols="0" style="border-width: 0px"><span><font color="#666666"> <strong> Who </strong> </font></span></th>
 145     <th bgcolor="#D5CCB1" maxcols="0" style="border-width: 0px"><span><font color="#666666"> <strong> When </strong> </font></span></th>
 146     <th bgcolor="#D5CCB1" maxcols="0" style="border-width: 0px"><span><font color="#666666"> <strong> Progress </strong> </font></span></th>
 147   </tr>
 148 </table>
 149
 150 ### <a name="Table with 4 digit year dates an"></a> Table with 4 digit year dates and no use of %TABLE\{...\}%
 151
 152 <table border="1" cellpadding="0" cellspacing="0" style="border-width: 1px">
 153   <tr>
 154     <th bgcolor="#6b7f93" maxcols="0" style=""><a href="http://localhost?sortcol=0;table=3;up=0#sorted_table" rel="nofollow" title="Sort by this column"><font color="#ffffff">When</font></a></th>
 155   </tr>
 156   <tr>
 157     <td bgcolor="#ecf2f8" style=""> 1-Jan-2004 </td>
 158   </tr>
 159   <tr>
 160     <td bgcolor="#ffffff" style=""> 1-Jan-2003 </td>
 161   </tr>
 162   <tr>
 163     <td bgcolor="#ecf2f8" style=""> 2-Jan-2005 </td>
 164   </tr>
 165 </table>
 166
 167 ## <a name="TablePlugin and CSS"></a><a name="_TablePlugin and CSS"></a> TablePlugin and CSS
 168
 169 Information for programmers.
 170
 171 TablePlugin implements the following precedence:
 172
 173 - the `TABLEATTRIBUTE` settings only write html styling, no CSS
 174 - the `TABLEATTRIBUTE` settings can be overridden by a skin's CSS
 175 - the `TABLE` tag attributes are converted to CSS styling, written in the head; these override any skin's CSS
 176
 177 ### <a name="CSS written by _TablePlugin"></a> CSS written by TablePlugin
 178
 179 <table border="1" cellpadding="0" cellspacing="0" style="border-width: 1px">
 180   <tr>
 181     <td bgcolor="#ecf2f8" style=""><code>.twikiTable</code></td>
 182     <td bgcolor="#ecf2f8" style=""> The table </td>
 183   </tr>
 184   <tr>
 185     <td bgcolor="#ffffff" style=""><code>.twikiSortedCol</code></td>
 186     <td bgcolor="#ffffff" style=""> A sorted column </td>
 187   </tr>
 188   <tr>
 189     <td bgcolor="#ecf2f8" style=""><code>.twikiSortedAscendingCol</code></td>
 190     <td bgcolor="#ecf2f8" style=""> Sorted column, ascending </td>
 191   </tr>
 192   <tr>
 193     <td bgcolor="#ffffff" style=""><code>.twikiSortedDescendingCol</code></td>
 194     <td bgcolor="#ffffff" style=""> Sorted column, descending </td>
 195   </tr>
 196   <tr>
 197     <td bgcolor="#ecf2f8" style=""><code>.tableSortIcon</code></td>
 198     <td bgcolor="#ecf2f8" style=""> The sort icon holder (span) </td>
 199   </tr>
 200   <tr>
 201     <td bgcolor="#ffffff" style=""><code>.twikiFirstCol</code></td>
 202     <td bgcolor="#ffffff" style=""> The first column </td>
 203   </tr>
 204   <tr>
 205     <td bgcolor="#ecf2f8" style=""><code>.twikiTableEven</code></td>
 206     <td bgcolor="#ecf2f8" style=""> Even numbered rows </td>
 207   </tr>
 208   <tr>
 209     <td bgcolor="#ffffff" style=""><code>.twikiTableOdd</code></td>
 210     <td bgcolor="#ffffff" style=""> Odd numbered rows </td>
 211   </tr>
 212   <tr>
 213     <td bgcolor="#ecf2f8" style=""><code>.twikiTableCol</code> + column number </td>
 214     <td bgcolor="#ecf2f8" style=""> Unique column identifier, for instance: <code>twikiTableCol0</code></td>
 215   </tr>
 216   <tr>
 217     <td bgcolor="#ffffff" style=""><code>.twikiTableRow</code> + type + row number </td>
 218     <td bgcolor="#ffffff" style=""> Unique row identifier, for instance: <code>twikiTableRowdataBg0</code></td>
 219   </tr>
 220 </table>
 221
 222 ## <a name="Plugin Installation Instructions"></a> Plugin Installation Instructions
 223
 224 This plugin is pre-installed with your TWiki release. You should not have to install it other than to do an upgrade.
 225
 226 - Download the ZIP file from the Plugin web (see below)
 227 - Unzip <code>**%TOPIC%.zip**</code> in your twiki installation directory. Content: <table border="1" cellpadding="0" cellspacing="0" style="border-width: 1px">
 228   <tr>
 229     <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>
 230     <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>
 231   </tr>
 232   <tr>
 233     <td bgcolor="#ecf2f8" style=""><code><b>data/TWiki/%TOPIC%.txt</b></code></td>
 234     <td bgcolor="#ecf2f8" style=""> Plugin topic </td>
 235   </tr>
 236   <tr>
 237     <td bgcolor="#ffffff" style=""><code><b>lib/TWiki/Plugins/%TOPIC%.pm</b></code></td>
 238     <td bgcolor="#ffffff" style=""> Plugin Perl module </td>
 239   </tr>
 240   <tr>
 241     <td bgcolor="#ecf2f8" style=""><code><b>lib/TWiki/Plugins/%TOPIC%/Core.pm</b></code></td>
 242     <td bgcolor="#ecf2f8" style=""> Plugin Perl module </td>
 243   </tr>
 244 </table>
 245 - (Dakar) Visit `configure` in your TWiki installation, and enable the plugin in the \{Plugins\} section.
 246 - Test if the plugin is correctly installed:
 247   - Check above example if the table renders as expected
 248   - Try click on heading to sort. Other tables should also be sortable
 249
 250 ## <a name="Plugin Info"></a> Plugin Info
 251
 252 <table border="1" cellpadding="0" cellspacing="0" style="border-width: 1px">
 253   <tr>
 254     <td align="right" bgcolor="#ecf2f8" style=""> Plugin Author: </td>
 255     <td bgcolor="#ecf2f8" style=""> TWiki:Main/JohnTalintyre, TWiki:Main/PeterThoeny </td>
 256   </tr>
 257   <tr>
 258     <td align="right" bgcolor="#ffffff" style=""> Copyright: </td>
 259     <td bgcolor="#ffffff" style=""> © 2001-2008, TWiki:Main/JohnTalintyre, <a href="mailto:Peter@Thoeny.org">Peter@Thoeny.org</a> (<a href="http://www.twiki.net/" target="_top">TWIKI.NET</a>), TWiki Contributors </td>
 260   </tr>
 261   <tr>
 262     <td align="right" bgcolor="#ecf2f8" style=""> License: </td>
 263     <td bgcolor="#ecf2f8" style=""> GPL (<a href="http://www.gnu.org/copyleft/gpl.html" target="_top">GNU General Public License</a>) </td>
 264   </tr>
 265   <tr>
 266     <td align="right" bgcolor="#ffffff" style=""> Plugin Version: </td>
 267     <td bgcolor="#ffffff" style=""> 1.034 (03 Aug 2008) </td>
 268   </tr>
 269   <tr>
 270     <td align="right" bgcolor="#ecf2f8" style=""> Change History: </td>
 271     <td bgcolor="#ecf2f8" style="">  </td>
 272   </tr>
 273   <tr>
 274     <td align="right" bgcolor="#ffffff" style=""> 03 Aug 2008 </td>
 275     <td bgcolor="#ffffff" style=""> 1.034 TWiki 4.2.1 release version </td>
 276   </tr>
 277   <tr>
 278     <td align="right" bgcolor="#ecf2f8" style=""> 20 Mar 2008 </td>
 279     <td bgcolor="#ecf2f8" style=""> 1.033 TWikibug:Item5387: allow rowspanned columns to contain HTML tags; otherwise it is impossible to add an invisible anchor to a rowspanned cell </td>
 280   </tr>
 281   <tr>
 282     <td align="right" bgcolor="#ffffff" style=""> 16 Dec 2007 </td>
 283     <td bgcolor="#ffffff" style=""> 1.030: Kenneth Lavrsen: Fixed the problem of tables being sorted by by [[Main/TablePlugin]] while the table is being edited by plugins such as [[Main/EditTablePlugin]]. This required adding a new attribute <code>disableallsort</code> so plugins such as [[Main/EditTablePlugin]] can temporarily disable all sorting for a table. Additionally the CGI variable (URL parameter or hidden formfield) <code>sort</code> can be set to "off" which disables all header sorting in the topic. This is used by plugins such as [[Main/EditTablePlugin]] to disable the sorting by clicking header fields during editing of tables. Ref: TWikibug:Item5135 and TWikibug:Item2690. </td>
 284   </tr>
 285   <tr>
 286     <td align="right" bgcolor="#ecf2f8" style=""> 03 Dec 2007 </td>
 287     <td bgcolor="#ecf2f8" style=""> Arthur Clemens: Fixed rendering and order of html elements <code>thead</code>, <code>tfoot</code> and <code>tbody</code>; corrected <code>id</code> parameter. </td>
 288   </tr>
 289   <tr>
 290     <td align="right" bgcolor="#ffffff" style=""> 24 Nov 2007 </td>
 291     <td bgcolor="#ffffff" style=""> Arthur Clemens: Fixed sorting of columns with only icons; also removed TWiki formatting before sorting. </td>
 292   </tr>
 293   <tr>
 294     <td align="right" bgcolor="#ecf2f8" style=""> 06 Oct 2007 </td>
 295     <td bgcolor="#ecf2f8" style=""> 15180: PTh: Added [[TWiki/VarTABLE]] to have it listed in [[TWiki/TWikiVariables]]</td>
 296   </tr>
 297   <tr>
 298     <td align="right" bgcolor="#ffffff" style=""> 27 Jun 2007 </td>
 299     <td bgcolor="#ffffff" style=""> 1.024 - 1.027 Various small bug fixes. </td>
 300   </tr>
 301   <tr>
 302     <td align="right" bgcolor="#ecf2f8" style=""> 24 Jun 2007 </td>
 303     <td bgcolor="#ecf2f8" style=""> 1.023: Arthur Clemens: Inline styles are now written to the head; updated default sort icons (from [[TWiki/TWikiDocGraphics]]). </td>
 304   </tr>
 305   <tr>
 306     <td align="right" bgcolor="#ffffff" style=""> 23 Jun 2007 </td>
 307     <td bgcolor="#ffffff" style=""> 1.022: Arthur Clemens: Fixed styling of param <code>tablerules</code> on Internet Explorer. </td>
 308   </tr>
 309   <tr>
 310     <td align="right" bgcolor="#ecf2f8" style=""> 23 May 2007 </td>
 311     <td bgcolor="#ecf2f8" style=""> 1.021: Michael Daum: Fixed css attribute priority to cooperate nicely with skin themes. </td>
 312   </tr>
 313   <tr>
 314     <td align="right" bgcolor="#ffffff" style=""> 27 Dec 2006 </td>
 315     <td bgcolor="#ffffff" style=""> 1.020: Kenneth Lavrsen: Fixed initsort so all tables can be initsorted and not only the first. When you sort a table by clicking on the header of a column the table gets sorted accordingly. When you click the header of another table the previously sorted table goes back being sorted as specified by initsort. </td>
 316   </tr>
 317   <tr>
 318     <td align="right" bgcolor="#ecf2f8" style=""> 13 Dec 2006 </td>
 319     <td bgcolor="#ecf2f8" style=""> 1.019: Arthur Clemens: Prevent sorting of columns that do no exist. </td>
 320   </tr>
 321   <tr>
 322     <td align="right" bgcolor="#ffffff" style=""> 02 Dec 2006 </td>
 323     <td bgcolor="#ffffff" style=""> 1.018: Arthur Clemens: Data rows now start with first <code>datacolor</code> and <code>databgcolor</code>. </td>
 324   </tr>
 325   <tr>
 326     <td align="right" bgcolor="#ecf2f8" style=""> 26 Nov 2006 </td>
 327     <td bgcolor="#ecf2f8" style=""> 1.017: Arthur Clemens: Better support for <code>tablerules</code>. </td>
 328   </tr>
 329   <tr>
 330     <td align="right" bgcolor="#ffffff" style=""> 24 Nov 2006 </td>
 331     <td bgcolor="#ffffff" style=""> 1.016: Arthur Clemens: Added new attribute <code>cellborder</code>. </td>
 332   </tr>
 333   <tr>
 334     <td align="right" bgcolor="#ecf2f8" style=""> 25 Oct 2006 </td>
 335     <td bgcolor="#ecf2f8" style=""> 1.015: Arthur Clemens: Added support for background colors of sorted column. Columns can be unsorted - sorting order is now: sort ascending, sort descending, unsort. Added attributes <code>headervalign</code> and <code>datavalign</code>. </td>
 336   </tr>
 337   <tr>
 338     <td align="right" bgcolor="#ffffff" style=""> 16 Aug 2006 </td>
 339     <td bgcolor="#ffffff" style=""> Michael Daum: Added CSS support for even/odd table rows </td>
 340   </tr>
 341   <tr>
 342     <td align="right" bgcolor="#ecf2f8" style=""> 13 Dec 2005 </td>
 343     <td bgcolor="#ecf2f8" style=""> Arthur Clemens: Added support for <code>id</code>, <code>summary</code> and <code>caption</code></td>
 344   </tr>
 345   <tr>
 346     <td align="right" bgcolor="#ffffff" style=""> 05 Mar 2005 </td>
 347     <td bgcolor="#ffffff" style=""> 1.014: Crawford Currie eliminated deprecated handlers for Dakar </td>
 348   </tr>
 349   <tr>
 350     <td align="right" bgcolor="#ecf2f8" style=""> 01 Aug 2004 </td>
 351     <td bgcolor="#ecf2f8" style=""> Arthur Clemens: Added CSS support for first column and ascending/descending table headers </td>
 352   </tr>
 353   <tr>
 354     <td align="right" bgcolor="#ffffff" style=""> 21 Mar 2004 </td>
 355     <td bgcolor="#ffffff" style=""> PTh: Internal change: Fixed reference to unofficial variable </td>
 356   </tr>
 357   <tr>
 358     <td align="right" bgcolor="#ecf2f8" style=""> 01 Jan 2004 </td>
 359     <td bgcolor="#ecf2f8" style=""> PTh: Alternating data row colors restart again after each header row </td>
 360   </tr>
 361   <tr>
 362     <td align="right" bgcolor="#ffffff" style=""> 01 Dec 2003 </td>
 363     <td bgcolor="#ffffff" 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="#ecf2f8" style=""> 24 May 2003 </td>
 367     <td bgcolor="#ecf2f8" 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="#ffffff" style=""> 17 Dec 2002 </td>
 371     <td bgcolor="#ffffff" 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="#ecf2f8" style=""> 15 Dec 2002 </td>
 375     <td bgcolor="#ecf2f8" 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="#ffffff" style=""> 09 Dec 2002 </td>
 379     <td bgcolor="#ffffff" style=""> PTh: Added headercolor and datacolor parameters </td>
 380   </tr>
 381   <tr>
 382     <td align="right" bgcolor="#ecf2f8" style=""> 05 Jun 2002 </td>
 383     <td bgcolor="#ecf2f8" 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="#ffffff" style=""> 13 Mar 2002 </td>
 387     <td bgcolor="#ffffff" style=""> PTh: Added TWiki:Main/ShawnBradford 's initsort and initdirection </td>
 388   </tr>
 389   <tr>
 390     <td align="right" bgcolor="#ecf2f8" style=""> 12 Mar 2002 </td>
 391     <td bgcolor="#ecf2f8" 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="#ffffff" style=""> 05 Jan 2002 </td>
 395     <td bgcolor="#ffffff" style=""> PTh: Fixed sorting bug of cells with leading white space </td>
 396   </tr>
 397   <tr>
 398     <td align="right" bgcolor="#ecf2f8" style=""> 06 Dec 2001 </td>
 399     <td bgcolor="#ecf2f8" 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="#ffffff" style=""> 29 Nov 2001 </td>
 403     <td bgcolor="#ffffff" style=""> PTh: Fixed Perl warnings </td>
 404   </tr>
 405   <tr>
 406     <td align="right" bgcolor="#ecf2f8" style=""> 16 Nov 2001 </td>
 407     <td bgcolor="#ecf2f8" style=""> PTh: Added table border, cell spacing, cell padding, gif files </td>
 408   </tr>
 409   <tr>
 410     <td align="right" bgcolor="#ffffff" style=""> 07 Oct 2001 </td>
 411     <td bgcolor="#ffffff" style=""> JT: Initial version </td>
 412   </tr>
 413   <tr>
 414     <td align="right" bgcolor="#ecf2f8" style=""> CPAN Dependencies: </td>
 415     <td bgcolor="#ecf2f8" style=""> none </td>
 416   </tr>
 417   <tr>
 418     <td align="right" bgcolor="#ffffff" style=""> Other Dependencies: </td>
 419     <td bgcolor="#ffffff" style=""> none </td>
 420   </tr>
 421   <tr>
 422     <td align="right" bgcolor="#ecf2f8" style=""> Perl Version: </td>
 423     <td bgcolor="#ecf2f8" style=""> 5.0 </td>
 424   </tr>
 425   <tr>
 426     <td align="right" bgcolor="#ffffff" style=""> Plugin Home: </td>
 427     <td bgcolor="#ffffff" 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="#ecf2f8" style=""> Feedback: </td>
 431     <td bgcolor="#ecf2f8" 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   <tr>
 434     <td align="right" bgcolor="#ffffff" style=""> Appraisal: </td>
 435     <td bgcolor="#ffffff" style=""><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Appraisal" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Appraisal</a></td>
 436   </tr>
 437 </table>
 438
 439 **_Related Topics:_** [[TWikiPreferences]], [[TWikiPlugins]], [[StandardColors]]