Setting up voting for applications in Good Grants is easy and can be done in a few simple steps:
- A reviewing round to control the access period
- A voting score set to record votes
- A role for people that can vote (optional, depending on who will be voting)
- A panel to assign who can vote on which applications
Step 1: Set up a reviewing round
- Go to Settings > Rounds
- Create a new round, setting the type to Reviewing
- Set start and end dates for the voting period
For more detailed instructions, see Round configuration.
Step 2: Create a voting score set
- Go to Reviewing > Score sets
- Create a new score set, setting the reviewing mode to Voting
- The score set name is used in the left menu if there is more than one voting score set active at the same time— otherwise, the name is just for reference
- Voting configuration options include:
Maximum votes per user
Limit the number of votes a user can make across all applications.
Maximum votes per application
You can allow users to submit multiple votes per application, up to the maximum. Set this to 1 if you only want one vote per user per application.
Maximum votes per category
Limit the number of votes a user can use in each category.
Votes can be revoked by users
You can allow a user to revoke a vote they make. With this active, when a vote is made, an Unvote button appears on the application view.
Total votes per application visible to all users
You can allow the total number of votes for each application to be visible to participants, or keep it secret.
List length default
You can choose the number of applications your voters see in their list view. This setting makes it easier for voters who have a lot of applications to view everything at once. Options include 10, 25, 50, and 100 applications per page.
You can choose from Masonry (original image proportions) or Square (images cropped to square) layouts depending on your program's needs.
Registered users can comment
You can permit users to comment on applications. This is only an option for registered users, to avoid spamming and trolling.
Users can see each others' comments on this score set
To encourage dialogue, you can activate commenting and allow comments to be visible to all users.
Step 3: Configure a role for voters
This is optional and depends on who you want to be able to vote. Options include for example:
- Your account is configured with a guest role by default. The guest role allows you to configure voting by unregistered visitors. This voting option has the least legitimacy as it is open to vote fraud by e.g. users deleting cookies from their browser. See more about guest reviewing configuration.
- Allow voting by existing registered users, such as applicants or reviewers. Users with an already activated account can easily be given access to vote.
- You might want to invite the general public to vote, but require registration, which entails account activation, confirming a valid and unique email address. For this purpose, you could configure a voter role with a registration form for this role and permissions exclusively for voting.
- Go to Settings > Roles
- Click on the role you want to enable voting for, or add a New role to create a dedicated voter role
- To be able to vote, the role needs to be given Scores (own) Create, View, Update and Delete permissions (i.e. set to Allow)
- If you want the general public to be able to see applications, but not vote without registering, give the guest role the Score (own) View permission only (i.e. don't give them the create and update permissions— that allows them to vote)
If you are creating a dedicated voter role, you will also need to configure a role registration form and provide information in a content block on the voting page about the registration requirement, linking to the role registration form.
Step 4: Create a voting panel
- Go to Reviewing > Panels
- Create a New panel
- Choose Voting as the reviewing mode, and select the score set created earlier
- In the Applications section, check the categories / chapters / tags for applications that can be voted on.
- In the Who section select who will be allowed to vote. If you have configured a role to vote, select 'Any users with a role' and then check the role.
- In the When section, check the round configured earlier, for when voting will be permitted.
Once all the above is done, refresh the page and if the voting reviewing round is currently open, you will see a Voting link in the navigation.
If you have allowed the general public to see applications but not vote on them, you can promote the target of that voting link as the voting destination URL in your vote marketing.