Changes between Version 6 and Version 7 of EasyPollMacro
- Timestamp:
- Mar 19, 2015, 7:14:23 AM (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
EasyPollMacro
v6 v7 1 1 [[PageOutline(2-5,Contents,pullout)]] 2 2 3 = EasyPollMacro3 = Poll creation and voting plugin 4 4 5 5 == Description 6 6 7 !EasyPoll is fully featured database driven poll macro with permission control ls for voting and polls creation. Google charts has been used for showing poll results. The purpose of this macro is to provide an easy way to integrate polls with Trac wiki and ticket pages.7 !EasyPoll is fully featured database driven poll macro with permission controls for voting and polls creation. Google charts has been used for showing poll results. The purpose of this macro is to provide an easy way to integrate polls with Trac wiki and ticket pages. 8 8 9 9 Features: 10 1. Response type: Poll creator can decide the response type for polls i.e whether you want single response poll(radio button poll) or multiple response poll (checkbox button poll).10 1. Response type: Poll creator can decide the response type for polls i.e whether you want single response poll(radio button poll) or multiple response poll (checkbox button poll). 11 11 1. Google charts: Poll creator can decide which type of chart they want to use for showing poll results. 12 1. Poll options: Poll option can be any valid english string or any Ticket number from Trac (!EasyPoll will fetch summary for given ticket and use it as option text).12 1. Poll options: Poll option can be any valid english string or any Ticket number from Trac, !EasyPoll will fetch summary for given ticket and use it as option text. 13 13 1. Change vote: Poll creator can manage whether user can change their vote or not after casting it for the first time. 14 14 15 Permissions: !EasyPoll uses two type of permissions EASYPOLL_CREATE and EASYPOLL_VOTE:16 1. EASYPOLL_CREATE: User who has EASYPOLL_CREATE or TRAC_ADMIN permission can create easy polls in wiki or ticket page.17 1. EASYPOLL_VOTE: User who has EASYPOLL_VOTE or TRAC_ADMIN permission can vote on easy polls in wiki or ticket page.18 Every log in user on Trac can see !EasyPoll but can vote or create only ifuser has sufficient permissions.15 Permissions: !EasyPoll introduces the following permissions: `EASYPOLL_CREATE` and `EASYPOLL_VOTE`: 16 1. `EASYPOLL_CREATE`: User who has EASYPOLL_CREATE or TRAC_ADMIN permission can create easy polls in wiki or ticket page. 17 1. `EASYPOLL_VOTE`: User who has EASYPOLL_VOTE or TRAC_ADMIN permission can vote on easy polls in wiki or ticket page. 18 Every logged in user on Trac can see !EasyPoll, but can vote or create only if the user has sufficient permissions. 19 19 20 20 Limitations: 21 1. !EasyPoll as of now only supports asciicharacters.22 1. Don't use comma(,) while picking easy poll attributes. By design comma(,) is used as a attribute separator 21 1. !EasyPoll as of now only supports ASCII characters. 22 1. Don't use comma(,) while picking easy poll attributes. By design comma(,) is used as a attribute separator. 23 23 24 Please provide your valuablefeedback/suggestions to hi.amigo@gmail.com. I would really appreciate it.24 Please provide your feedback/suggestions to hi.amigo@gmail.com. I would really appreciate it. 25 25 26 26 == Bugs/Feature Requests … … 50 50 51 51 Attributes: 52 1. name (required): name is used as a poll identifier, if you change the name value than it will be treated as new poll.52 1. name (required): name is used as a poll identifier, if you change the name value than it will be treated as new poll. 53 53 Nowhere in the poll the name will be shown. Don't change the name of the poll after poll creation 54 2. title (required): title will be used as a poll title. You can change it whenever you want.55 3. options (required): options should be separated by colon (:) option can also have Ticket id as their option like options = #1 : #2 : #3 In this case the summary will be pulled out from the valid tickets and will be used as option text with ticket link.56 4. response (optional) : reponse can take two values (1) multiple and (2) single. Default is (2) single option.57 1. multiple 58 2. single : single reponse type will generate poll with radio buttons, in this case user can choose only one option.54 2. title (required): title will be used as a poll title. You can change it whenever you want. 55 3. options (required): options should be separated by colon (:) option can also have Ticket id as their option like options = #1 : #2 : #3 In this case the summary will be pulled out from the valid tickets and will be used as option text with ticket link. 56 4. response (optional): response can take two values (1) multiple and (2) single. Default is (2) single option. 57 1. multiple: multiple response type will generate poll with checkboxes, in this case user can choose multiple options. 58 2. single: single response type will generate poll with radio buttons, in this case user can choose only one option. 59 59 5. user_can_change_vote(optional) : user_can_change_vote can take two values (1) false and (2) true. Default is (1) false. 60 1. false 61 2. true : user can change their vote anytime and many times. Poll will always be enabled for them and they can see poll results.60 1. false: once user cast their vote, they cannot change their vote, Poll will be disabled for them, however they can see poll results. 61 2. true: user can change their vote at any time and many times. Poll will always be enabled for them and they can see poll results. 62 62 6. chart_type(optional) : chart_type can take two values (1) pie and (2) bar. Default is (1)pie. 63 1. pie 64 2. bar 63 1. pie: Pie chart will be used to show poll results. 64 2. bar: Bar chart will be used to show poll results. 65 65 User can see poll results only after casting their vote. 66 66