data/TWiki/TablePlugin.txt,v
author Colas Nahaboo <colas@nahaboo.net>
Sat, 26 Jan 2008 15:50:53 +0100
changeset 0 414e01d06fd5
child 1 e2915a7cbdfa
permissions -rw-r--r--
RELEASE 4.2.0 freetown
colas@0
     1
head	1.26;
colas@0
     2
access;
colas@0
     3
symbols;
colas@0
     4
locks; strict;
colas@0
     5
comment	@# @;
colas@0
     6
colas@0
     7
colas@0
     8
1.26
colas@0
     9
date	2008.01.22.03.21.23;	author TWikiContributor;	state Exp;
colas@0
    10
branches;
colas@0
    11
next	1.25;
colas@0
    12
colas@0
    13
1.25
colas@0
    14
date	2007.01.16.04.12.01;	author TWikiContributor;	state Exp;
colas@0
    15
branches;
colas@0
    16
next	1.24;
colas@0
    17
colas@0
    18
1.24
colas@0
    19
date	2006.04.01.05.55.33;	author TWikiContributor;	state Exp;
colas@0
    20
branches;
colas@0
    21
next	1.23;
colas@0
    22
colas@0
    23
1.23
colas@0
    24
date	2006.02.01.12.01.23;	author TWikiContributor;	state Exp;
colas@0
    25
branches;
colas@0
    26
next	1.22;
colas@0
    27
colas@0
    28
1.22
colas@0
    29
date	2004.08.02.05.08.17;	author PeterThoeny;	state Exp;
colas@0
    30
branches;
colas@0
    31
next	1.21;
colas@0
    32
colas@0
    33
1.21
colas@0
    34
date	2004.03.21.09.05.14;	author PeterThoeny;	state Exp;
colas@0
    35
branches;
colas@0
    36
next	1.20;
colas@0
    37
colas@0
    38
1.20
colas@0
    39
date	2004.01.02.03.18.16;	author PeterThoeny;	state Exp;
colas@0
    40
branches;
colas@0
    41
next	1.19;
colas@0
    42
colas@0
    43
1.19
colas@0
    44
date	2003.05.25.10.31.00;	author PeterThoeny;	state Exp;
colas@0
    45
branches;
colas@0
    46
next	1.18;
colas@0
    47
colas@0
    48
1.18
colas@0
    49
date	2003.05.25.03.32.00;	author PeterThoeny;	state Exp;
colas@0
    50
branches;
colas@0
    51
next	1.17;
colas@0
    52
colas@0
    53
1.17
colas@0
    54
date	2003.05.03.07.10.22;	author PeterThoeny;	state Exp;
colas@0
    55
branches;
colas@0
    56
next	1.16;
colas@0
    57
colas@0
    58
1.16
colas@0
    59
date	2002.12.17.22.38.12;	author PeterThoeny;	state Exp;
colas@0
    60
branches;
colas@0
    61
next	1.15;
colas@0
    62
colas@0
    63
1.15
colas@0
    64
date	2002.12.15.09.34.00;	author PeterThoeny;	state Exp;
colas@0
    65
branches;
colas@0
    66
next	1.14;
colas@0
    67
colas@0
    68
1.14
colas@0
    69
date	2002.12.10.00.11.00;	author PeterThoeny;	state Exp;
colas@0
    70
branches;
colas@0
    71
next	1.13;
colas@0
    72
colas@0
    73
1.13
colas@0
    74
date	2002.06.05.06.56.51;	author PeterThoeny;	state Exp;
colas@0
    75
branches;
colas@0
    76
next	1.12;
colas@0
    77
colas@0
    78
1.12
colas@0
    79
date	2002.03.13.06.30.00;	author PeterThoeny;	state Exp;
colas@0
    80
branches;
colas@0
    81
next	1.11;
colas@0
    82
colas@0
    83
1.11
colas@0
    84
date	2002.03.13.02.39.00;	author PeterThoeny;	state Exp;
colas@0
    85
branches;
colas@0
    86
next	1.10;
colas@0
    87
colas@0
    88
1.10
colas@0
    89
date	2002.03.07.22.55.00;	author PeterThoeny;	state Exp;
colas@0
    90
branches;
colas@0
    91
next	1.9;
colas@0
    92
colas@0
    93
1.9
colas@0
    94
date	2002.01.05.08.17.00;	author PeterThoeny;	state Exp;
colas@0
    95
branches;
colas@0
    96
next	1.8;
colas@0
    97
colas@0
    98
1.8
colas@0
    99
date	2001.12.09.09.45.34;	author PeterThoeny;	state Exp;
colas@0
   100
branches;
colas@0
   101
next	1.7;
colas@0
   102
colas@0
   103
1.7
colas@0
   104
date	2001.12.07.07.28.00;	author PeterThoeny;	state Exp;
colas@0
   105
branches;
colas@0
   106
next	1.6;
colas@0
   107
colas@0
   108
1.6
colas@0
   109
date	2001.12.04.02.26.00;	author PeterThoeny;	state Exp;
colas@0
   110
branches;
colas@0
   111
next	1.5;
colas@0
   112
colas@0
   113
1.5
colas@0
   114
date	2001.11.29.08.12.31;	author PeterThoeny;	state Exp;
colas@0
   115
branches;
colas@0
   116
next	1.4;
colas@0
   117
colas@0
   118
1.4
colas@0
   119
date	2001.11.16.09.34.48;	author PeterThoeny;	state Exp;
colas@0
   120
branches;
colas@0
   121
next	1.3;
colas@0
   122
colas@0
   123
1.3
colas@0
   124
date	2001.11.16.03.19.50;	author PeterThoeny;	state Exp;
colas@0
   125
branches;
colas@0
   126
next	1.2;
colas@0
   127
colas@0
   128
1.2
colas@0
   129
date	2001.11.14.03.13.00;	author PeterThoeny;	state Exp;
colas@0
   130
branches;
colas@0
   131
next	1.1;
colas@0
   132
colas@0
   133
1.1
colas@0
   134
date	2001.11.11.09.08.09;	author PeterThoeny;	state Exp;
colas@0
   135
branches;
colas@0
   136
next	;
colas@0
   137
colas@0
   138
colas@0
   139
desc
colas@0
   140
@none
colas@0
   141
@
colas@0
   142
colas@0
   143
colas@0
   144
1.26
colas@0
   145
log
colas@0
   146
@buildrelease
colas@0
   147
@
colas@0
   148
text
colas@0
   149
@%META:TOPICINFO{author="TWikiContributor" date="1191730164" format="1.0" version="26"}%
colas@0
   150
---+ Table Plugin
colas@0
   151
colas@0
   152
Gives extra control of table display:
colas@0
   153
	* Allows sorting
colas@0
   154
	* Changing table properties like border width, cell spacing and cell padding
colas@0
   155
	* Changing background color and text color for header cells
colas@0
   156
	* Changing background color and text color for data cells - colors can _alternate_
colas@0
   157
	* Table attributes can be set and overridden in this order:
colas@0
   158
		* Default =TABLEATTRIBUTES= Plugin setting in this topic.
colas@0
   159
		* A =TABLEATTRIBUTES= preferences setting on site-level (%TWIKIWEB%.TWikiPreferences) or web-level (any WebPreferences), e.g.
colas@0
   160
			* =Set TABLEATTRIBUTES = tableborder="0" cellpadding="1" ...=
colas@0
   161
		* Before a table using =%<nop>TABLE{...}%=
colas@0
   162
   * Row spans
colas@0
   163
colas@0
   164
---++ Sorting
colas@0
   165
colas@0
   166
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:
colas@0
   167
colas@0
   168
	* date if format is:
colas@0
   169
		* dd MMM YYYY - hh:mm (MMM is Jan, Feb, etc.)
colas@0
   170
		* dd-MMM-YY or dd-MMM-YYYY (can be / or space in place of -) (MMM is Jan, Feb, etc)
colas@0
   171
	* number is digits, with optional decimal point
colas@0
   172
	* otherwise treated as text
colas@0
   173
colas@0
   174
---++ Row spans
colas@0
   175
colas@0
   176
Table cells with a single caret indicate follow-up rows of multi-row spans. For example,
colas@0
   177
<table width="100%"><tr><td>
colas@0
   178
<verbatim>
colas@0
   179
| One One | One Two | One Three |
colas@0
   180
| ^ | Two Two | Two Three |
colas@0
   181
| Three One | ^ | Three Three |
colas@0
   182
</verbatim>
colas@0
   183
</td><td align="right">
colas@0
   184
| One One | One Two | One Three |
colas@0
   185
| ^ | Two Two | Two Three |
colas@0
   186
| Three One | ^ | Three Three |
colas@0
   187
</td></tr></table>
colas@0
   188
colas@0
   189
---++ <nop>%TOPIC% Global Settings
colas@0
   190
colas@0
   191
Plugin settings are stored as preferences variables. To reference
colas@0
   192
a plugin setting write ==%<nop>&lt;plugin&gt;_&lt;setting&gt;%==, for example, ==%<nop>INTERWIKIPLUGIN_SHORTDESCRIPTION%==
colas@0
   193
colas@0
   194
	* One line description, shown in the %TWIKIWEB%.TextFormattingRules topic:
colas@0
   195
		* Set SHORTDESCRIPTION = Control attributes of tables and sorting of table columns
colas@0
   196
colas@0
   197
	* Set DEBUG to 1 to get debug messages in =data/debug.txt=.  Default: =0=
colas@0
   198
		* Set DEBUG = 0
colas@0
   199
colas@0
   200
	* 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=.
colas@0
   201
		* #Set SORT = none
colas@0
   202
		* Set SORT = all
colas@0
   203
colas@0
   204
	* Default table attributes:
colas@0
   205
		* Set TABLEATTRIBUTES = tableborder="1" cellpadding="0" cellspacing="0" valign="top" headercolor="#ffffff" headerbg="#687684" headerbgsorted="#334455" databg="#ffffff,#edf4f9" databgsorted="#f1f7fc,#ddebf6" tablerules="rows"
colas@0
   206
colas@0
   207
---++ Table Attributes
colas@0
   208
colas@0
   209
Attributes are defined as a =TABLEATTRIBUTES= Plugin setting in this topic, a =TABLEATTRIBUTES= preferences setting, or on line before the table using =%<nop>TABLE{...}%=:
colas@0
   210
%INCLUDE{"%TWIKIWEB%.VarTABLE" section="table_attributes"}%
colas@0
   211
colas@0
   212
The =%<nop>TABLE{...}%= settings override =TABLEATTRIBUTES= preferences settings, which override the =TABLEATTRIBUTES= Plugin settings. 
colas@0
   213
colas@0
   214
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.
colas@0
   215
colas@0
   216
---++ Examples
colas@0
   217
colas@0
   218
---+++ Use of %<nop>TABLE{...}%
colas@0
   219
colas@0
   220
Line before table: =%<nop>TABLE{ sort="on" tableborder="0" cellpadding="4" cellspacing="3" cellborder="0" headerbg="#D5CCB1" headercolor="#666666" databg="#FAF0D4, #F3DFA8" headerrows="2" footerrows="1" }%=
colas@0
   221
colas@0
   222
%TABLE{ sort="on" tableborder="0" cellpadding="4" cellspacing="3" cellborder="0" headerbg="#D5CCB1" headercolor="#666666" databg="#FAF0D4, #F3DFA8" headerrows="2" footerrows="1" }%
colas@0
   223
| *Table with two Header Rows and Footer Row* ||||||
colas@0
   224
| *Num* | *Status* | *Action* | *Who* | *When* | *Progress* |
colas@0
   225
| 1 | C | Chose new colours | John | 1-Dec-02 | |
colas@0
   226
| 2 | X | Release | John | 1-Apr-02 | |
colas@0
   227
| 3 |	| Get feedback | Anne | 1-Feb-02 | |
colas@0
   228
| 12 | C | Spec error handling | Jack | 1-Dec-02 | |
colas@0
   229
| 5 |	| Abc | John | | |
colas@0
   230
| *Num* | *Status* | *Action* | *Who* | *When* | *Progress* |
colas@0
   231
colas@0
   232
---+++ Table with 4 digit year dates and no use of %<nop>TABLE{...}%
colas@0
   233
colas@0
   234
| *When* |
colas@0
   235
| 1-Jan-2004 |
colas@0
   236
| 1-Jan-2003 |
colas@0
   237
| 2-Jan-2005 |
colas@0
   238
colas@0
   239
colas@0
   240
---++ !TablePlugin and CSS
colas@0
   241
Information for programmers.
colas@0
   242
colas@0
   243
!TablePlugin implements the following precedence:
colas@0
   244
   * the =TABLEATTRIBUTE= settings only write html styling, no CSS
colas@0
   245
   * the =TABLEATTRIBUTE= settings can be overridden by a skin's CSS
colas@0
   246
   * the =TABLE= tag attributes are converted to CSS styling, written in the head; these override any skin's CSS
colas@0
   247
    
colas@0
   248
---+++ CSS written by !TablePlugin
colas@0
   249
|=.twikiTable=  |The table  |
colas@0
   250
|=.twikiSortedCol=  |A sorted column  |
colas@0
   251
|=.twikiSortedAscendingCol=  |Sorted column, ascending  |
colas@0
   252
|=.twikiSortedDescendingCol=  |Sorted column, descending  |
colas@0
   253
|=.tableSortIcon=  |The sort icon holder (span)  |
colas@0
   254
|=.twikiFirstCol=  |The first column  |
colas@0
   255
|=.twikiTableEven= |Even numbered rows  |
colas@0
   256
|=.twikiTableOdd= |Odd numbered rows  |
colas@0
   257
|=.twikiTableCol= + column number  | Unique column identifier, for instance: =twikiTableCol0= |
colas@0
   258
|=.twikiTableRow= + type + row number | Unique row identifier, for instance: =twikiTableRowdataBg0= |
colas@0
   259
colas@0
   260
colas@0
   261
---++ Plugin Installation Instructions
colas@0
   262
This plugin is pre-installed with your TWiki release. You should not have to install it other than to do an upgrade.
colas@0
   263
colas@0
   264
	* Download the ZIP file from the Plugin web (see below)
colas@0
   265
	* Unzip ==%TOPIC%.zip== in your twiki installation directory. Content:
colas@0
   266
	  | *File:* | *Description:* |
colas@0
   267
	  | ==data/TWiki/%TOPIC%.txt== | Plugin topic |
colas@0
   268
	  | ==lib/TWiki/Plugins/%TOPIC%.pm== | Plugin Perl module |
colas@0
   269
	  | ==lib/TWiki/Plugins/%TOPIC%/Core.pm== | Plugin Perl module |
colas@0
   270
	* (Dakar) Visit =configure= in your TWiki installation, and enable the plugin in the {Plugins} section.
colas@0
   271
	* Test if the plugin is correctly installed:
colas@0
   272
		* Check above example if the table renders as expected
colas@0
   273
		* Try click on heading to sort.  Other tables should also be sortable
colas@0
   274
colas@0
   275
---++ Plugin Info
colas@0
   276
colas@0
   277
|  Plugin Author: | TWiki:Main/JohnTalintyre, TWiki:Main/PeterThoeny |
colas@0
   278
|  Copyright: | &copy; 2001-2007, TWiki:Main/JohnTalintyre, Peter@@Thoeny.org ([[http://www.twiki.net/][TWIKI.NET]]), TWiki Contributors |
colas@0
   279
|  License: | GPL ([[http://www.gnu.org/copyleft/gpl.html][GNU General Public License]]) |
colas@0
   280
|  Plugin Version: | 1.032 (22 Dec 2007) |
colas@0
   281
|  Change History: | <!-- specify latest version first -->&nbsp; |
colas@0
   282
|  16 Dec 2007 | 1.030: Kenneth Lavrsen: Fixed the problem of tables being sorted by by TablePlugin while the table is being edited by plugins such as EditTablePlugin. This required adding a new attribute =disableallsort= so plugins such as EditTablePlugin can temporarily disable all sorting for a table. Additionally the CGI variable (URL parameter or hidden formfield) =sort= can be set to "off" which disables all header sorting in the topic. This is used by plugins such as EditTablePlugin to disable the sorting by clicking header fields during editing of tables. Ref: TWikibug:Item5135 and TWikibug:Item2690. |
colas@0
   283
|  03 Dec 2007 | Arthur Clemens: Fixed rendering and order of html elements =thead=, =tfoot= and =tbody=; corrected =id= parameter. |
colas@0
   284
|  24 Nov 2007 | Arthur Clemens: Fixed sorting of columns with only icons; also removed TWiki formatting before sorting. |
colas@0
   285
|  06 Oct 2007 | 15180: PTh: Added %TWIKIWEB%.VarTABLE to have it listed in %TWIKIWEB%.TWikiVariables |
colas@0
   286
|  27 Jun 2007 | 1.024 - 1.027 Various small bug fixes. |
colas@0
   287
|  24 Jun 2007 | 1.023: Arthur Clemens: Inline styles are now written to the head; updated default sort icons (from %TWIKIWEB%.TWikiDocGraphics). |
colas@0
   288
|  23 Jun 2007 | 1.022: Arthur Clemens: Fixed styling of param =tablerules= on Internet Explorer. |
colas@0
   289
|  23 May 2007 | 1.021: Michael Daum: Fixed css attribute priority to cooperate nicely with skin themes. |
colas@0
   290
|  27 Dec 2006 | 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. |
colas@0
   291
|  13 Dec 2006 | 1.019: Arthur Clemens: Prevent sorting of columns that do no exist.  |
colas@0
   292
|  02 Dec 2006 | 1.018: Arthur Clemens: Data rows now start with first =datacolor= and =databgcolor=.  |
colas@0
   293
|  26 Nov 2006 | 1.017: Arthur Clemens: Better support for =tablerules=.  |
colas@0
   294
|  24 Nov 2006 | 1.016: Arthur Clemens: Added new attribute =cellborder=.  |
colas@0
   295
|  25 Oct 2006 | 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 =headervalign= and =datavalign=. |
colas@0
   296
|  16 Aug 2006 | Michael Daum: Added CSS support for even/odd table rows |
colas@0
   297
|  13 Dec 2005 | Arthur Clemens: Added support for =id=, =summary= and =caption= |
colas@0
   298
|  05 Mar 2005 | 1.014: Crawford Currie eliminated deprecated handlers for Dakar |
colas@0
   299
|  01 Aug 2004 | Arthur Clemens: Added CSS support for first column and ascending/descending table headers |
colas@0
   300
|  21 Mar 2004 | PTh: Internal change: Fixed reference to unofficial variable |
colas@0
   301
|  01 Jan 2004 | PTh: Alternating data row colors restart again after each header row |
colas@0
   302
|  01 Dec 2003 | PTh: Fixed error when footerrows was specified on an empty table, contributed by TWiki:Main/PaulineCheung |
colas@0
   303
|  24 May 2003 | PTh: New =&#124;^&#124;= 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 |
colas@0
   304
|  17 Dec 2002 | PTh: Removed individual table Plugin settings; added TABLEATTRIBUTES Plugins setting and TABLEATTRIBUTES preferences setting |
colas@0
   305
|  15 Dec 2002 | PTh: Added headerrows and footerrows params (TWiki:Main/DarrylGreen, TWiki:Main/WoutMertens); added tablewidth and columnwidths params (TWiki:Main/ThorstenSommermann) |
colas@0
   306
|  09 Dec 2002 | PTh: Added headercolor and datacolor parameters |
colas@0
   307
|  05 Jun 2002 | 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) |
colas@0
   308
|  13 Mar 2002 | PTh: Added TWiki:Main/ShawnBradford 's initsort and initdirection |
colas@0
   309
|  12 Mar 2002 | PTh: Added valign, headeralign and dataalign; fixed bug of swapped cellpadding/cellspacing; fixed warning of uninitialized value |
colas@0
   310
|  05 Jan 2002 | PTh: Fixed sorting bug of cells with leading white space  |
colas@0
   311
|  06 Dec 2001 | PTh: Fixed date sorting bug <br /> 03 Dec 2001 PTh: Fixed sort="off" bug and more |
colas@0
   312
|  29 Nov 2001 | PTh: Fixed Perl warnings |
colas@0
   313
|  16 Nov 2001 | PTh: Added table border, cell spacing, cell padding, gif files |
colas@0
   314
|  07 Oct 2001 | JT: Initial version |
colas@0
   315
|  CPAN Dependencies: | none |
colas@0
   316
|  Other Dependencies: | none |
colas@0
   317
|  Perl Version: | 5.0 |
colas@0
   318
|  Plugin Home: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC% |
colas@0
   319
|  Feedback: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev |
colas@0
   320
|  Appraisal: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Appraisal |
colas@0
   321
colas@0
   322
__Related Topics:__ %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins, %TWIKIWEB%.StandardColors
colas@0
   323
@
colas@0
   324
colas@0
   325
colas@0
   326
1.25
colas@0
   327
log
colas@0
   328
@buildrelease
colas@0
   329
@
colas@0
   330
text
colas@0
   331
@d1 1
colas@0
   332
a1 2
colas@0
   333
%META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="25"}%
colas@0
   334
colas@0
   335
d57 1
colas@0
   336
a57 3
colas@0
   337
		* Set TABLEATTRIBUTES = tableborder="1" cellpadding="0" cellspacing="0" valign="top" headeralign="center" headercolor="#ffffff" headerbg="#6b7f93" headerbgsorted="#334455" headercolor="#ffffff" databg="#ffffff,#edf4f9" databgsorted="#f5f5f5,#dce7ee"
colas@0
   338
		* Classic skin table attributes:
colas@0
   339
			* #Set TABLEATTRIBUTES = tableborder="1" cellpadding="0" cellspacing="1" headerbg="#99cccc" databg="#ffffff,#ffffcc"
colas@0
   340
d62 1
colas@0
   341
d64 1
colas@0
   342
a64 28
colas@0
   343
| *Argument*       | *Comment*  | *Default&nbsp;value*  | *Example*  |
colas@0
   344
| =sort=           | Set table sorting ="on"= or ="off"=. | <span class="twikiGrayText">unspecified</span> | =sort="on"= |
colas@0
   345
| =initsort=       | Column to sort initially (="1"= to number of columns). | <span class="twikiGrayText">unspecified</span> | =initsort="2"= |
colas@0
   346
| =initdirection=  | Initial sorting direction for =initsort=, set to  ="up"= (descending) or ="down"= (ascending). | <span class="twikiGrayText">unspecified</span> | =initdirection="up"= |
colas@0
   347
| =headerbg=       | Header cell background colour. | ="#6b7f93"= | =headerbg="#999999"= |
colas@0
   348
| =headerbgsorted= | Header cell background colour of a sorted column. | the value of =headerbg= | =headerbgsorted="#32596c"= |
colas@0
   349
| =headercolor=    | Header cell text colour. | ="#ffffff"= | =headercolor="#0000cc"= |
colas@0
   350
| =databg=	       | Data cell background colour, a comma separated list. Specify ="none"= for no colour, that is to use the colour/background of the page the table is on. | ="#edf4f9,#ffffff"= | =databg="#f2f2f2,#ffffff"= |
colas@0
   351
| =databgsorted=   | Data cell background colour of a sorted column; see =databg=. | the values of =databg= | =databgsorted="#d4e8e4,#e5f5ea"= |
colas@0
   352
| =datacolor=      | Data cell text colour, a comma separated list. | <span class="twikiGrayText">unspecified</span> | =datacolor="#0000CC, #000000"= |
colas@0
   353
| =tableborder=    | Table border width (pixels). | ="1"= | =tableborder="2"= |
colas@0
   354
| =tableframe=     | Table frame, set to ="void"= (no sides), ="above"= (the top side only), ="below"= (the bottom side only), ="hsides"= (the top and bottom sides only), ="lhs"= (the left-hand side only), ="rhs"= (the right-hand side only), ="vsides"= (the right and left sides only), ="box"= (all four sides), ="border"= (all four sides). | <span class="twikiGrayText">unspecified</span> | =tableframe="hsides"= |
colas@0
   355
| =tablerules=     | Table rules, set to ="none"= (no rules), ="groups"= (rules will appear between row groups and column groups only), ="rows"= (rules will appear between rows only), ="cols"= (rules will appear between columns only), ="all"= (rules will appear between all rows and columns). | <span class="twikiGrayText">unspecified</span>  | =tablerules="rows"= |		  
colas@0
   356
| =cellpadding=    | Cell padding (pixels). | ="0"= | =cellpadding="0"= |
colas@0
   357
| =cellspacing=    | Cell spacing (pixels). | ="0"= | =cellspacing="3"= |
colas@0
   358
| =cellborder=     | Cell border width (pixels). | <span class="twikiGrayText">unspecified</span> | =cellborder="0"= |
colas@0
   359
| =valign=         | Vertical alignment of cells and headers, set to ="top"=, ="middle"=, ="bottom"= or ="baseline"=. | <span class="twikiGrayText">unspecified</span>  | =valign="top"= |
colas@0
   360
| =headervalign=   | Vertical alignment of header cells; overrides =valign=. | <span class="twikiGrayText">unspecified</span>  | =headervalign="top"= |
colas@0
   361
| =datavalign=     | Vertical alignment of data cells; overrides =valign=. | <span class="twikiGrayText">unspecified</span>  | =datavalign="top"= |
colas@0
   362
| =headeralign=    | Header cell alignment, one value for all columns, or a comma separated list for different alignment of individual columns. Set to ="left"=, ="center"=, ="right"= or ="justify"=. Overrides individual cell settings. | <span class="twikiGrayText">unspecified</span>  | =headeralign="left,right"= |
colas@0
   363
| =dataalign=      | Data cell alignment, one value for all columns, or a comma separated list for different alignment of individual columns. Set to ="left"=, ="center"=, ="right"= or ="justify"=. Overrides individual cell settings. | <span class="twikiGrayText">unspecified</span>  | =dataalign="center"= |
colas@0
   364
| =tablewidth=     | Table width: Percentage of window width, or absolute pixel value. | <span class="twikiGrayText">unspecified</span>  | =tablewidth="100%"= |
colas@0
   365
| =columnwidths=   | Column widths: Comma delimited list of column widths, percentage or absolute pixel value. | <span class="twikiGrayText">unspecified</span>  | =columnwidths="80%,20%"= |
colas@0
   366
| =headerrows=     | Number of header rows to exclude from sort. | ="1"=  | =headerrows="1"= |
colas@0
   367
| =footerrows=     | Number of footer rows to exclude from sort. | ="0"=  | =footerrows="1"= |
colas@0
   368
| =id=             | Table identifier string. | <span class="twikiGrayText">unspecified</span> | =id="userTable"= |
colas@0
   369
| =summary=        | Table summary used by screenreaders: A summary of what the table presents. It should provide an orientation for someone who listens to the table. | <span class="twikiGrayText">unspecified</span> | =summary="List of subscribed users"= |
colas@0
   370
| =caption=        | Table caption: A title that will be displayed just above the table.| <span class="twikiGrayText">unspecified</span> | =caption="Users"= |
colas@0
   371
d66 1
colas@0
   372
a66 1
colas@0
   373
The =%<nop>TABLE{...}%= settings override =TABLEATTRIBUTES= preferences settings, which override the =TABLEATTRIBUTES= Plugin settings. 
colas@0
   374
d91 22
colas@0
   375
a119 1
colas@0
   376
	  | ==data/TWiki/%TOPIC%.txt,v== | Plugin topic repository |
colas@0
   377
d121 1
colas@0
   378
a121 3
colas@0
   379
	  | ==pub/TWiki/%TOPIC%/diamond.gif== | Diamond symbol |
colas@0
   380
	  | ==pub/TWiki/%TOPIC%/down.gif== | Down arrow |
colas@0
   381
	  | ==pub/TWiki/%TOPIC%/up.gif== | Up arrow |
colas@0
   382
d130 3
colas@0
   383
a132 1
colas@0
   384
|  Plugin Version: | 1.020 |
colas@0
   385
d134 8
colas@0
   386
d172 1
colas@0
   387
a174 7
colas@0
   388
colas@0
   389
colas@0
   390
colas@0
   391
colas@0
   392
%META:FILEATTACHMENT{name="up.gif" attr="" comment="Up arrow" date="1070351625" path="C:\Data\MyTWiki\Plugins\TablePlugin\pub\TWiki\TablePlugin\up.gif" size="867" user="TWikiContributor" version="1.1"}%
colas@0
   393
%META:FILEATTACHMENT{name="down.gif" attr="" comment="Down arrow" date="1070351653" path="C:\Data\MyTWiki\Plugins\TablePlugin\pub\TWiki\TablePlugin\down.gif" size="867" user="TWikiContributor" version="1.1"}%
colas@0
   394
%META:FILEATTACHMENT{name="diamond.gif" attr="" comment="Diamond symbol" date="1070351672" path="C:\Data\MyTWiki\Plugins\TablePlugin\pub\TWiki\TablePlugin\diamond.gif" size="881" user="TWikiContributor" version="1.1"}%
colas@0
   395
@
colas@0
   396
colas@0
   397
colas@0
   398
1.24
colas@0
   399
log
colas@0
   400
@buildrelease
colas@0
   401
@
colas@0
   402
text
colas@0
   403
@d1 1
colas@0
   404
a1 2
colas@0
   405
%META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="24"}%
colas@0
   406
colas@0
   407
d22 2
colas@0
   408
a23 3
colas@0
   409
		* dd MMM YYY - hh:mm
colas@0
   410
		* dd-MMM-YY or dd-MMM-YYYY (can be / or space in place of -)
colas@0
   411
		* MMM is Jan, Feb, etc
colas@0
   412
d58 1
colas@0
   413
a58 1
colas@0
   414
		* Set TABLEATTRIBUTES = tableborder="0" cellpadding="1" cellspacing="1" headerbg="#dadada" headercolor="#000000" databg="#eaeaea, #ffffff"
colas@0
   415
d60 1
colas@0
   416
a60 1
colas@0
   417
			* #Set TABLEATTRIBUTES = tableborder="1" cellpadding="0" cellspacing="1" headerbg="#99CCCC" databg="#FFFFCC, #FFFFFF"
colas@0
   418
d66 28
colas@0
   419
a93 23
colas@0
   420
| *Argument* | *Comment* | *Example* |
colas@0
   421
| =sort=	  | Set table sorting ="on"= or ="off"= | =sort="on"= |
colas@0
   422
| =initsort= | Column to sort initially (="1"= to number of columns) | =initsort="2"= |
colas@0
   423
| =initdirection= | Initial sorting direction for =initsort=, set to  ="up"= or ="down"= | =initdirection="up"= |
colas@0
   424
| =headerbg= | Header cell background colour. Choose one of the %TWIKIWEB%.StandardColors | =headerbg="#99CCCC"= |
colas@0
   425
| =headercolor= | Header cell text colour | =headercolor="#0000CC"= |
colas@0
   426
| =databg=	| Data cell background colour, a comma separated list. Specify ="none"= for no colour, that is to use the colour/background of the page the table is on. | =databg="#C8CB8F, #DBDDB5"= |
colas@0
   427
| =datacolor= | Data cell text colour, a comma separated list | =datacolor="#0000CC, #000000"= |
colas@0
   428
| =tableborder= | Table border width (pixels) | =tableborder="2"= |
colas@0
   429
| =tableframe= | Table frame, set to ="void"= (no sides), ="above"= (the top side only), ="below"= (the bottom side only), ="hsides"= (the top and bottom sides only), ="lhs"= (the left-hand side only), ="rhs"= (the right-hand side only), ="vsides"= (the right and left sides only), ="box"= (all four sides), ="border"= (all four sides); default ="void"= | =tableframe="hsides"= |
colas@0
   430
| =tablerules= | Table rules, set to ="none"= (no rules), ="groups"= (rules will appear between row groups and column groups only), ="rows"= (rules will appear between rows only), ="cols"= (rules will appear between columns only), ="all"= (rules will appear between all rows and columns); default ="none"= | =tablerules="rows"= |		  
colas@0
   431
| =cellpadding= | Cell padding (pixels) | =cellpadding="0"= |
colas@0
   432
| =cellspacing= | Cell spacing (pixels) | =cellspacing="3"= |
colas@0
   433
| =valign= | Vertical alignment of cells, set to ="top"=, ="middle"=, ="bottom"= or ="baseline"= | =valign="top"= |
colas@0
   434
| =headeralign= | Header cell alignment, one value for all columns, or a comma separated list for different alignment of individual columns. Set to ="left"=, ="center"=, ="right"= or ="justify"=. Overrides individual cell settings | =headeralign="left, right"= |
colas@0
   435
| =dataalign= | Data cell alignment, one value for all columns, or a comma separated list for different alignment of individual columns. Set to ="left"=, ="center"=, ="right"= or ="justify"=. Overrides individual cell settings | =dataalign="center"= |
colas@0
   436
| =tablewidth= | Table width: Percentage of window width, or absolute pixel value. Default is unspecified. | =tablewidth="100%"= |
colas@0
   437
| =columnwidths= | Column widths: Comma delimited list of column widths, percentage or absolute pixel value. Default is unspecified. | =columnwidths="80%, 20%"= |
colas@0
   438
| =headerrows= | Number of header rows to exclude from sort; default ="1"= | =headerrows="1"= |
colas@0
   439
| =footerrows= | Number of footer rows to exclude from sort; default ="0"= | =footerrows="1"= |
colas@0
   440
| =id= | Table identifier string. Default is unspecified. | =id="userTable"= |
colas@0
   441
| =summary= | 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. | =summary="List of subscribed users"= |
colas@0
   442
| =caption= | Table caption: A title that will be displayed just above the table. Default is unspecified. | =caption="Users"= |
colas@0
   443
d101 1
colas@0
   444
a101 1
colas@0
   445
Line before table: =%<nop>TABLE{ sort="on" tableborder="0" cellpadding="1" cellspacing="3" headerbg="#D5CCB1" headercolor="#666666" databg="#FAF0D4, #F3DFA8" headerrows="2" footerrows="1" }%=
colas@0
   446
d103 1
colas@0
   447
a103 1
colas@0
   448
%TABLE{ sort="on" tableborder="0" cellpadding="1" cellspacing="3" headerbg="#D5CCB1" headercolor="#666666" databg="#FAF0D4, #F3DFA8" headerrows="2" footerrows="1" }%
colas@0
   449
d140 1
colas@0
   450
a140 1
colas@0
   451
|  Plugin Version: | 1.014 |
colas@0
   452
d142 25
colas@0
   453
a166 18
colas@0
   454
|  13 Dec 2005 | AC: Added support for id, summary and caption |
colas@0
   455
|  5 Mar 2005 | 1.014: Crawford Currie eliminated deprecated handlers for Dakar |
colas@0
   456
|  01 Aug 2004: | AC: Added CSS support for first column and ascending/descending table headers |
colas@0
   457
|  21 Mar 2004: | PTh: Internal change: Fixed reference to unofficial variable |
colas@0
   458
|  01 Jan 2004: | PTh: Alternating data row colors restart again after each header row |
colas@0
   459
|  01 Dec 2003: | PTh: Fixed error when footerrows was specified on an empty table, contributed by TWiki:Main/PaulineCheung |
colas@0
   460
|  24 May 2003: | PTh: New =&#124;^&#124;= 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 |
colas@0
   461
|  17 Dec 2002: | PTh: Removed individual table Plugin settings; added TABLEATTRIBUTES Plugins setting and TABLEATTRIBUTES preferences setting |
colas@0
   462
|  15 Dec 2002: | PTh: Added headerrows and footerrows params (TWiki:Main/DarrylGreen, TWiki:Main/WoutMertens); added tablewidth and columnwidths params (TWiki:Main/ThorstenSommermann) |
colas@0
   463
|  09 Dec 2002: | PTh: Added headercolor and datacolor parameters |
colas@0
   464
|  05 Jun 2002: | 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) |
colas@0
   465
|  13 Mar 2002: | PTh: Added TWiki:Main/ShawnBradford 's initsort and initdirection |
colas@0
   466
|  12 Mar 2002: | PTh: Added valign, headeralign and dataalign; fixed bug of swapped cellpadding/cellspacing; fixed warning of uninitialized value |
colas@0
   467
|  05 Jan 2002: | PTh: Fixed sorting bug of cells with leading white space  |
colas@0
   468
|  06 Dec 2001: | PTh: Fixed date sorting bug <br /> 03 Dec 2001 PTh: Fixed sort="off" bug and more |
colas@0
   469
|  29 Nov 2001: | PTh: Fixed Perl warnings |
colas@0
   470
|  16 Nov 2001: | PTh: Added table border, cell spacing, cell padding, gif files |
colas@0
   471
|  07 Oct 2001: | JT: Initial version |
colas@0
   472
@
colas@0
   473
colas@0
   474
colas@0
   475
1.23
colas@0
   476
log
colas@0
   477
@buildrelease
colas@0
   478
@
colas@0
   479
text
colas@0
   480
@d1 1
colas@0
   481
a1 1
colas@0
   482
%META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="23"}%
colas@0
   483
d16 1
colas@0
   484
a16 1
colas@0
   485
	* Row spans
colas@0
   486
@
colas@0
   487
colas@0
   488
colas@0
   489
1.22
colas@0
   490
log
colas@0
   491
@none
colas@0
   492
@
colas@0
   493
text
colas@0
   494
@d1 3
colas@0
   495
a3 1
colas@0
   496
%META:TOPICINFO{author="PeterThoeny" date="1091423297" format="1.0" version="1.22"}%
colas@0
   497
d16 1
colas@0
   498
d29 15
colas@0
   499
d55 2
colas@0
   500
a56 2
colas@0
   501
	* Make sortable:
colas@0
   502
		* #Set SORT = attachments
colas@0
   503
a57 1
colas@0
   504
		* #Set SORT = none
colas@0
   505
d60 3
colas@0
   506
a62 2
colas@0
   507
		* Set TABLEATTRIBUTES = tableborder="1" cellpadding="0" cellspacing="1" headerbg="#99CCCC" databg="#FFFFCC, #FFFFFF"
colas@0
   508
colas@0
   509
d84 2
colas@0
   510
a85 2
colas@0
   511
| =tablewidth= | Table width: Percentage of window width, or absolute pixel value. Default is unspecified | =tablewidth="100%"= |
colas@0
   512
| =columnwidths= | Column widths: Comma delimited list of column widths, percentage or absolute pixel value. Default is unspecified | =columnwidths="80%, 20%"= |
colas@0
   513
d88 3
colas@0
   514
d98 1
colas@0
   515
a98 1
colas@0
   516
Line before table: =%<nop>TABLE{ sort="on" tableborder="0" cellpadding="1" cellspacing="3" headerbg="#000099" headercolor="#FFFFCC" databg="#C8CB8F, #DBDDB5" headerrows="2" footerrows="1" }%=
colas@0
   517
d100 1
colas@0
   518
a100 1
colas@0
   519
%TABLE{ sort="on" tableborder="0" cellpadding="1" cellspacing="3" headerbg="#000099" headercolor="#FFFFCC" databg="#C8CB8F, #DBDDB5" headerrows="2" footerrows="1" }%
colas@0
   520
d118 1
colas@0
   521
a118 2
colas@0
   522
colas@0
   523
*Note:* You do not need to install anything on the browser to use this plugin. Below installation instructions are for the administrator who needs to install this plugin on the TWiki server.
colas@0
   524
d129 1
colas@0
   525
d137 1
colas@0
   526
a137 1
colas@0
   527
|  Plugin Version: | 01 Aug 2004 |
colas@0
   528
d139 2
colas@0
   529
a164 2
colas@0
   530
-- TWiki:Main/JohnTalintyre - 07 Oct 2001 <br />
colas@0
   531
-- TWiki:Main/PeterThoeny - 01 Aug 2004 <br />
colas@0
   532
d166 5
colas@0
   533
a170 3
colas@0
   534
%META:FILEATTACHMENT{name="up.gif" attr="" comment="Up arrow" date="1070351625" path="C:\Data\MyTWiki\Plugins\TablePlugin\pub\TWiki\TablePlugin\up.gif" size="867" user="PeterThoeny" version="1.1"}%
colas@0
   535
%META:FILEATTACHMENT{name="down.gif" attr="" comment="Down arrow" date="1070351653" path="C:\Data\MyTWiki\Plugins\TablePlugin\pub\TWiki\TablePlugin\down.gif" size="867" user="PeterThoeny" version="1.1"}%
colas@0
   536
%META:FILEATTACHMENT{name="diamond.gif" attr="" comment="Diamond symbol" date="1070351672" path="C:\Data\MyTWiki\Plugins\TablePlugin\pub\TWiki\TablePlugin\diamond.gif" size="881" user="PeterThoeny" version="1.1"}%
colas@0
   537
@
colas@0
   538
colas@0
   539
colas@0
   540
1.21
colas@0
   541
log
colas@0
   542
@none
colas@0
   543
@
colas@0
   544
text
colas@0
   545
@d1 144
colas@0
   546
a144 142
colas@0
   547
%META:TOPICINFO{author="PeterThoeny" date="1079859914" format="1.0" version="1.21"}%
colas@0
   548
---+ Table Plugin
colas@0
   549
colas@0
   550
Gives extra control of table display:
colas@0
   551
	* Allows sorting
colas@0
   552
	* Changing table properties like border width, cell spacing and cell padding
colas@0
   553
	* Changing background color and text color for header cells
colas@0
   554
	* Changing background color and text color for data cells - colors can _alternate_
colas@0
   555
	* Table attributes can be set and overridden in this order:
colas@0
   556
		* Default =TABLEATTRIBUTES= Plugin setting in this topic.
colas@0
   557
		* A =TABLEATTRIBUTES= preferences setting on site-level (%TWIKIWEB%.TWikiPreferences) or web-level (any WebPreferences), e.g.
colas@0
   558
			* =Set TABLEATTRIBUTES = tableborder="0" cellpadding="1" ...=
colas@0
   559
		* Before a table using =%<nop>TABLE{...}%=
colas@0
   560
colas@0
   561
---++ Sorting
colas@0
   562
colas@0
   563
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:
colas@0
   564
colas@0
   565
	* date if format is:
colas@0
   566
		* dd MMM YYY - hh:mm
colas@0
   567
		* dd-MMM-YY or dd-MMM-YYYY (can be / or space in place of -)
colas@0
   568
		* MMM is Jan, Feb, etc
colas@0
   569
	* number is digits, with optional decimal point
colas@0
   570
	* otherwise treated as text
colas@0
   571
colas@0
   572
---++ <nop>%TOPIC% Global Settings
colas@0
   573
colas@0
   574
Plugin settings are stored as preferences variables. To reference
colas@0
   575
a plugin setting write ==%<nop>&lt;plugin&gt;_&lt;setting&gt;%==, for example, ==%<nop>INTERWIKIPLUGIN_SHORTDESCRIPTION%==
colas@0
   576
colas@0
   577
	* One line description, shown in the %TWIKIWEB%.TextFormattingRules topic:
colas@0
   578
		* Set SHORTDESCRIPTION = Control attributes of tables and sorting of table columns
colas@0
   579
colas@0
   580
	* Set DEBUG to 1 to get debug messages in =data/debug.txt=.  Default: =0=
colas@0
   581
		* Set DEBUG = 0
colas@0
   582
colas@0
   583
	* Make sortable:
colas@0
   584
		* #Set SORT = attachments
colas@0
   585
		* Set SORT = all
colas@0
   586
		* #Set SORT = none
colas@0
   587
colas@0
   588
	* Default table attributes:
colas@0
   589
		* Set TABLEATTRIBUTES = tableborder="1" cellpadding="0" cellspacing="1" headerbg="#99CCCC" databg="#FFFFCC, #FFFFFF"
colas@0
   590
colas@0
   591
colas@0
   592
---++ Table Attributes
colas@0
   593
colas@0
   594
Attributes are defined as a =TABLEATTRIBUTES= Plugin setting in this topic, a =TABLEATTRIBUTES= preferences setting, or on line before the table using =%<nop>TABLE{...}%=:
colas@0
   595
colas@0
   596
| *Argument* | *Comment* | *Example* |
colas@0
   597
| =sort=	  | Set table sorting ="on"= or ="off"= | =sort="on"= |
colas@0
   598
| =initsort= | Column to sort initially (="1"= to number of columns) | =initsort="2"= |
colas@0
   599
| =initdirection= | Initial sorting direction for =initsort=, set to  ="up"= or ="down"= | =initdirection="up"= |
colas@0
   600
| =headerbg= | Header cell background colour. Choose one of the %TWIKIWEB%.StandardColors | =headerbg="#99CCCC"= |
colas@0
   601
| =headercolor= | Header cell text colour | =headercolor="#0000CC"= |
colas@0
   602
| =databg=	| Data cell background colour, a comma separated list. Specify ="none"= for no colour, that is to use the colour/background of the page the table is on. | =databg="#C8CB8F, #DBDDB5"= |
colas@0
   603
| =datacolor= | Data cell text colour, a comma separated list | =datacolor="#0000CC, #000000"= |
colas@0
   604
| =tableborder= | Table border width (pixels) | =tableborder="2"= |
colas@0
   605
| =tableframe= | Table frame, set to ="void"= (no sides), ="above"= (the top side only), ="below"= (the bottom side only), ="hsides"= (the top and bottom sides only), ="lhs"= (the left-hand side only), ="rhs"= (the right-hand side only), ="vsides"= (the right and left sides only), ="box"= (all four sides), ="border"= (all four sides); default ="void"= | =tableframe="hsides"= |
colas@0
   606
| =tablerules= | Table rules, set to ="none"= (no rules), ="groups"= (rules will appear between row groups and column groups only), ="rows"= (rules will appear between rows only), ="cols"= (rules will appear between columns only), ="all"= (rules will appear between all rows and columns); default ="none"= | =tablerules="rows"= |		  
colas@0
   607
| =cellpadding= | Cell padding (pixels) | =cellpadding="0"= |
colas@0
   608
| =cellspacing= | Cell spacing (pixels) | =cellspacing="3"= |
colas@0
   609
| =valign= | Vertical alignment of cells, set to ="top"=, ="middle"=, ="bottom"= or ="baseline"= | =valign="top"= |
colas@0
   610
| =headeralign= | Header cell alignment, one value for all columns, or a comma separated list for different alignment of individual columns. Set to ="left"=, ="center"=, ="right"= or ="justify"=. Overrides individual cell settings | =headeralign="left, right"= |
colas@0
   611
| =dataalign= | Data cell alignment, one value for all columns, or a comma separated list for different alignment of individual columns. Set to ="left"=, ="center"=, ="right"= or ="justify"=. Overrides individual cell settings | =dataalign="center"= |
colas@0
   612
| =tablewidth= | Table width: Percentage of window width, or absolute pixel value. Default is unspecified | =tablewidth="100%"= |
colas@0
   613
| =columnwidths= | Column widths: Comma delimited list of column widths, percentage or absolute pixel value. Default is unspecified | =columnwidths="80%, 20%"= |
colas@0
   614
| =headerrows= | Number of header rows to exclude from sort; default ="1"= | =headerrows="1"= |
colas@0
   615
| =footerrows= | Number of footer rows to exclude from sort; default ="0"= | =footerrows="1"= |
colas@0
   616
colas@0
   617
The =%<nop>TABLE{...}%= settings override =TABLEATTRIBUTES= preferences settings, which override the =TABLEATTRIBUTES= Plugin settings. 
colas@0
   618
colas@0
   619
---++ Examples
colas@0
   620
colas@0
   621
---+++ Use of %<nop>TABLE{...}%
colas@0
   622
colas@0
   623
Line before table: =%<nop>TABLE{ sort="on" tableborder="0" cellpadding="1" cellspacing="3" headerbg="#000099" headercolor="#FFFFCC" databg="#C8CB8F, #DBDDB5" headerrows="2" footerrows="1" }%=
colas@0
   624
colas@0
   625
%TABLE{ sort="on" tableborder="0" cellpadding="1" cellspacing="3" headerbg="#000099" headercolor="#FFFFCC" databg="#C8CB8F, #DBDDB5" headerrows="2" footerrows="1" }%
colas@0
   626
| *Table with two Header Rows and Footer Row* ||||||
colas@0
   627
| *Num* | *Status* | *Action* | *Who* | *When* | *Progress* |
colas@0
   628
| 1 | C | Chose new colours | John | 1-Dec-02 | |
colas@0
   629
| 2 | X | Release | John | 1-Apr-02 | |
colas@0
   630
| 3 |	| Get feedback | Anne | 1-Feb-02 | |
colas@0
   631
| 12 | C | Spec error handling | Jack | 1-Dec-02 | |
colas@0
   632
| 5 |	| Abc | John | | |
colas@0
   633
| *Num* | *Status* | *Action* | *Who* | *When* | *Progress* |
colas@0
   634
colas@0
   635
---+++ Table with 4 digit year dates and no use of %<nop>TABLE{...}%
colas@0
   636
colas@0
   637
| *When* |
colas@0
   638
| 1-Jan-2004 |
colas@0
   639
| 1-Jan-2003 |
colas@0
   640
| 2-Jan-2005 |
colas@0
   641
colas@0
   642
---++ Plugin Installation Instructions
colas@0
   643
colas@0
   644
*Note:* You do not need to install anything on the browser to use this plugin. Below installation instructions are for the administrator who needs to install this plugin on the TWiki server.
colas@0
   645
colas@0
   646
	* Download the ZIP file from the Plugin web (see below)
colas@0
   647
	* Unzip ==%TOPIC%.zip== in your twiki installation directory. Content:
colas@0
   648
	  | *File:* | *Description:* |
colas@0
   649
	  | ==data/TWiki/%TOPIC%.txt== | Plugin topic |
colas@0
   650
	  | ==data/TWiki/%TOPIC%.txt,v== | Plugin topic repository |
colas@0
   651
	  | ==lib/TWiki/Plugins/%TOPIC%.pm== | Plugin Perl module |
colas@0
   652
	  | ==pub/TWiki/%TOPIC%/diamond.gif== | Diamond symbol |
colas@0
   653
	  | ==pub/TWiki/%TOPIC%/down.gif== | Down arrow |
colas@0
   654
	  | ==pub/TWiki/%TOPIC%/up.gif== | Up arrow |
colas@0
   655
	* Test if the plugin is correctly installed:
colas@0
   656
		* Check above example if the table renders as expected
colas@0
   657
		* Try click on heading to sort.  Other tables should also be sortable
colas@0
   658
colas@0
   659
---++ Plugin Info
colas@0
   660
colas@0
   661
|  Plugin Author: | TWiki:Main/JohnTalintyre, TWiki:Main/PeterThoeny |
colas@0
   662
|  Plugin Version: | 21 Mar 2004 |
colas@0
   663
|  Change History: | <!-- specify latest version first -->&nbsp; |
colas@0
   664
|  21 Mar 2004: | PTh: Internal change: Fixed reference to inofficial variable |
colas@0
   665
|  01 Jan 2004: | PTh: Alternating data row colors restart again after each header row |
colas@0
   666
|  01 Dec 2003: | PTh: Fixed error when footerrows was specified on an empty table, contributed by TWiki:Main/PaulineCheung |
colas@0
   667
|  24 May 2003: | PTh: New =&#124;^&#124;= 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 |
colas@0
   668
|  17 Dec 2002: | PTh: Removed individual table Plugin settings; added TABLEATTRIBUTES Plugins setting and TABLEATTRIBUTES preferences setting |
colas@0
   669
|  15 Dec 2002: | PTh: Added headerrows and footerrows params (TWiki:Main/DarrylGreen, TWiki:Main/WoutMertens); added tablewidth and columnwidths params (TWiki:Main/ThorstenSommermann) |
colas@0
   670
|  09 Dec 2002: | PTh: Added headercolor and datacolor parameters |
colas@0
   671
|  05 Jun 2002: | 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) |
colas@0
   672
|  13 Mar 2002: | PTh: Added TWiki:Main/ShawnBradford 's initsort and initdirection |
colas@0
   673
|  12 Mar 2002: | PTh: Added valign, headeralign and dataalign; fixed bug of swapped cellpadding/cellspacing; fixed warning of uninitialized value |
colas@0
   674
|  05 Jan 2002: | PTh: Fixed sorting bug of cells with leading white space  |
colas@0
   675
|  06 Dec 2001: | PTh: Fixed date sorting bug <br /> 03 Dec 2001 PTh: Fixed sort="off" bug and more |
colas@0
   676
|  29 Nov 2001: | PTh: Fixed Perl warnings |
colas@0
   677
|  16 Nov 2001: | PTh: Added table border, cell spacing, cell padding, gif files |
colas@0
   678
|  07 Oct 2001: | JT: Initial version |
colas@0
   679
|  CPAN Dependencies: | none |
colas@0
   680
|  Other Dependencies: | none |
colas@0
   681
|  Perl Version: | 5.0 |
colas@0
   682
|  Plugin Home: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC% |
colas@0
   683
|  Feedback: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev |
colas@0
   684
colas@0
   685
__Related Topics:__ %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins, %TWIKIWEB%.StandardColors
colas@0
   686
colas@0
   687
-- TWiki:Main/JohnTalintyre - 07 Oct 2001 <br />
colas@0
   688
-- TWiki:Main/PeterThoeny - 21 Mar 2004 <br />
colas@0
   689
@
colas@0
   690
colas@0
   691
colas@0
   692
1.20
colas@0
   693
log
colas@0
   694
@none
colas@0
   695
@
colas@0
   696
text
colas@0
   697
@d1 1
colas@0
   698
a1 1
colas@0
   699
%META:TOPICINFO{author="PeterThoeny" date="1073013496" format="1.0" version="1.20"}%
colas@0
   700
d116 1
colas@0
   701
a116 1
colas@0
   702
|  Plugin Version: | 01 Jan 2004 |
colas@0
   703
d118 1
colas@0
   704
d142 1
colas@0
   705
a142 1
colas@0
   706
-- TWiki:Main/PeterThoeny - 01 Jan 2004 <br />
colas@0
   707
@
colas@0
   708
colas@0
   709
colas@0
   710
1.19
colas@0
   711
log
colas@0
   712
@none
colas@0
   713
@
colas@0
   714
text
colas@0
   715
@d1 1
colas@0
   716
a1 1
colas@0
   717
%META:TOPICINFO{author="PeterThoeny" date="1053858660" format="1.0" version="1.19"}%
colas@0
   718
d116 1
colas@0
   719
a116 1
colas@0
   720
|  Plugin Version: | 01 Dec 2003 |
colas@0
   721
d118 1
colas@0
   722
d141 1
colas@0
   723
a141 1
colas@0
   724
-- TWiki:Main/PeterThoeny - 01 Dec 2003 <br />
colas@0
   725
@
colas@0
   726
colas@0
   727
colas@0
   728
1.18
colas@0
   729
log
colas@0
   730
@none
colas@0
   731
@
colas@0
   732
text
colas@0
   733
@d1 1
colas@0
   734
a1 1
colas@0
   735
%META:TOPICINFO{author="PeterThoeny" date="1053833520" format="1.0" version="1.18"}%
colas@0
   736
d21 1
colas@0
   737
a21 1
colas@0
   738
		* dd-MMM-YY or dd-MM-YYYY (can be / or space in place of -)
colas@0
   739
d73 3
colas@0
   740
a75 1
colas@0
   741
---++ Example
colas@0
   742
d89 7
colas@0
   743
d115 2
colas@0
   744
a116 2
colas@0
   745
|  Plugin Author: | %TWIKIWEB%.JohnTalintyre, %TWIKIWEB%.PeterThoeny |
colas@0
   746
|  Plugin Version: | 24 May 2003 |
colas@0
   747
d118 2
colas@0
   748
a119 1
colas@0
   749
|  24 May 2003: | PTh: New =&#124;^&#124;= 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) |
colas@0
   750
d139 5
colas@0
   751
a143 5
colas@0
   752
-- %TWIKIWEB%.JohnTalintyre - 07 Oct 2001 <br />
colas@0
   753
-- %TWIKIWEB%.PeterThoeny - 24 May 2003 <br />
colas@0
   754
%META:FILEATTACHMENT{name="up.gif" attr="" comment="Up arrow" date="1005707580" path="C:\Data\Temp\up.gif" size="876" user="PeterThoeny" version="1.1"}%
colas@0
   755
%META:FILEATTACHMENT{name="down.gif" attr="" comment="Down arrow" date="1005707591" path="C:\Data\Temp\down.gif" size="869" user="PeterThoeny" version="1.1"}%
colas@0
   756
%META:FILEATTACHMENT{name="diamond.gif" attr="" comment="Diamond symbol" date="1005707607" path="C:\Data\Temp\diamond.gif" size="881" user="PeterThoeny" version="1.1"}%
colas@0
   757
@
colas@0
   758
colas@0
   759
colas@0
   760
1.17
colas@0
   761
log
colas@0
   762
@none@
colas@0
   763
text
colas@0
   764
@d1 1
colas@0
   765
a1 1
colas@0
   766
%META:TOPICINFO{author="PeterThoeny" date="1051945822" format="1.0" version="1.17"}%
colas@0
   767
d51 3
colas@0
   768
a53 3
colas@0
   769
| =sort=	  | Set table sorting =on= or =off= | =sort="on"= |
colas@0
   770
| =initsort= | Column to sort initially (1 to number of columns) | =initsort="2"= |
colas@0
   771
| =initdirection= | Initial sorting direction for =initsort=, set to  =up= or =down= | =initdirection="up"= |
colas@0
   772
d59 2
colas@0
   773
d63 3
colas@0
   774
a65 3
colas@0
   775
| =valign= | Vertical alignment of cells, set to =top=, =middle=, =bottom= or =baseline= | =valign="top"= |
colas@0
   776
| =headeralign= | Header cell alignment, set to =left=, =center=, =right= or =justify=. Overrides individual cell settings | =headeralign="left"= |
colas@0
   777
| =dataalign= | Data cell alignment, set to =left=, =center=, =right= or =justify=. Overrides individual cell settings | =dataalign="center"= |
colas@0
   778
d68 2
colas@0
   779
a69 2
colas@0
   780
| =headerrows= | Number of header rows to exclude from sort; default 1 | =headerrows="1"= |
colas@0
   781
| =footerrows= | Number of footer rows to exclude from sort; default 0 | =footerrows="1"= |
colas@0
   782
d107 1
colas@0
   783
a107 1
colas@0
   784
|  Plugin Version: | 17 Dec 2002 |
colas@0
   785
d109 1
colas@0
   786
d111 1
colas@0
   787
a111 1
colas@0
   788
|  15 Dec 2002: | PTh: Added headerrows and footerrows params (TWiki:Main/WoutMertens); added tablewidth and columnwidths params (TWiki:Main/ThorstenSommermann) |
colas@0
   789
d130 1
colas@0
   790
a130 1
colas@0
   791
-- %TWIKIWEB%.PeterThoeny - 17 Dec 2002 <br />
colas@0
   792
@
colas@0
   793
colas@0
   794
colas@0
   795
1.16
colas@0
   796
log
colas@0
   797
@none
colas@0
   798
@
colas@0
   799
text
colas@0
   800
@d1 1
colas@0
   801
a1 1
colas@0
   802
%META:TOPICINFO{author="PeterThoeny" date="1040164692" format="1.0" version="1.16"}%
colas@0
   803
d53 1
colas@0
   804
a53 1
colas@0
   805
| =initdirection= | Initial sorting direction for =initsort=, set to  =up= or =down= | =initsort="down"= |
colas@0
   806
@
colas@0
   807
colas@0
   808
colas@0
   809
1.15
colas@0
   810
log
colas@0
   811
@none
colas@0
   812
@
colas@0
   813
text
colas@0
   814
@d1 1
colas@0
   815
a1 1
colas@0
   816
%META:TOPICINFO{author="PeterThoeny" date="1039944840" format="1.0" version="1.15"}%
colas@0
   817
d7 7
colas@0
   818
a13 3
colas@0
   819
	* Changing background color for header cells
colas@0
   820
	* Changing background color for data cells - colors can _alternate_
colas@0
   821
	* Behaviour can be specified for a specific table using %<nop>TABLE{...}% or with global preferences
colas@0
   822
d15 10
colas@0
   823
a36 33
colas@0
   824
	* Table border width.  Default: 1
colas@0
   825
		* Set TABLEBORDER = 1
colas@0
   826
colas@0
   827
	* Table cell padding.  Default: 0
colas@0
   828
		* Set CELLPADDING = 0
colas@0
   829
colas@0
   830
	* Table cell spacing.  Default: 1
colas@0
   831
		* Set CELLSPACING = 1
colas@0
   832
colas@0
   833
	* Table width, e.g. =100%= for relative, =640= for absolute width.  Default: (not set)
colas@0
   834
		* Set TABLEWIDTH = 
colas@0
   835
colas@0
   836
	* Vertical alignment of cells. Set to: =top=, =middle=, =bottom= or =baseline=; default: (empty)
colas@0
   837
		* Set VALIGN = 
colas@0
   838
colas@0
   839
	* Table header cell alignment. Set to: =left=, =center=, =right= or =justify=; default: (empty)
colas@0
   840
		* Set HEADERALIGN = 
colas@0
   841
colas@0
   842
	* Table data cell alignment. Set to: =left=, =center=, =right= or =justify=; default: (empty)
colas@0
   843
		* Set DATAALIGN = 
colas@0
   844
colas@0
   845
	* Background color of header cells ('*'s around text). Choose one of the %TWIKIWEB%.StandardColors. Default: <span style="background : #99CCCC;">#99CCCC</span>
colas@0
   846
		* Set HEADER_BG = 
colas@0
   847
colas@0
   848
	* Text color of header cells ('*'s around text).  Default: not specified, e.g. determined by the browser
colas@0
   849
		* Set HEADER_COLOR = 
colas@0
   850
colas@0
   851
	* Background color of table rows, two alternate colors.  Default: <span style="background : #FFFFCC;">#FFFFCC</span>, <span style="background : #FFFFFF;">#FFFFFF</span>
colas@0
   852
		* Set DATA_BG = #FFFFCC, #FFFFFF
colas@0
   853
colas@0
   854
	* Text color of table rows, alternate colors.  Default: not specified, e.g. determined by the browser
colas@0
   855
		* Set DATA_COLOR = 
colas@0
   856
colas@0
   857
d42 2
colas@0
   858
a43 1
colas@0
   859
---++ Sorting
colas@0
   860
a44 8
colas@0
   861
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:
colas@0
   862
colas@0
   863
	* date if format is:
colas@0
   864
		* dd MMM YYY - hh:mm
colas@0
   865
		* dd-MMM-YY or dd-MM-YYYY (can be / or space in place of -)
colas@0
   866
		* MMM is Jan, Feb, etc
colas@0
   867
	* number is digits, with optional decimal point
colas@0
   868
	* otherwise treated as text
colas@0
   869
d46 1
colas@0
   870
a46 1
colas@0
   871
---++ Per Table Settings
colas@0
   872
d48 1
colas@0
   873
a48 1
colas@0
   874
On line before the table use =%<nop>TABLE{...}%=:
colas@0
   875
d69 1
colas@0
   876
a69 1
colas@0
   877
All default to the global setting
colas@0
   878
d105 1
colas@0
   879
a105 1
colas@0
   880
|  Plugin Version: | 15 Dec 2002 |
colas@0
   881
d107 1
colas@0
   882
d127 1
colas@0
   883
a127 1
colas@0
   884
-- %TWIKIWEB%.PeterThoeny - 15 Dec 2002 <br />
colas@0
   885
@
colas@0
   886
colas@0
   887
colas@0
   888
1.14
colas@0
   889
log
colas@0
   890
@none
colas@0
   891
@
colas@0
   892
text
colas@0
   893
@d1 1
colas@0
   894
a1 1
colas@0
   895
%META:TOPICINFO{author="PeterThoeny" date="1039479060" format="1.0" version="1.14"}%
colas@0
   896
d32 3
colas@0
   897
d90 4
colas@0
   898
d99 1
colas@0
   899
a99 1
colas@0
   900
Line before table: =%<nop>TABLE{ sort="on" tableborder="0" cellpadding="1" cellspacing="3" headerbg="#000099" headercolor="#FFFFCC" databg="#C8CB8F, #DBDDB5" }%=
colas@0
   901
d101 2
colas@0
   902
a102 1
colas@0
   903
%TABLE{ sort="on" tableborder="0" cellpadding="1" cellspacing="3" headerbg="#000099" headercolor="#FFFFCC" databg="#C8CB8F, #DBDDB5" }%
colas@0
   904
d109 1
colas@0
   905
d131 1
colas@0
   906
a131 1
colas@0
   907
|  Plugin Version: | 09 Dec 2002 |
colas@0
   908
d133 1
colas@0
   909
d152 1
colas@0
   910
a152 1
colas@0
   911
-- %TWIKIWEB%.PeterThoeny - 09 Dec 2002 <br />
colas@0
   912
@
colas@0
   913
colas@0
   914
colas@0
   915
1.13
colas@0
   916
log
colas@0
   917
@none
colas@0
   918
@
colas@0
   919
text
colas@0
   920
@d1 1
colas@0
   921
a1 1
colas@0
   922
%META:TOPICINFO{author="PeterThoeny" date="1023260211" format="1.0" version="1.13"}%
colas@0
   923
d41 2
colas@0
   924
a42 2
colas@0
   925
	* Color for header cells ('*'s around text).  Default: <span style="background : #99CCCC;">#99CCCC</span>
colas@0
   926
		* #Set HEADER_BG = red
colas@0
   927
d44 8
colas@0
   928
a51 2
colas@0
   929
	* Background color for table rows, two alternate colors.  Default: <span style="background : #FFFFCC;">#FFFFCC</span>,<span style="background : #FFFFFF;">#FFFFFF</span>
colas@0
   930
		* Set DATA_BG = #FFFFCC,#FFFFFF
colas@0
   931
d77 4
colas@0
   932
a80 2
colas@0
   933
| =headerbg= | Header cell background colour | =headerbg="#99CCCC"= |
colas@0
   934
| =databg=	| Data cell background colour, a comma separated list. Specify ="none"= for no colour, that is to use the colour/background of the page the table is on. | =databg="#C8CB8F,#DBDDB5"= |
colas@0
   935
d90 1
colas@0
   936
a90 1
colas@0
   937
---++ Examples
colas@0
   938
d92 1
colas@0
   939
a92 1
colas@0
   940
Line before table: =%<nop>TABLE{sort="on" tableborder="0" cellpadding="1" cellspacing="3" headerbg="#99CCCC" databg="#C8CB8F,#DBDDB5"}%=
colas@0
   941
d94 1
colas@0
   942
a94 1
colas@0
   943
%TABLE{sort="on" tableborder="0" cellpadding="1" cellspacing="3" headerbg="#99CCCC" databg="#C8CB8F,#DBDDB5"}%
colas@0
   944
d122 1
colas@0
   945
a122 1
colas@0
   946
|  Plugin Version: | 13 Mar 2002 |
colas@0
   947
d124 1
colas@0
   948
d139 1
colas@0
   949
a139 1
colas@0
   950
__Related Topics:__ %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins
colas@0
   951
d142 1
colas@0
   952
a142 1
colas@0
   953
-- %TWIKIWEB%.PeterThoeny - 05 Jun 2002 <br />
colas@0
   954
@
colas@0
   955
colas@0
   956
colas@0
   957
1.12
colas@0
   958
log
colas@0
   959
@none
colas@0
   960
@
colas@0
   961
text
colas@0
   962
@d1 1
colas@0
   963
a1 1
colas@0
   964
%META:TOPICINFO{author="PeterThoeny" date="1016001000" format="1.0" version="1.12"}%
colas@0
   965
d72 1
colas@0
   966
a72 1
colas@0
   967
| =databg=	| Data cell background colour, a comma separated list | =databg="#C8CB8F,#DBDDB5"= |
colas@0
   968
d96 2
colas@0
   969
d115 9
colas@0
   970
a123 1
colas@0
   971
|  Change History: | 13 Mar 2002 PTh: Added TWiki:Main/ShawnBradford 's initsort and initdirection <br /> 12 Mar 2002 PTh: Added valign, headeralign and dataalign; fixed bug of swapped cellpadding/cellspacing; fixed warning of uninitialized value <br /> 05 Jan 2002 PTh: Fixed sorting bug of cells with leading white space <br /> 06 Dec 2001 PTh: Fixed date sorting bug <br /> 03 Dec 2001 PTh: Fixed sort="off" bug and more <br /> 29 Nov 2001: PTh fixed Perl warnings <br /> 16 Nov 2001: PTh added table border, cell spacing, cell padding, gif files <br /> 07 Oct 2001: Initial version |
colas@0
   972
d133 1
colas@0
   973
a133 1
colas@0
   974
-- %TWIKIWEB%.PeterThoeny - 13 Mar 2002 <br />
colas@0
   975
@
colas@0
   976
colas@0
   977
colas@0
   978
1.11
colas@0
   979
log
colas@0
   980
@none
colas@0
   981
@
colas@0
   982
text
colas@0
   983
@d1 1
colas@0
   984
a1 1
colas@0
   985
%META:TOPICINFO{author="PeterThoeny" date="1015987140" format="1.0" version="1.11"}%
colas@0
   986
d69 2
colas@0
   987
d72 1
colas@0
   988
a72 1
colas@0
   989
| =databg=	| Data cell background colour, a comma seperated list | =databg="#C8CB8F,#DBDDB5"= |
colas@0
   990
d112 2
colas@0
   991
a113 2
colas@0
   992
|  Plugin Version: | 12 Mar 2002 |
colas@0
   993
|  Change History: | 12 Mar 2002 PTh: Added valign, headeralign and dataalign; fixed bug of swapped cellpadding/cellspacing; fixed warning of uninitialized value <br /> 05 Jan 2002 PTh: Fixed sorting bug of cells with leading white space <br /> 06 Dec 2001 PTh: Fixed date sorting bug <br /> 03 Dec 2001 PTh: Fixed sort="off" bug and more <br /> 29 Nov 2001: PTh fixed Perl warnings <br /> 16 Nov 2001: PTh added table border, cell spacing, cell padding, gif files <br /> 07 Oct 2001: Initial version |
colas@0
   994
d123 1
colas@0
   995
a123 1
colas@0
   996
-- %TWIKIWEB%.PeterThoeny - 12 Mar 2002 <br />
colas@0
   997
@
colas@0
   998
colas@0
   999
colas@0
  1000
1.10
colas@0
  1001
log
colas@0
  1002
@none
colas@0
  1003
@
colas@0
  1004
text
colas@0
  1005
@d1 1
colas@0
  1006
a1 1
colas@0
  1007
%META:TOPICINFO{author="PeterThoeny" date="1015541700" format="1.0" version="1.10"}%
colas@0
  1008
d92 1
colas@0
  1009
a92 1
colas@0
  1010
---+++ Plugin Installation Instructions
colas@0
  1011
d107 1
colas@0
  1012
a107 1
colas@0
  1013
---+++ Plugin Info
colas@0
  1014
d109 3
colas@0
  1015
a111 3
colas@0
  1016
|  Plugin Author: | %TWIKIWEB%.JohnTalintyre |
colas@0
  1017
|  Plugin Version: | 07 Mar 2002 |
colas@0
  1018
|  Change History: | 07 Mar 2002 PTh: Added valign, headeralign and dataalign; fixed swapped cellpadding/cellspacing bug <br /> 05 Jan 2002 PTh: Fixed sorting bug of cells with leading white space <br /> 06 Dec 2001 PTh: Fixed date sorting bug <br /> 03 Dec 2001 PTh: Fixed sort="off" bug and more <br /> 29 Nov 2001: PTh fixed Perl warnings <br /> 16 Nov 2001: PTh added table border, cell spacing, cell padding, gif files <br /> 07 Oct 2001: Initial version |
colas@0
  1019
d121 1
colas@0
  1020
a121 1
colas@0
  1021
-- %TWIKIWEB%.PeterThoeny - 07 Mar 2002 <br />
colas@0
  1022
@
colas@0
  1023
colas@0
  1024
colas@0
  1025
1.9
colas@0
  1026
log
colas@0
  1027
@none
colas@0
  1028
@
colas@0
  1029
text
colas@0
  1030
@d1 1
colas@0
  1031
a1 1
colas@0
  1032
%META:TOPICINFO{author="PeterThoeny" date="1010218620" format="1.0" version="1.9"}%
colas@0
  1033
d32 9
colas@0
  1034
d74 3
colas@0
  1035
d82 1
colas@0
  1036
a82 1
colas@0
  1037
Line before table: =%<nop>TABLE{sort="on" tableborder="0" cellpadding="3" cellspacing="1" headerbg="#99CCCC" databg="#C8CB8F,#DBDDB5"}%=
colas@0
  1038
d84 1
colas@0
  1039
a84 1
colas@0
  1040
%TABLE{sort="on" tableborder="0" cellpadding="3" cellspacing="1" headerbg="#99CCCC" databg="#C8CB8F,#DBDDB5"}%
colas@0
  1041
d110 2
colas@0
  1042
a111 2
colas@0
  1043
|  Plugin Version: | 05 Jan 2002 |
colas@0
  1044
|  Change History: | 05 Jan 2002 PTh: Fixed sorting bug of cells with leading white space <br /> 06 Dec 2001 PTh: Fixed date sorting bug <br /> 03 Dec 2001 PTh: Fixed sort="off" bug and more <br /> 29 Nov 2001: PTh fixed Perl warnings <br /> 16 Nov 2001: PTh added table border, cell spacing, cell padding, gif files <br /> 07 Oct 2001: Initial version |
colas@0
  1045
d121 1
colas@0
  1046
a121 1
colas@0
  1047
-- %TWIKIWEB%.PeterThoeny - 05 Jan 2002 <br />
colas@0
  1048
@
colas@0
  1049
colas@0
  1050
colas@0
  1051
1.8
colas@0
  1052
log
colas@0
  1053
@none
colas@0
  1054
@
colas@0
  1055
text
colas@0
  1056
@d1 1
colas@0
  1057
a1 1
colas@0
  1058
%META:TOPICINFO{author="PeterThoeny" date="1007891134" format="1.0" version="1.8"}%
colas@0
  1059
d15 1
colas@0
  1060
a15 1
colas@0
  1061
a plugin setting write ==%<nop>&lt;plugin&gt;_&lt;setting&gt;%==, i.e. ==%<nop>INTERWIKIPLUGIN_SHORTDESCRIPTION%==
colas@0
  1062
d17 1
colas@0
  1063
a17 1
colas@0
  1064
	* One line description, is shown in the %TWIKIWEB%.TextFormattingRules topic:
colas@0
  1065
d98 2
colas@0
  1066
a99 2
colas@0
  1067
|  Plugin Version: | 06 Dec 2001 |
colas@0
  1068
|  Change History: | 06 Dec 2001 PTh: Fixed date sorting bug <br /> 03 Dec 2001 PTh: Fixed sort="off" bug and more <br /> 29 Nov 2001: PTh fixed Perl warnings <br /> 16 Nov 2001: PTh added table border, cell spacing, cell padding, gif files <br /> 07 Oct 2001: Initial version |
colas@0
  1069
d109 1
colas@0
  1070
a109 1
colas@0
  1071
-- %TWIKIWEB%.PeterThoeny - 06 Dec 2001 <br />
colas@0
  1072
@
colas@0
  1073
colas@0
  1074
colas@0
  1075
1.7
colas@0
  1076
log
colas@0
  1077
@none
colas@0
  1078
@
colas@0
  1079
text
colas@0
  1080
@d1 1
colas@0
  1081
a1 1
colas@0
  1082
%META:TOPICINFO{author="PeterThoeny" date="1007710080" format="1.0" version="1.7"}%
colas@0
  1083
d4 1
colas@0
  1084
a4 1
colas@0
  1085
Gives extra control off table display:
colas@0
  1086
@
colas@0
  1087
colas@0
  1088
colas@0
  1089
1.6
colas@0
  1090
log
colas@0
  1091
@none
colas@0
  1092
@
colas@0
  1093
text
colas@0
  1094
@d1 1
colas@0
  1095
a1 1
colas@0
  1096
%META:TOPICINFO{author="PeterThoeny" date="1007432760" format="1.0" version="1.6"}%
colas@0
  1097
d98 2
colas@0
  1098
a99 2
colas@0
  1099
|  Plugin Version: | 03 Dec 2001 |
colas@0
  1100
|  Change History: | 03 Dec 2001 PTh: Fixed sort="off" bug and more <br /> 29 Nov 2001: PTh fixed Perl warnings <br /> 16 Nov 2001: PTh added table border, cell spacing, cell padding, gif files <br /> 07 Oct 2001: Initial version |
colas@0
  1101
d109 1
colas@0
  1102
a109 1
colas@0
  1103
-- %TWIKIWEB%.PeterThoeny - 03 Dec 2001 <br>
colas@0
  1104
@
colas@0
  1105
colas@0
  1106
colas@0
  1107
1.5
colas@0
  1108
log
colas@0
  1109
@none
colas@0
  1110
@
colas@0
  1111
text
colas@0
  1112
@d1 1
colas@0
  1113
a1 1
colas@0
  1114
%META:TOPICINFO{author="PeterThoeny" date="1007021551" format="1.0" version="1.5"}%
colas@0
  1115
d59 1
colas@0
  1116
a59 1
colas@0
  1117
| =sort=	  | Set =on= or =off= | =sort="on"= |
colas@0
  1118
d98 4
colas@0
  1119
a101 4
colas@0
  1120
|  Plugin Version: | 29 Nov 2001 |
colas@0
  1121
|  Change History: | 29 Nov 2001: PTh fixed Perl warnings <br /> 16 Nov 2001: PTh added table border, cell spacing, cell padding, gif files <br /> 07 Oct 2001: Initial version |
colas@0
  1122
|  CPAN Dependencies: |  |
colas@0
  1123
|  Other Dependencies: |  |
colas@0
  1124
d109 1
colas@0
  1125
a109 1
colas@0
  1126
-- %TWIKIWEB%.PeterThoeny - 16 Nov 2001 <br>
colas@0
  1127
@
colas@0
  1128
colas@0
  1129
colas@0
  1130
1.4
colas@0
  1131
log
colas@0
  1132
@none
colas@0
  1133
@
colas@0
  1134
text
colas@0
  1135
@d1 1
colas@0
  1136
a1 1
colas@0
  1137
%META:TOPICINFO{author="PeterThoeny" date="1005906204" format="1.0" version="1.4"}%
colas@0
  1138
d98 2
colas@0
  1139
a99 2
colas@0
  1140
|  Plugin Version: | 07 Oct 2001 |
colas@0
  1141
|  Change History: | 16 Nov 2001: PTh added table border, cell spacing, cell padding, gif files <br /> 07 Oct 2001: Initial version |
colas@0
  1142
@
colas@0
  1143
colas@0
  1144
colas@0
  1145
1.3
colas@0
  1146
log
colas@0
  1147
@none
colas@0
  1148
@
colas@0
  1149
text
colas@0
  1150
@d1 1
colas@0
  1151
a1 1
colas@0
  1152
%META:TOPICINFO{author="PeterThoeny" date="1005880790" format="1.0" version="1.3"}%
colas@0
  1153
d6 1
colas@0
  1154
d11 12
colas@0
  1155
a22 3
colas@0
  1156
---++ Global Preferences
colas@0
  1157
	* Set DEBUG to on to get debug messages in =data/debug.txt=.  Default: =off=
colas@0
  1158
		* Set DEBUG = off
colas@0
  1159
d24 2
colas@0
  1160
a25 1
colas@0
  1161
		* Set TABLEBORDER = 3
colas@0
  1162
d27 2
colas@0
  1163
a28 1
colas@0
  1164
		* Set CELLPADDING = 5
colas@0
  1165
d30 2
colas@0
  1166
a31 1
colas@0
  1167
		* Set CELLSPACING = 2
colas@0
  1168
d34 1
colas@0
  1169
d37 1
colas@0
  1170
a41 2
colas@0
  1171
	* Short description:
colas@0
  1172
		* Set SHORTDESCRIPTION = Control attributes of tables and sorting of table columns
colas@0
  1173
d54 1
colas@0
  1174
a54 1
colas@0
  1175
---++ Per table settings
colas@0
  1176
d70 1
colas@0
  1177
a70 1
colas@0
  1178
Line before table: =%<nop>TABLE{sort="on" tableborder="0" cellpadding="2" cellspacing="1" headerbg="#99CCCC" databg="#C8CB8F,#DBDDB5"}%=
colas@0
  1179
d72 1
colas@0
  1180
a72 1
colas@0
  1181
%TABLE{sort="on" tableborder="0" cellpadding="3" cellspacing="0" headerbg="#99CCCC" databg="#C8CB8F,#DBDDB5"}%
colas@0
  1182
d80 28
colas@0
  1183
d109 1
colas@0
  1184
a109 1
colas@0
  1185
-- %TWIKIWEB%.PeterThoeny - 15 Nov 2001 <br />
colas@0
  1186
@
colas@0
  1187
colas@0
  1188
colas@0
  1189
1.2
colas@0
  1190
log
colas@0
  1191
@none
colas@0
  1192
@
colas@0
  1193
text
colas@0
  1194
@d1 1
colas@0
  1195
a1 1
colas@0
  1196
%META:TOPICINFO{author="PeterThoeny" date="1005707632" format="1.0" version="1.2"}%
colas@0
  1197
d6 2
colas@0
  1198
a7 2
colas@0
  1199
	* Changing background colour for header cells
colas@0
  1200
	* Changing background colour for data cells - colours can _alternate_
colas@0
  1201
d12 8
colas@0
  1202
a19 2
colas@0
  1203
		* Set DEBUG = on
colas@0
  1204
	* Colour for header cells ('*'s around text).  Default: <font color=\"#99CCCC\">#99CCCC</font>
colas@0
  1205
d21 8
colas@0
  1206
a28 7
colas@0
  1207
	* #Set DATA_BG = #C8CB8F,#DBDDB5
colas@0
  1208
	* Set DATA_BG = #FFFFCC,#FFFFFF
colas@0
  1209
	* #Set SORT = attachments
colas@0
  1210
	* Set SORT = all
colas@0
  1211
	* #Set SORT = none
colas@0
  1212
colas@0
  1213
	* Set SHORTDESCRIPTION = Control sorting and colours for table display
colas@0
  1214
d43 1
colas@0
  1215
a43 1
colas@0
  1216
On line before the table use %<nop>TABLE{...}%:
colas@0
  1217
d45 7
colas@0
  1218
a51 4
colas@0
  1219
| *Argument* | *Comment* |
colas@0
  1220
| =sort=	  | =on= or =off= |
colas@0
  1221
| =headerbg=  | header cell background colour |
colas@0
  1222
| =databg=	| data cell background colour, a comma seperated list |
colas@0
  1223
d57 1
colas@0
  1224
a57 1
colas@0
  1225
Line before table: %<nop>TABLE{sort="on" headerbg="#99CCCC" databg="#C8CB8F,#DBDDB5"}%
colas@0
  1226
d59 1
colas@0
  1227
a59 1
colas@0
  1228
%TABLE{sort="on" headerbg="#99CCCC" databg="#C8CB8F,#DBDDB5"}%
colas@0
  1229
a66 1
colas@0
  1230
colas@0
  1231
d68 1
colas@0
  1232
@
colas@0
  1233
colas@0
  1234
colas@0
  1235
1.1
colas@0
  1236
log
colas@0
  1237
@none
colas@0
  1238
@
colas@0
  1239
text
colas@0
  1240
@d1 1
colas@0
  1241
a1 1
colas@0
  1242
%META:TOPICINFO{author="PeterThoeny" date="1005471859" format="1.0" version="1.1"}%
colas@0
  1243
d58 4
colas@0
  1244
a61 1
colas@0
  1245
-- Main.JohnTalintyre - 07 Oct 2001 <br />
colas@0
  1246
@