Emiyashirou
New Member
On my board (USS Enterprise, NCC-1701-D), we get many comments daily or weekly on many different topics and there are so many topics in the community that to be honest, we had a tough time remembering the topic being reviewed to offer a timely comment or response. Obviously, we needed a weekly/monthly topic nomination system with which we could get our community to commit to one topic as a group and then comment on it during the course of the week/month.
Cruising vB.org at warp speed, I failed to find a nomination system readily available. Hence, I quickly wrote this mod (on my way to the bridge).
Acknowledgement:
This release would not have been quickly possible without the existence of most hacks released at vB.org, especially the "Thank You" hack by Abe1, which provided this mod basis structure. Our thanks and all the merit goes to Abe1.
A nice set of button and awards images have also been kindly provided by PrinceEdward to whom we also extend our thanks.
Many constructive feedbacks have been given by those members at the vB.org community who downloaded the first releases of this Mod, the implementation of which has led to an improved version of the Mod. We extend our thanks to those members.
What this mod does
It adds a "Topic Of The Week/Month" nomination system to your community.
What is Topic Of The Week/Month?
Topic of the Week/Month is a contest that select posts on which your community can commit to as a group and then comment/discuss on them during the course of the selected week/month. Any listed topic (post, thread) is eligible for the Topic of the Week/Month selection.
What determines a Topic Of The Week/Month?
Topic Of The Week/Month is based on a simple nomination system. Throughout the selected forums, members with adequate permissions can nominate their favorite topic by clicking on the award nomination button below the post.
The five topics with the most votes during the course of the week/month are automatically displayed on a nomination thread including a poll feature. At the end of the week/month, the first three topics with the most votes are the award winners of the contest.
Features:
1. Uses AJAX technology.
2. Uses one query per show thread page
3. Fully phrased to allow (language translation) (addition v 1.3)
4. Places an easy to use "Nominate Post" button next to the edit button
5. Automatically create a nomination thread for discussions on nominees
6. Displays a varying nomination stamps on posts that have been nominated for the contest. The color of the nomination stamps varies depending on how many users have nominated the post. (addition v 1.2)
7. Displays an award winner stamp op award winner posts at the end of the Topic Of The Week/Month contest. (addition v 1.2)
8. Via postbit pop-up, displays link to find all nominations or nominees made by a user (addition v 1.35)
9. Via postbit pop-up, allows selected usergroups (e.g. Moderators or SuperModerators) can withdraw all user’s nominees from all posts (addition v 1.2) or to remove all current nominations on a given user (addition v 1.35)
10. Option to select the maximum number of topics that must be displayed in the poll (addition v 1.2)
11. Option to take or not into account for nomination only posts made during the month preceding the nomination cycle time (addition v 1.2)
12. Option to consider the maximum number of posts a user can nominate per cycle time (addition v 1.2)
13. Nominated posts titles hot linked in the poll to actual thread/post of the forum. Links displaying on the same page (No. popups) (addition v 1.3)
14. Automatically closes the nomination thread at end of the contest cycle time (weekly/monthly)
15. Quick link to nomination thread via the "Quick Navigation" menu
16. Quick link to award winners page via the "Quick Navigation" menu (addition v.1.1)
17. Automatically update the nomination poll whenever a post is nominated or withdraw from the contest.
18. Separate looks for postbit and postbit_legacy
19. Places all post nominees in one small box
20. Displays award winners in one small box
21. Quick link to nomination thread via the "small box" on the thread page
22. Option to allow award winners to re-enter the contest after X days
23. Users cannot nominate the same post twice
24. Option to not allow users to nominate their own post
25. Counts nominees submitted by a user
26. Counts how many times a nominee is submitted
27. Shows how many nominees a user submitted in every post of his
28. Shows info in member's profile
29. Option to search for posts nominated by a user
30. Option to search for all nominated posts
31. Administrator can withdraw all nominees of a single post
32. Selected usergroups (e.g. Moderators or SuperModerators) can withdraw all nominees of a single post (addition v 1.10)
33. Users can withdraw their own nominee
34. Option to disable the mod on selected forums
35. Option to disable the mod on all but the first post of a thread
36. Option to disable the mod on all but the first post of a thread in specific forums
37. Option to enable/disable view of nomination date on specific or all forums
38. Option to add to post count when someone nominate a post.
39. Option to give reputation points to the user whose post is nominated.
40. Option to ban selected usergroups from using the mod
41. Option to ban selected users from using the mod
42. Option to display user’s nomination statistics on postbit (addition v 1.10)
43. Option not to display nomination statistics on postbit for selected users (addition v 1.10)
44. Option to display or not the hall of fame link in Quick-Links (addition v 1.3)
45. Option to select forums on which nominations must be considered (addition v 1.35)
46. Hall of fame re-designed to handle a Top 10 award winners, all time cumulated (addition v 1.3)
47. Option to refresh the poll thread if for some reason a post referenced in the poll came to be deleted (addition v 1.3)
48. Option to use the current week number or month, or the next week number or month, in the contest title (addition v 1.3)
49. Option for archiving nominations in the "Nomination Thread" automatically whenever a user nominate a post. (addition v 1.35)
50. Option to automatically send a PM to award winners at the end of the contest (addition v 1.4)
51. Option to automatically add points to award winners’ reputation at the end of the contest (addition v 1.4)
52. If the current “Nomination Thread†is deleted for whatever reason, a single manual run of the cron file will suffice to create a new thread, avoiding a clean install of the product.
Installation instructions
Version 1.40
1. Uncompress the archive
2. Upload the content of the "upload" folder into your forum root directory
3. Import the "product_nominate_topic.xml" product via your ACP:
ACP -> Plugins & Products -> Manage Product -> Add/Import Product (Allow Overwrite if you are upgrading)
4. Adjust the mod settings as you see fit.
Specify the Forum ID that will receive nomination threads. Also specify the User ID of the nomination thread owner.
ACP -> vBulletin Options -> vBulletin Options -> Nominate Topic Mod
5. Save the specified settings
6. ACP -> Scheduled Tasks -> Scheduled Task Manager
Nominate Weekly Or Monthly Topic Mod -> Run Now
Enjoy
Update in version 1.01
Nominated posts titles hot linked in the poll to actual thread/post of the forum
Update in version 1.1
1. Postbit_legacy fixed
2. Quick link to award winners page via the "Quick Navigation" menu
3. Selected usergroups (e.g. Moderators or SuperModerators) can withdraw all nominees of a single post
4. Option to display user’s nomination statistics on postbit
5. Option not to display nomination statistics on postbit for selected users
6. Small bugs fixed
7. Tested on vB 3.7.0 and vB 3.7.2
8. Working on vB 3.6.8 and above
Update in version 1.2
1. Displays a varying nomination stamps on posts that have been nominated for the contest. The color of the nomination stamps varies depending on how many users have nominated the post. (addition v 1.2)
2. Displays an award winner stamp op award winner posts at the end of the Topic Of The Week/Month contest. (addition v 1.2)
3. Via postbit pop-up, displays link to find all nominations made by a user (addition v 1.2)
4. Via postbit pop-up, allows selected usergroups (e.g. Moderators or SuperModerators) can withdraw all user’s nominees from all posts (addition v 1.2)
5. Option to select the maximum number of topics that must be displayed in the poll (addition v 1.2)
6. Option to take or not into account for nomination only posts made during the month preceding the nomination cycle time (addition v 1.2)
7. Option to consider the maximum number of posts a user can nominate per cycle time (addition v 1.2)
Update in version 1.21
1. Fix for transition to Week 28 on cron file
2. Fix Unknown column error when adding a nomination.
3. Few bugs on withdraw nomination
Feedback are welcome and implementation of constructive suggestions will likely be carried out during weekends only, as I am kept busy with other matters during working days.
Update in version 1.22
1. Fix Duplicate entry issue.
2. Clean cron file
3. Full phrasing for those who wish to translate it.
Update in version 1.3
1. Nominated posts titles hot linked in the poll to actual thread/post of the forum. Links displaying on the same page (No. popups) (addition v 1.3)
2. Option to display or not the hall of fame link in Quick-Links (addition v 1.3)
3. Option to select only one forum on which nominations must be considered (addition v 1.3)
4. Hall of fame re-designed to handle a Top 10 award winners, all time cumulated (addition v 1.3)
5. Option to refresh the poll thread if for some reason a post referenced in the poll came to be deleted (addition v 1.3)
6. Option to use the current week number or month, or the next week number or month, in the contest title (addition v 1.3)
7. Fully phrased to allow language translation (addition v 1.3)
8. Cron file up-to-date
Update in version 1.35
1. Option to select forums on which nominations must be considered
2. Option for archiving nominations in the “Nomination Thread†automatically.
3. Fortnightly cycle time added
4. Fully phrased to allow language translation (addition v 1.35)
5. Few reported bugs fixed
Update 14/07/2008 in cron file
I noticed that some code instructions fail to work properly depending on the PhP version been used.
If you are running the v 1.35 and TOTW on a weekly basis and if for some reason, your cron file failed to work and create a new nomination thread on Sunday 13, July 2008, please use the attachment "updated-cron-14-07-2008.zip". The instructions are given in there.
Update in version 1.40
1. Option to automatically send a PM to award winners at the end of the contest (addition v 1.4)
2. Option to automatically add points to award winners’ reputation at the end of the contest (addition v 1.4)
3. If the current “Nomination Thread†is deleted for whatever reason, a single manual run of the cron file will suffice to create a new thread, avoiding a clean install of the product.
Feedback are welcome and implementation of constructive suggestions will likely be carried out during weekends only, as I am kept busy with other matters during working days.
Cruising vB.org at warp speed, I failed to find a nomination system readily available. Hence, I quickly wrote this mod (on my way to the bridge).
Acknowledgement:
This release would not have been quickly possible without the existence of most hacks released at vB.org, especially the "Thank You" hack by Abe1, which provided this mod basis structure. Our thanks and all the merit goes to Abe1.
A nice set of button and awards images have also been kindly provided by PrinceEdward to whom we also extend our thanks.
Many constructive feedbacks have been given by those members at the vB.org community who downloaded the first releases of this Mod, the implementation of which has led to an improved version of the Mod. We extend our thanks to those members.
What this mod does
It adds a "Topic Of The Week/Month" nomination system to your community.
What is Topic Of The Week/Month?
Topic of the Week/Month is a contest that select posts on which your community can commit to as a group and then comment/discuss on them during the course of the selected week/month. Any listed topic (post, thread) is eligible for the Topic of the Week/Month selection.
What determines a Topic Of The Week/Month?
Topic Of The Week/Month is based on a simple nomination system. Throughout the selected forums, members with adequate permissions can nominate their favorite topic by clicking on the award nomination button below the post.
The five topics with the most votes during the course of the week/month are automatically displayed on a nomination thread including a poll feature. At the end of the week/month, the first three topics with the most votes are the award winners of the contest.
Features:
1. Uses AJAX technology.
2. Uses one query per show thread page
3. Fully phrased to allow (language translation) (addition v 1.3)
4. Places an easy to use "Nominate Post" button next to the edit button
5. Automatically create a nomination thread for discussions on nominees
6. Displays a varying nomination stamps on posts that have been nominated for the contest. The color of the nomination stamps varies depending on how many users have nominated the post. (addition v 1.2)
7. Displays an award winner stamp op award winner posts at the end of the Topic Of The Week/Month contest. (addition v 1.2)
8. Via postbit pop-up, displays link to find all nominations or nominees made by a user (addition v 1.35)
9. Via postbit pop-up, allows selected usergroups (e.g. Moderators or SuperModerators) can withdraw all user’s nominees from all posts (addition v 1.2) or to remove all current nominations on a given user (addition v 1.35)
10. Option to select the maximum number of topics that must be displayed in the poll (addition v 1.2)
11. Option to take or not into account for nomination only posts made during the month preceding the nomination cycle time (addition v 1.2)
12. Option to consider the maximum number of posts a user can nominate per cycle time (addition v 1.2)
13. Nominated posts titles hot linked in the poll to actual thread/post of the forum. Links displaying on the same page (No. popups) (addition v 1.3)
14. Automatically closes the nomination thread at end of the contest cycle time (weekly/monthly)
15. Quick link to nomination thread via the "Quick Navigation" menu
16. Quick link to award winners page via the "Quick Navigation" menu (addition v.1.1)
17. Automatically update the nomination poll whenever a post is nominated or withdraw from the contest.
18. Separate looks for postbit and postbit_legacy
19. Places all post nominees in one small box
20. Displays award winners in one small box
21. Quick link to nomination thread via the "small box" on the thread page
22. Option to allow award winners to re-enter the contest after X days
23. Users cannot nominate the same post twice
24. Option to not allow users to nominate their own post
25. Counts nominees submitted by a user
26. Counts how many times a nominee is submitted
27. Shows how many nominees a user submitted in every post of his
28. Shows info in member's profile
29. Option to search for posts nominated by a user
30. Option to search for all nominated posts
31. Administrator can withdraw all nominees of a single post
32. Selected usergroups (e.g. Moderators or SuperModerators) can withdraw all nominees of a single post (addition v 1.10)
33. Users can withdraw their own nominee
34. Option to disable the mod on selected forums
35. Option to disable the mod on all but the first post of a thread
36. Option to disable the mod on all but the first post of a thread in specific forums
37. Option to enable/disable view of nomination date on specific or all forums
38. Option to add to post count when someone nominate a post.
39. Option to give reputation points to the user whose post is nominated.
40. Option to ban selected usergroups from using the mod
41. Option to ban selected users from using the mod
42. Option to display user’s nomination statistics on postbit (addition v 1.10)
43. Option not to display nomination statistics on postbit for selected users (addition v 1.10)
44. Option to display or not the hall of fame link in Quick-Links (addition v 1.3)
45. Option to select forums on which nominations must be considered (addition v 1.35)
46. Hall of fame re-designed to handle a Top 10 award winners, all time cumulated (addition v 1.3)
47. Option to refresh the poll thread if for some reason a post referenced in the poll came to be deleted (addition v 1.3)
48. Option to use the current week number or month, or the next week number or month, in the contest title (addition v 1.3)
49. Option for archiving nominations in the "Nomination Thread" automatically whenever a user nominate a post. (addition v 1.35)
50. Option to automatically send a PM to award winners at the end of the contest (addition v 1.4)
51. Option to automatically add points to award winners’ reputation at the end of the contest (addition v 1.4)
52. If the current “Nomination Thread†is deleted for whatever reason, a single manual run of the cron file will suffice to create a new thread, avoiding a clean install of the product.
Installation instructions
Version 1.40
1. Uncompress the archive
2. Upload the content of the "upload" folder into your forum root directory
3. Import the "product_nominate_topic.xml" product via your ACP:
ACP -> Plugins & Products -> Manage Product -> Add/Import Product (Allow Overwrite if you are upgrading)
4. Adjust the mod settings as you see fit.
Specify the Forum ID that will receive nomination threads. Also specify the User ID of the nomination thread owner.
ACP -> vBulletin Options -> vBulletin Options -> Nominate Topic Mod
5. Save the specified settings
6. ACP -> Scheduled Tasks -> Scheduled Task Manager
Nominate Weekly Or Monthly Topic Mod -> Run Now
Enjoy
Update in version 1.01
Nominated posts titles hot linked in the poll to actual thread/post of the forum
Update in version 1.1
1. Postbit_legacy fixed
2. Quick link to award winners page via the "Quick Navigation" menu
3. Selected usergroups (e.g. Moderators or SuperModerators) can withdraw all nominees of a single post
4. Option to display user’s nomination statistics on postbit
5. Option not to display nomination statistics on postbit for selected users
6. Small bugs fixed
7. Tested on vB 3.7.0 and vB 3.7.2
8. Working on vB 3.6.8 and above
Update in version 1.2
1. Displays a varying nomination stamps on posts that have been nominated for the contest. The color of the nomination stamps varies depending on how many users have nominated the post. (addition v 1.2)
2. Displays an award winner stamp op award winner posts at the end of the Topic Of The Week/Month contest. (addition v 1.2)
3. Via postbit pop-up, displays link to find all nominations made by a user (addition v 1.2)
4. Via postbit pop-up, allows selected usergroups (e.g. Moderators or SuperModerators) can withdraw all user’s nominees from all posts (addition v 1.2)
5. Option to select the maximum number of topics that must be displayed in the poll (addition v 1.2)
6. Option to take or not into account for nomination only posts made during the month preceding the nomination cycle time (addition v 1.2)
7. Option to consider the maximum number of posts a user can nominate per cycle time (addition v 1.2)
Update in version 1.21
1. Fix for transition to Week 28 on cron file
2. Fix Unknown column error when adding a nomination.
3. Few bugs on withdraw nomination
Feedback are welcome and implementation of constructive suggestions will likely be carried out during weekends only, as I am kept busy with other matters during working days.
Update in version 1.22
1. Fix Duplicate entry issue.
2. Clean cron file
3. Full phrasing for those who wish to translate it.
Update in version 1.3
1. Nominated posts titles hot linked in the poll to actual thread/post of the forum. Links displaying on the same page (No. popups) (addition v 1.3)
2. Option to display or not the hall of fame link in Quick-Links (addition v 1.3)
3. Option to select only one forum on which nominations must be considered (addition v 1.3)
4. Hall of fame re-designed to handle a Top 10 award winners, all time cumulated (addition v 1.3)
5. Option to refresh the poll thread if for some reason a post referenced in the poll came to be deleted (addition v 1.3)
6. Option to use the current week number or month, or the next week number or month, in the contest title (addition v 1.3)
7. Fully phrased to allow language translation (addition v 1.3)
8. Cron file up-to-date
Update in version 1.35
1. Option to select forums on which nominations must be considered
2. Option for archiving nominations in the “Nomination Thread†automatically.
3. Fortnightly cycle time added
4. Fully phrased to allow language translation (addition v 1.35)
5. Few reported bugs fixed
Update 14/07/2008 in cron file
I noticed that some code instructions fail to work properly depending on the PhP version been used.
If you are running the v 1.35 and TOTW on a weekly basis and if for some reason, your cron file failed to work and create a new nomination thread on Sunday 13, July 2008, please use the attachment "updated-cron-14-07-2008.zip". The instructions are given in there.
Update in version 1.40
1. Option to automatically send a PM to award winners at the end of the contest (addition v 1.4)
2. Option to automatically add points to award winners’ reputation at the end of the contest (addition v 1.4)
3. If the current “Nomination Thread†is deleted for whatever reason, a single manual run of the cron file will suffice to create a new thread, avoiding a clean install of the product.
Feedback are welcome and implementation of constructive suggestions will likely be carried out during weekends only, as I am kept busy with other matters during working days.