======= BTable Plugin ======

---- plugin ----
description: Helps to note the attendance of people for meetings or courses.
author     : Oliver Horst
email      : oliver.horst@uni-dortmund.de
type       : syntax
lastupdate : 2007-12-08
compatible : 
depends    : 
conflicts  : 
similar    : doodle
tags       : attendance, boolean choices, doodle, export
----

This plugin is based on the [[plugin:doodle|doodle]] plugin and extends it with support for CSV export and the ability to predefine not only columns, but also rows.



===== Description =====

This [[plugins|plugin]] can help your team to schedule meetings or making other decisions in a team. The syntax looks like this:

  <btable [id]>
    <columns>
      ^ [column] ^ [column] ^ ... ^
    </columns>
    <rows>
      ^ [row] ^ [row] ^ ... ^
    </rows>
  </btable>

That means, you can simply put a ''%%<btable>%%'' tag on the page and gets a fully selectable boolean table with export functionalities.

^ [id]     | the ID of the btable; must be unique((If it is not, metadata of the btable with the same id gets mixed up, i.e. answers to choices in a previous btable appear in the new when the choices are the same.)); appears as title | required |
^ [column] | an option for which users can tick a checkbox whether it's 'true' or not ('false') | required |
^ [row] | an option which users can select from a combobox to insert boolean values for it | required |

You can see this plugin in action [[http://home.edo.uni-dortmund.de/~horst/btable|here]].


===== Download & Installation =====

You can download and install the [[http://home.edo.uni-dortmund.de/~horst/btable/media/btable.zip|btable.zip]] (16 KB) with the [[plugin:plugin|plugin manager]].

===== Source Code =====

As the source code is included in the file above, please download [[http://home.edo.uni-dortmund.de/~horst/btable/media/btable.zip|this]] to view the source code.


===== Languages =====

Currently only German (de), English (en) and Italian (it) translations are available. Feel free to translate it to another language and send it back to [[oliver.horst@uni-dortmund.de|me]] and I will add it to the release!

===== Revision History =====

  * **2007-12-08**:
    * added italian translation - //thanks a lot to Hirzel Settantacinque//
    * added plugin confugration section
      * allow only some groups of users to change/add columns
      * choose the percentage above which a 'ratio' column entry gets green
      * choose to display the 'ratio' column and/or the export link
  * **2007-10-15**:
    * first version

===== Discussion =====


===== Feedback =====
  * Great Plugin! Thank you! //Fred - 20071130//
  *Agreed! Is it possible to modify to include non-predefined rows?  \\ And could there be an option to limit the user to one check box per row?  Thanks //Bob - 20071209//


------------------------------
  * **Bug with dokuwiki 2008-05-05**
Warning: ksort() expects parameter 1 to be array, boolean given in /../wiki/lib/plugins/btable/syntax.php on line 192

used code:
   \\
  <btable Testanfrage: Palmenfest in der Karibik am 16.06 bis 29.08>
    <columns>
      ^ JA ^ NEIN ^ unsicher ^
    </columns>
    <rows>
      ^ siggi ^ Andreas ^ Tomatensaft ^
    </rows>
  </btable>

  * Deleting entries does not seem to work for anything except Mozilla Firefox.\\ Tried Internet Explorer and Opera  //Marcin - 20080707//