History: PluginConvene

            See also ((Rating)) and ((Deliberation)).

! Plugin Convene
This ((wiki plugin)), introduced in ((Tiki9)), allows users to convene a date from a list of alternatives. Users indicate their preferences and the best option is highlighted as the best date for such convention. 

{CENTER()} {img src="display706" thumb="y" width="400" rel="box[g]" link="display706" styleimage="border" desc="Click to enlarge" } {CENTER}

!! Requirements
You need to have the calendar feature enabled, and at least one calendar created for this feature to work.

!! How to use it
The first step is to call the plugin within a wiki page, either by the popup helper as usual for plugins, or directly by means of adding this text to a wiki page:
{CODE(colors="tiki")}
{convene}
{CODE}

{img src="display634" thumb="n" rel="box[g]" link="display634"   styleimage="border" }

Then, when you save the page, Tiki will check whether you have all the required tiki features enabled. If not, and in case you have admin rights, you will be offered from that page to enable those required features (PluginConvene itself  and the calendar feature)

{img src="display635" thumb="n" rel="box[g]" link="display635" styleimage="border" }

Once the required features are enabled, in that same wiki page you will be offered the option to provide the first user and date to create a new convention proposal:

{img src="display636" thumb="y" width="600" rel="box[g]" link="display636" styleimage="border" }

As user you can use any name (a registered username in Tiki or not), and for the date you will be allowed to select a date from a popup calendar with time sliders below for easy selection: 

{img src="display637" thumb="y" width="600" rel="box[g]" link="display637" styleimage="border" }

Once the selection is saved, the user will have the option to add new proposed dates for the convention/meeting by means of the icon on the left column:

{img src="display638" thumb="y" width="600" rel="box[g]" link="display638" styleimage="border" }


After the initial set of options for the convention/meeting are set, the page will look like something like this for anonymous users visiting the website:

{img src="display688" thumb="y" width="600" rel="box[g]" link="display688" styleimage="border" }

When logged in as a user with admin perms, you will see  afew other icons which allow you to keep adding new date options or new users:

{img src="display687" thumb="y" width="600" rel="box[g]" link="display687" styleimage="border" }

All data from users choices is stored in the wiki page, and therefore, there is a history of changes from which users and/or ip's, as with any other wiki page in Tiki.

Last, see again the options allowed by all icons in the pluginconvene interface:

{img src="display706" thumb="y" width="600" rel="box[g]" link="display706" styleimage="border" }

!! Custom background colors
You can use custom colors in your tiki site for the background of the cells. Example:

{CODE(colors="css" ln="1")}
.convene-ok {
    background-color: #6d6;
}

.convene-no {
    background-color: #d66;
}

.convene-unconfirmed {
    background-color: #eee;
}
{CODE}

Or even set background color to transparent (none) or white, as you wish.

!! Time zones
* Each user adds their time and date in their time zone, and it will automatically be stored as UTC time. 

!! Parameters
* A param -+dateformat+- exists to indicate that date and time has to be shown in "short" (default) or "long" formats, following the site-wide parameter specified elsewhere by the admin -+Control Panels > General > Date and time > Formats+-

{pluginmanager plugin=convene}
!!Aliases
(alias(Plugin Convene)) | (alias(PluginDoodle))  | (alias(Plugin Doodle))  | (alias(Doodle))  | (alias(PluginScheduler)) |  | (alias(Plugin Scheduler))