Polls (pun_poll)

PunBB 1.3 official extension

• Status: Under development
• Current version: 1.1

Allow users to create/vote in polls on a topic creation/viewing page.

Creation of poll

• User can create poll, when new topic created.
• User should enter question of poll and answers.
• To determine when poll will be finished you can enter a count of days (field “Run poll for (days)”) or a maximum count of votes (field “Votes count”).
• Also there is two options:
  1. Option that enable seeing of votes results for unvoted users
  2. Option that allow vote change.
• Poll will not create if
  • length of question less than 5 symbols
  • length of answer less than 2 symbols
  • count of answers less than 2
  • user don't enter count of days or maximum count of votes after what poll will be finished.

Viewing of poll

• A poll form is shown if
  • a user haven't voted
  • a user have voted, but user can change vote.
• Poll results are shown if
  • a user haven't voted
  • a user have voted, but unvoted user can see results of voting.

Editing of poll

• User can edit poll at edit.php.
• User can reset voting results or remove voting.
• Administrator of Forum can edit or add questions and answers.

Administrator settings

• All admin settings at the “admin/options.php?section=features” page the “Poll settings” part.
• Option that allow change vote for users, that have voted.
• Maximum number of answers.
• Option that allow seeing results for unvoted users.

User groups settings

• For each user group there is parameter that allow to create new voting.
• Guests can't to vote or create new poll.

DB schema

• Table “questions”
  • Needed for storing questions and options for poll.
  • Fields:
    1. topic_id (primary key)
    2. question
    3. read_unvote_users
    4. revote
    5. created
    6. days_count
    7. votes_count.
• Table “answers”
  • Needed to store answers.
  • Fields:
    1. id (primary key)
    2. topic_id
    3. answer.
• Table “voting”
  • Needed for storing results of voting.
  • Fields:
    1. id (primary key)
    2. topic_id
    3. user_id
    4. answer_id.
• Field “g_poll_add” was added to table “groups”.
• Keys “p_pun_poll_enable_read”, “p_pun_poll_enable_revote”, “p_pun_poll_max_answers” were added to table “config”.

Trac ticket: #28

Not work:

• button “Submit opinion”
• altering the number of votes in a poll on topic creation

Correct:

• markup/styles
• approve all the messages/text strings
• arrange comments (use your brain and approve translation too)
• name variables

• Add possibility of previewing poll
• Add an option to allow to choose more than one answer. Say parameter N is the max number of answers that a user can choose, N=1 being the default.
• An option to see who voted how. Say, at the results page under each option add a list of users who chose this option.
• Move all poll-related fields below “Submit” and “Preview” buttons so that when starting a new topic without a poll (which happens much more often than with a poll), user don't have to scroll down for those buttons.
• The results should include total number of votes (say, as an extra “Total” line in the results table).

Please, add your requests here.