Requires php 7.2
Tallying a thread:
You can call the vote tally from the
thread tools dropdown, or from
your own posts (or any other post you can edit). Either way, you'll get this overlay:
Each field has a short explanation when you hover over it with your mouse.
The start and end points are where you want the tally to work on, by the post position in thread:
If the start point is left blank, the addon will attempt to tally from the last threadmark in the thread. If the end point is left blank, the addon will tally to the end of the thread. You may also select threadmarks to tally from using the dropdown menu.
Vote divison can be used to split a vote:
The last option is User-vote updating. This determines where votes by username are updated to the
latest post by a user, or by the vote at the time of posting. Namely:
With your options selected, simply hit tally and wait for a few seconds for the overlay to update!
Vote management:
You can also manage votes from the addon! In the bottom left of the overlay will be the button to activate the management menu:
From here, you can click on any vote to "pick" it up:
Clicking another vote will then register that vote as a 'sub' vote of the other one. Once you're happy with the arrangement, you can apply the mappings to the tally with the button at the bottom right, and you'll return to the original view.
You can view the management and initial conditions applied to any given vote by clicking the white i at the top right of an inserted vote.
Inserting a tally:
Inserting a tally to a post makes it so that the tally is visible to everyone viewing said post, like so:
If called from the thread tools drop down, a new post will be created under your name with the tally in it. You can also delete tallies from a post.
Important notes:
- The addon ignores formatting and capitalization for purposes of tallying. "[X] Vote" and "[x] vote" are considered the same.
- Plan votes are fully supported. These can be updated strictly by the initial plan's author, whether by editing the original plan or by creating a new post with a plan of the same name.
- [Task] votes are fully supported. This will naturally sort out the winner from each category to the top of the list.
- As a voter, you can guarantee that your vote will be for a user at the time of your posting by prefacing the username with a caret, for example, "[x] ^Username".
- If a vote marker is struck through, the struckthrough line is ignored.
- OP posts are not automatically excluded from the tally
- When the tally is called, it displays the last tally executed on the thread
- Only one tally may execute per thread, for all users. That is to say, if someone issues a tally after you, they will see the same result you do. This is for performance purposes.
- A tally takes at minimum five seconds to be returned, and varies by the number of posts that need to be processed.
Planned features:
I would like to note that ranked votes are
not currently planned, however, I'm open to feedback for more features.