======= Doodle Plugin ======

---- plugin ----
description: Helps to schedule meetings or making other decisions in a team. (previous authors: Esther Brunner)
author     : Jonathan Tsai
email      : tryweb@ichiayi.com
type       : syntax
lastupdate : 2008-05-20
compatible : 
depends    : 
conflicts  : 
similar    : 
tags       : decision, schedule, doodle
----

The idea is stolen from [[http://www.doodle.ch|Doodle]] by [[naef@acm.org|Michael Näf]].

^ Download | http://svn.ichiayi.com/opensvn/opentrysoft/dokuwiki/plugin/doodle.zip |

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

  <doodle [id]>
  ^ [choice] ^ [choice] ^ ... ^
  </doodle>

That means, you can simply put ''%%<doodle>%%'' tags around regular table header to get a check box table with different choices.

^ [id]     | the ID of the doodle; must be unique((If it is not, metadata of the doodles with the same id gets mixed up, i.e. answers to choices in a previous doodle appear in the new when the choices are the same.)); appears as title | required |
^ [choice] | an option for which users can tick a checkbox whether it's okay for them or not | required |

You may also add more optional parameters...

  <doodle [disable] [single] [login]| [id]>
  ^ [choice] ^ [choice] ^ ... ^
  </doodle>

^ [disable]| view the result(cannot vote) |
^ [single] | only can check one choice |
^ [login]  | voter must login first & use fullname to be voter name |

You can see this plugin in action [[http://www.ichiayi.com/wiki/tech:dokuwiki:plugin:doodle:demo|here]].

===== Installation Notes =====
When the [[blog]] plugin is also installed, you need to turn ''$conf['plugin']['blog']['useifmodifiedsince']'' off. I will make sure this incompatibility is still exist or not.
===== Languages =====

The "Submit" Button needs to be translated to other languages. Currently only Catalan (ca), German (de), English (en), Spanish (es), French (fr), Hungarian (hu), Italian (it), Dutch (nl), Swedish (sv) and Traditional Chinese (zh-tw) are available. [[tryweb@ichiayi.com|Send us]] your translation or put below!

==== English ====
<code php>
<?php

$lang['btn_submit'] = 'Submit';

//Setup VIM: ex: et ts=4 enc=utf-8 :
?>
</code>

==== Catalan ====
<code php>
<?php
/**
 * translation by Raimon  <gwindor@auna.com>
 */

$lang['btn_submit'] = 'Envia';

//Setup VIM: ex: et ts=4 enc=utf-8 :
?>
</code>

==== German ====
<code php>
<?php

$lang['btn_submit'] = 'Abschicken';

//Setup VIM: ex: et ts=4 enc=utf-8 :
?>
</code>

==== Traditional Chinese ====
<code php>
<?php

$lang['btn_submit'] = '送出';

//Setup VIM: ex: et ts=4 enc=utf-8 :
?>
</code>

==== Swedish ====
<code php>
<?php
 
$lang['btn_submit'] = 'Skicka';
 
//Setup VIM: ex: et ts=4 enc=utf-8 :
?>
</code>


==== Dutch ====
<code php>
<?php
 
$lang['btn_submit'] = 'Verstuur';
 
//Setup VIM: ex: et ts=4 enc=utf-8 :
?>
</code>

==== French ====
<code php>
<?php

$lang['btn_submit'] = 'Envoyer';

?>
</code>

==== Italian ====
<code php>
<?php

  $lang['btn_submit'] = 'Invia';

?>
</code>

==== Spanish ====
<code php>
<?php

  $lang['btn_submit'] = 'Enviar';

?>
</code>

==== Hungarian ====
<code php>
<?php

  $lang['btn_submit'] = 'Szavazok';

?>
</code>

===== Further Resources =====
  * [[http://svn.ichiayi.com/opensvn/opentrysoft/dokuwiki/plugin/doodle|SVN Repository]]
  * Click here to download the [[http://svn.ichiayi.com/opensvn/opentrysoft/dokuwiki/plugin/doodle/syntax.php|syntax.php]] file

===== Discussion =====

==== Delete Lines ====

Hi, great job! :-) But I have a problem.

How I can delete lines in an existing doodle? E.g. if somebody did a joke by writing nonsense in the name.

Thanks,
Christian

> You can uncheck all choices of the line, it will not show on doodle. (It's not Really delete lines, but can meet your requirement) --- //[[tryweb@ichiayi.com|Jonathan Tsai]] 2008-03-03 21:55//


==== Configuration ====

How hard would it be to configure **doodle** plugin to have this functionality:
  * Show VoteCount if Configuration Parameter (such as conf['doodle_show_vote_count']) is TRUE.
  * Show VoteDate beneath the Yes GreenIcon if Configuration Parameter (such as conf['doodle_show_vote_date']) is TRUE.

This plugin would become very useful to my team if each person would be tagged with the date of the vote and if the count wouldn't show up (since we're aiming at using it as a Go-No-Go tool).  --- //[[jose.monteiro@dowedo-it.com|José Carlos Monteiro]] 2006-04-21 21:03//


==== Options ====

Is there any chance of incorporating Jonathan Tsai's changes into the plugin (rather than forking it) to ensure future changes are included and details are recorded on this page, particularly as his site is not written in English.  The single/disable/login options are really useful.

Also, the ability to delete (erroneous) rows would be useful (ref Christian's request) in a similar way to [[http://www.dokuwiki.org/plugin:btable|btable]]. This could be limited to an administrator or logged in user.

Thanks, Bob (28 Nov 2007)

> Bob,
> Last month I got a mail from Chi, ... and now I am being the doodle plugin maintainer.. :-P
>  --- //[[tryweb@ichiayi.com|Jonathan Tsai]] 2008-03-03 21:55//
==== Yes / No / Ifneedbe -polls ====

Great plugin! It would be nice to have a "maybe" or "if nothing else works"-option, like in [[http://doodle.ch/participation.html?pollId=qgp2cy79u72xm9p9|the "powerdoodle"]] of doodle.ch. Oh, and I added Swedish translation to the submit-button.
- //[[erik@vindar.se|Erik H]] 2008-03-12 13:45//

I'd like to see this option too - //[[id2ndr at crocobox org|Id2ndR]] 2008-03-12 13:45//

Sure this could be a good idea, but keep your design which is way nicer than powerdoodle :) - // fr32c 2008-09-10 10:49//

==== If title string with dot, it cannot work  ====
**The issue is fixed on 2008-05-20**  --- //[[tryweb@ichiayi.com|Jonathan Tsai]] 2008/05/20 05:55// \\

<del>Siegfried Schnapka report that :\\
I get no answerline; results... \\
Working with DokuWiki current release 2008-05-05. \\
After "submit" the choice is lost, and it happens nothing more \\</del>

<del>>I will try to fix it soon.  --- //[[tryweb@ichiayi.com|Jonathan Tsai]] 2008/05/14 04:19//</del>

>> After tracing the source code, I found the issue is from title string with dot. In your case, the title string is \\ "Testanfrage: Palmenfest in der Karibik am 16.06 bis 29.08". It will be transformed to \\ "Testanfrage:_Palmenfest_in_der_Karibik_am_16_06_bis_29_08"; however, \\ "Testanfrage:_Palmenfest_in_der_Karibik_am_16.06_bis_29.08" should be right.\\
>>The issue is fixed on doodle-2008-05-20 version(Use md5 encoding to solve it). Old meta_doodle files are also renamed automatically to meet the new version. \\ --- //[[tryweb@ichiayi.com|Jonathan Tsai]] 2008/05/20 05:55//

==== Where is the ''$conf['plugin']['blog']['useifmodifiedsince']'' ====

:?: I have searched in the blog plugin and in the doodle plugin, but I don't found the ''$conf['plugin']['blog']['useifmodifiedsince']'' anywhere. :?:

==== Multi-line text in headers ====
What about to enable more lines in headers? Doodle results with more words in header ( especially time&date ) would be more readable.

//Example://
^Name^  08-01-01\\ 9:00  ^  08-01-01\\ 12:00  ^  08-01-02\\ 9:00  ^  08-01-02\\ 12:00  ^
|Name1|  y  |  n  |  n  |  n  |
|Name2|  n  |  n  |  y  |  y  |

//Quick patch: //

Replace line 124 in ''syntax.php '':
  $renderer->doc .= $renderer->_xmlEntities($options[$i]);
by:
  $renderer->doc .= str_replace('\\\\','<br/>'.DOKU_LF,$renderer->_xmlEntities($options[$i]));

I'm not familiar with PHP at all, this is only dirty code "that works". Also centering multiline text in header would be nice.\\ --- //Martin 2008/09/25 13:40//

==== Muti Vote Please ====
FIXME
**Hi I need a Multivote like this, can this be done?? Voting 2times is not intuitive enough for users. Thanks**
^Name^  Mo  ^  Tu  ^  Wed  08-01-02^  Thu  ^
|Name1|  y  |  n  |  n  |  n  |
|Name2|  n  |  n  |  y  |  y  |
^Name^  08-01-01\\ 9:00  ^  08-01-01\\ 12:00  ^  08-01-02\\ 9:00  ^  08-01-02\\ 12:00  ^
|Name1|  y  |  n  |  n  |  n  |
|Name2|  n  |  n  |  y  |  y  |

==== Alternate Syntax Suggestion ====

To be more consistent with a another plugin I have installed on my wiki([[plugin:userpoll]]), it'd be nice if this doodle plugin supported the following alternate syntax:

  <doodle [id]>
    * [option]
    * [option]
    * ...
  </doodle>

This also seems to be more consistent with a list of choices.

==== Require Login by Default ====

Perhaps as an option on the config page, it'd be nice if the **[login]** option was able to be set as always on. My wiki is on an intranet so everybody who would be responding has an account.