====== itemtable Plugin ======

---- plugin ----
description: Renders tables by using itemlists instead of the DokuWiki syntax (very helpful for big tables with a lot of text)
author     : Olaf Trieschmann
email      : develop@otri.de
type       : syntax, render
lastupdate : 2010-11-09
compatible : Lemming, Anteater
tags       : tables

downloadurl: https://github.com/otriesch/itemtable/raw/master/itemtable.zip
bugtracker : https://github.com/otriesch/itemtable/issues
sourcerepo : https://github.com/otriesch/itemtable/blob/master/source/syntax.php
----

This plugin is based on the plugin //[[dbtables]]// originally written by [[pontiac76@gmail.com|Stephen C]]. Many thanks.

===== Download and Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

  * https://github.com/otriesch/itemtable/raw/master/itemtable.zip

===== Syntax and Usage =====

<code>
<itemtable c=name,[name, ...];[options]>
.
.
.
</itemtable>
</code>

<code>
<itemtable c=Column1,Column2,Column3;fdelim=:;header=Titel-Header>
</code>

==== Options ====

^Option^Description^Format^Default^
|c=name,[name,...]|Names fields of the table which are separated by a comma; The order of the colums follows the orders how the columns are listed here | |For legacy reasons, the c{...}=colum could be listed for each individual column individually. |
|fdelim|Field Delimeter - representing how each DW-DB field is seperated |Character |:|
|header|Table Heading - representing the line in which a table name is defined |Character | |
|twidth|Width of the HTML table |integer |Undefined - Dokuwiki decides |
|norender|Outputs the DW-tables in Dokuwiki text format |Charactier |Undefined |

**Cellinput over several lines could be enclosed by the pair <tablecell> and </tablecell>.**

Note that with twidth, and norender, you must assign some sort of value, for example, ''norender=1''.

===== Examples =====

==== Standard table ====

<code>
<itemtable header=test;c=column_a;c=column_b,column_c;c=column_d;fdelim=:>

_line_a
column_a:text_a1
column_b:<tablecell>text_a2 \\ This is an example
how to fill a cell over several lines</tablecell>

_line_b
column_a:<tablecell>text_b1 \\ \\ As you can see, local DokuWiki CRLF sequences  
can be added to force a linebreak in the cell. Other formatting
elements could be used as well.
</tablecell>
column_c:text_b2 

</itemtable>
</code>

=== Result ===

{{http://img560.imageshack.us/img560/3774/itemtableexample.png|}}

==== Standard table not rendered ====

<code>
<itemtable header=test;c=column_a;c=column_b,column_c;c=column_d;fdelim=:;norender=1>

_line_a
column_a:text_a1
column_b:<tablecell>text_a2 \\ This is an example
how to fill a cell over several lines</tablecell>

_line_b
column_a:<tablecell>text_b1 \\ \\ As you can see, local DokuWiki CRLF sequences  
can be added to force a linebreak in the cell. Other formatting
elements could be used as well.
</tablecell>
column_c:text_b2 

</itemtable>
</code>

=== Result ===

^ test                                                                                                                                                                                                                                                                |||||
^         ^ column_a                                                                                                                                                       ^ column_b                                                             ^ column_c  ^ column_d  ^
| line_a  | text_a1                                                                                                                                                        | text_a2 \\ This is an example how to fill a cell over several lines  |           |           |
| line_b  | text_b1 \\ \\ As you can see, local DokuWiki CRLF sequences   can be added to force a linebreak in the cell. Other formatting elements could be used as well.  |                                                                      | text_b2   |           |


===== Suggestions / Bugs =====

  * Is there a way to put spaces in the column headings?
  * Eliminate the need for the first column as a description (i.e. no "_thing") just start with the first named column.
  * Is there a way to put one entry over multiple cells (like HTML:rowspan or colspan) ?

=== DW plugin in table ===

I would like to use the [[do|"do plugin"]] in a cell of the table:

''ToDo:<do USER DATE>TEXT</do>''

Unfortunately it will not work. The do-plugin will not write any entry in his sqlite-database.

Any idea how to get it to work? <sub>//24.08.2011 Joachim//</sub>

=== Table sortable and searchtable ===

It would be fine to have the table sortable and searchable.

I tried the following with [[searchtablejs|searchtablejs plugin]] and [[sortablejs|sortablejs plugin]], <del>but is not working</del> :!: Sorry, it is working, GREAT!:
<code>
<sortable>
<searchtable>
<itemtable .......>
......
......
</itemtable>
</searchtable>
</sortable>
</code>
<sub>//24.08.2011 Joachim//</sub>

-----

  * **Eliminate first column**: Yes, this is really what I need.
  * **Rowspan** is already possible. Just put '':::'' into the cell which you want to be "rowspaned".\\ **Colspan**: I don't know how to do it. I think an extension of the plugin is necessary to enable it.

The most severe problem I have is that the table the itemtable plugin generates is always **nested in another table** (with only one cell). Is this a problem with compatibility? I'm using Release 2012-09-10 "Adora Belle RC1".

--- //Moni 2012-10-22//


------

I too have the problem that the table is nested in another table with only one cell.


--- //DerYo 2013-10-25//