# Table Plugin
Gives extra control off table display:
- Allows sorting
- Changing table properties like border width, cell spacing and cell padding
- Changing background color for header cells
- Changing background color for data cells - colors can _alternate_
- Behaviour can be specified for a specific table using %TABLE\{...\}% or with global preferences
## %TOPIC% Global Settings
Plugin settings are stored as preferences variables. To reference a plugin setting write **%<plugin>\_<setting>%**
, i.e. **%INTERWIKIPLUGIN\_SHORTDESCRIPTION%**
- One line description, is shown in the [[TextFormattingRules]] topic:
- Set SHORTDESCRIPTION = Control attributes of tables and sorting of table columns
- Set DEBUG to 1 to get debug messages in `data/debug.txt`. Default: `0`
- Set DEBUG = 0
- Table border width. Default: 1
- Set TABLEBORDER = 1
- Table cell padding. Default: 0
- Set CELLPADDING = 0
- Table cell spacing. Default: 1
- Set CELLSPACING = 1
- Color for header cells ('\*'s around text). Default: \#99CCCC
- #Set HEADER\_BG = red
- Background color for table rows, two alternate colors. Default: \#FFFFCC,\#FFFFFF
- Set DATA\_BG = #FFFFCC,#FFFFFF
- Make sortable:
- #Set SORT = attachments
- Set SORT = all
- #Set SORT = none
## Sorting
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:
- date if format is:
- dd MMM YYY - hh:mm
- dd-MMM-YY or dd-MM-YYYY (can be / or space in place of -)
- MMM is Jan, Feb, etc
- number is digits, with optional decimal point
- otherwise treated as text
## Per Table Settings
On line before the table use `%TABLE{...}%`:
Argument | Comment | Example |
---|---|---|
sort |
Set table sorting on or off |
sort="on" |
headerbg |
Header cell background colour | headerbg="#99CCCC" |
databg |
Data cell background colour, a comma seperated list | databg="#C8CB8F,#DBDDB5" |
tableborder |
Table border width (pixels) | tableborder="2" |
cellpadding |
Cell padding (pixels) | cellpadding="0" |
cellspacing |
Cell spacing (pixels) | cellspacing="3" |
Num | Status | Action | Who | When | Progress |
---|---|---|---|---|---|
1 | C | Chose new colours | John | 1-Dec-02 | |
2 | X | Release | John | 1-Apr-02 | |
3 | Get feedback | Anne | 1-Feb-02 | ||
12 | C | Spec error handling | Jack | 1-Dec-02 | |
5 | Abc | John |
**%TOPIC%.zip**
in your twiki installation directory. Content: File: | Description: |
---|---|
data/TWiki/%TOPIC%.txt |
Plugin topic |
data/TWiki/%TOPIC%.txt,v |
Plugin topic repository |
lib/TWiki/Plugins/%TOPIC%.pm |
Plugin Perl module |
pub/TWiki/%TOPIC%/diamond.gif |
Diamond symbol |
pub/TWiki/%TOPIC%/down.gif |
Down arrow |
pub/TWiki/%TOPIC%/up.gif |
Up arrow |
Plugin Author: | [[TWiki/JohnTalintyre]] |
Plugin Version: | 06 Dec 2001 |
Change History: | 06 Dec 2001 PTh: Fixed date sorting bug 03 Dec 2001 PTh: Fixed sort="off" bug and more 29 Nov 2001: PTh fixed Perl warnings 16 Nov 2001: PTh added table border, cell spacing, cell padding, gif files 07 Oct 2001: Initial version |
CPAN Dependencies: | none |
Other Dependencies: | none |
Perl Version: | 5.0 |
Plugin Home: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC% |
Feedback: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev |