E-Democracy system

This is a draft of Tutorial about using Tiki as a base for an electronic democracy system, to help people like in http://unitedindividuals.org June 2007.

see also: The World Parliament Experiment

1. Submitting proposals through using Wiki pages and their rating system

You need to have select the checkboxes:

• Rating, under "Admin > Wiki"
• Polls, under "Admin > Features"

Check that registered (or anonymous, whatever you prefer) have the global permission to view and vote ratings (set that to your choice). And you can modify that with local permissions on individual objects (review Permissions Settings , if needed).

Then you need to create a poll template under "Admin > Polls" (tiki-admin_polls.php - option in the main application menu, under the admin section):

...and add some options to this poll template:

Later on you will be able to select this poll template at wiki edition time.

And then, you'll be able to see the results from that rating on that page, or you'll be able to rate that page (if you have enough permissions).

You'll see the "Rating" box on the top right corner of the page.

Clicking on that box, you'll see the current results of the poll votes:

And after clicking on the vote link (on top of the box), you'll be able to insert your vote to that page through that poll.

Select an option ("Good" at the screenshot) and click on the vote button. This will record your option, and after you go to see the results again, you'll see:

And whenever another person rates the page, you'll see your option highlighted (in yellow in tikineat.css theme style), but not the options of the other users ("Very good", in this screenshot).

1.1 Discussing proposals through using votable comments on Wiki pages

Once a wiki page is created, containing a proposal, for instance, users could discuss arguments for and against that proposal. This could be implemented using the comments feature on wiki pages (check that it's enabled under "Admin > Wiki" in your Tiki site).

You could add a new thread called "Arguments for that proposal", and another thread called "Arguments against that proposal". Replies to these two threads could be added by users, and a user could vote on other users comments. See the following example:

1.2. Discussing proposals through votable forums posts and replies

This is something very similar to the previous case of threaded and votable wiki page comments.

At forum creation (or edition) time, you have to select that posts can be rated, so that users can rate other users posts

2. Submitting proposals through using Trackers and their rating system

Create a new tracker with "rating" selected

Add some tracker fields, like the ones in the figure:

Nowadays, you can go to the tracker, from "Trackers > List Trackers", and select your tracker from the list ("Proposals" in this example). You'll see the insert form:

Fill in the tracker with some items, and rate the tracker items. For instance:

At this stage, you can also use some wiki plugins: TRACKER and TRACKERLIST plugins.

Let's see how can they be used, for instance. In a wiki page, we can add:

{TRACKER(trackerId=>1, fields=>1:2:3, action=>Name of submit button, showtitle=>y, 
showdesc=>y, showmandatory=>y, embedded=>y)}Notice to users when submitting 
the tracker item{TRACKER}

This would produce (just below the "Register WPE with the People's Congress", starting with a title bar called "Proposals", which is the tracker title):

And the TRACKERLIST plugin can be used like in here:

!!! Proposals with high agreement
{TRACKERLIST(trackerId=>1,fields=>1:2:3, showtitle=>y, showlinks=>y, showdesc=>y, 
showinitials=>y, showstatus=>y, status=>opc, max=>10, filterfield=>3, filtervalue=>5, 
exactvalue=>5)}Notice to users{TRACKERLIST}

Which would produce this filtered list on the wiki page itself:

3. Using the PluginProposal

In Tikiwiki 3.0 a new PluginProposal was introduced.

! Plugin Proposal

This Wiki Plugin provides a widget for users to vote on a proposal and view the current decision (added in version 3.0).

• It makes it quick to vote and tally votes
• The proposal and votes are kept in the wiki page so it's still possible to improve the original proposal and to change the votes (there is wiki page version history so everyone can see the evolution).
• Note that a user must have edit rights to the page where the proposal is placed in order to be able to see the vote buttons and be able to click on them to vote.

Table of contents

• E-Democracy system
  • 1. Submitting proposals through using Wiki pages and their rating system
    • 1.1 Discussing proposals through using votable comments on Wiki pages
    • 1.2. Discussing proposals through votable forums posts and replies
  • 2. Submitting proposals through using Trackers and their rating system
  • 3. Using the PluginProposal
  • Usage
  • Example
  • Related Pages

Usage

To display in a wiki page, use the syntax:

{PROPOSAL(caption="Here is the proposal")}
+1 Sam
-1 john
+1 Suzy
+1 Cuong
0 Sam
+1 Helen
+1 Majid
+1 Mohammed
0 Francois
+1 Youssou
+1 Nico

0 stefbrodu{PROPOSAL}

Note

Do not use the plugin notation shortcut - {PROPOSAL(caption="xx") /}{PROPOSAL} - as it will not work.

Parameter	Accepted values	Default	Effect	Required?	Since
caption	any text string	none	This is the text of the proposal that displays above the vote box	no

Example

As users vote by clicking the accept, reject or undecided button, the user's user name and vote is automatically placed in the code. Once several people have voted, the code would look something like this:

{PROPOSAL(caption="That each Tiki contributor should get free pizza on their birthday")}
+1 Sam
-1 john
+1 Suzy
+1 Cuong
0 Sam
+1 Helen
+1 Majid
+1 Mohammed
0 Francois
+1 Youssou
+1 Nico
{PROPOSAL}

Would produce:

That each Tiki contributor should get free pizza on their birthday

Accept	Undecided	Reject
7	2	1
Suzy Cuong Helen Majid Mohammed Youssou Nico	Sam Francois	john

Comment

You can see in the code above that user Sam voted twice: the first time he accepted the proposal (+1 Sam), and then he changed his vote to undecided (0 Sam). In the display result immediately above, only the last choice (undecided) shows.

Related Pages

• Wiki Plugin
• Mods Type Wikiplugins
• Tutorial: E-Democracy System
• Source code

Aliases

Plugin Proposal | Proposal