Register Members List Search Today's Posts Mark Forums Read

Reply
 
Mod Options
Topic (incl. Blog) of the Week/Fortnight/Month Nomination v1.636 Details »
Topic (incl. Blog) of the Week/Fortnight/Month Nomination v1.636
Mod Version: 1.636, by J98680Bxxxxx (Member) J98680Bxxxxx is offline
Developer Last Online: Oct 2011 I like it Show Printable Version Email this Page

This modification is in the archives.
vB Version: 3.7.x Rating: (45 votes - 4.89 average) Installs: 329
Released: 02 Jul 2008 Last Update: 07 Oct 2008 Downloads: 5002
Not Supported DB Changes Uses Plugins Auto-Template Additional Files Re-usable Code Translations  

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 not to display nomination statistics on postbit for selected usergroups (addition v 1.50)
  45. Option to display or not the hall of fame link in Quick-Links (addition v 1.3)
  46. Option to select forums on which nominations must be considered (addition v 1.35)
  47. Hall of fame re-designed to handle a Top 10 award winners, all time cumulated (addition v 1.3)
  48. Option to refresh the poll thread if for some reason a post referenced in the poll came to be deleted (addition v 1.3)
  49. Option to use the current week number or month, or the next week number or month, in the contest title (addition v 1.3)
  50. Option for archiving nominations in the "Nomination Thread" automatically whenever a user nominate a post. (addition v 1.35)
  51. Option to automatically send a PM to award winners at the end of the contest (addition v 1.4)
  52. Option to automatically add points to award winners’ reputation at the end of the contest (addition v 1.4)
  53. 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.
  54. Option to nominate blog entries (addition v 1.6)
  55. Option to have award winners or nominated posts icons displayed on posts, so that nominated posts can be easily identified when listing posts.
  56. Option to close current nomination thread and create a new one directly from the ACP

Installation instructions

Version 1.63
  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.

Update in version 1.50
  1. Option not to display nomination statistics on postbit for selected usergroups (addition v 1.50)
  2. Few display titles fixed
  3. Additions made for users who had problems displaying the nomination button and stamp on their styles. Checkout the "Readme and installation" file.
  4. Cron file completely rewritten. Why?
    The previous cron file worked fine only when they were activated manually from the Run button in the Admin CP, but they were failing to run on their own as a scheduled task. I noticed that vbulletin global variables were no longer been passed to the cron file. Why??? I have actually getting the values of vbulletin global variables needed for the cron directly from the database.
    If you noticed that the "Nomination Thread" of the past week did not closed properly, proceed as follow:
    1. Open the cron file (upload/included/cron/
    2. Search for "// $createNewThread = 1;"
    3. Replace it by: "$createNewThread = 1;"
    4. Upload the cron file and run it manually (only once), just to close the previous thread and open a new one.
    5. Upload the original cron file back (the one with "// $createNewThread = 1;")

Update in version 1.51
  1. For weekly nominations, Cron file set to create a new "Nomination Thread" every MONDAY's (00:10AM) as the week numbering starts on Monday's and not on Sunday's (as set in v 1.50)

If you are running v 1.50 with weekly cycle time and noticed that a new nomination thread has been created but the display title is still that of the previous thread (week 30), then this is for you. Do not delete the newly created nomination thread (with title week 30). On Monday 21st July, 2008, after 00:10AM, proceed as follow:
  1. Refresh your poll from the ACP -> Nominate Topic -> Refresh Poll (This will update the display title of both the poll and the nomination thread)
  2. Upload the content of the attachment v 1.51 to your root directory. (DO NOT MANUALLY RUN THE CRON FILE)


Topic of the Week-Month Nomination v1.51 Updated Prod and Cron
  1. Automatic PM subject phrase moved from "<phrasetype name="Email Subject Text" fieldname="emailsubject">" to "<phrasetype name="GLOBAL" fieldname="global">"
  2. For monthly nominations, Cron file set to create a new "Nomination Thread" every 1st day of the month (00:10AM) and not on the last day of the month.


Topic of the Week-Month Nomination v1.51 Updated function
  1. Function updated (see attachment) as a result of exchanges with Kevil via TeamViewer.


Update in version 1.60
  1. Option to nominate blog entries (addition v 1.6)
  2. Option to have award winners or nominated posts icons displayed on posts, so that nominated posts can be easily identified when listing posts.
  3. Option to close current nomination thread and create a new one directly from the ACP (NOT VIA THE CRON)

Update in version 1.61
  1. Typing mistake fixed in the "nominate_topic_admin.php". nominate_topic_amount instead of nominated_topic_amount.
  2. Fix for "Could not find phrase 'This is an automatic message to inform you that your post ..." message.


Update in version 1.62
  1. Typing mistake fixed in the "nominate_topic_admin.php". nominate_topic_amount instead of nominated_topic_amount.
  2. Fix for http:"//... occurring in the poll while listing blog entries.
  3. Display of nomination stamps while listing blog entries from the blog.
  4. Fix for displaying of blog entries in poll when a post is nominated from the non blog board.

Update in version 1.621
  1. Fixed "Parse error: syntax error, unexpected '}' in /includes/cron/nominate_topic_cron.php on line 584"
  2. Fixed ": syntax error, unexpected T_STRING in /home/nascartr/public_html/community/admincp/nominate_topic_admin.php on line 435"


Update in version 1.63
  1. Fixed link call, requested by TsirhCitna
  2. Fixed "Hall of fame" display.

Update in version 1.635
  1. Bug Fix by vbboarder implemented – ‘can’t find phrase’ error in PM subject

Update in version 1.636
  1. Default value for "cycle time header" set to use the current cycle time (current week/fortnight/month instead of next week/fortnight)
  2. Option to nominate own post activated by default.

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. Also, feel free to add improvements in those files and post them.

To other coders: feel free to add improvements to the Mod (files) and post them. I will directly use your updated files for the next version of the mod.

Download Now

Only licensed members can download files, Click Here for more information.

Supporters / CoAuthors

Screenshots

Click image for larger version

Name:	Image1.jpg
Views:	5334
Size:	79.1 KB
ID:	83362   Click image for larger version

Name:	Image2.jpg
Views:	3260
Size:	76.3 KB
ID:	83363   Click image for larger version

Name:	Image3.jpg
Views:	2372
Size:	80.0 KB
ID:	83364   Click image for larger version

Name:	Image4.jpg
Views:	2502
Size:	79.0 KB
ID:	83365  

Click image for larger version

Name:	Image5.jpg
Views:	2122
Size:	80.5 KB
ID:	83366   Click image for larger version

Name:	Image7.jpg
Views:	2280
Size:	86.2 KB
ID:	83368   Click image for larger version

Name:	Image10.jpg
Views:	2538
Size:	79.5 KB
ID:	83371  

Show Your Support

  • To receive notifications regarding updates -> Click to Mark as Installed.
  • If you like this modification support the author by donating.
  • This modification may not be copied, reproduced or published elsewhere without author's permission.
  #916  
Old 09 Oct 2008, 20:56
haytham's Avatar
haytham haytham is offline
 
Join Date: Jan 2003
Real name: Haytham
Just an idea ok. Are you guys sure you put the images in the images folder of your style? Not the images of the VB folder? Again, just an idea.
Reply With Quote
  #917  
Old 10 Oct 2008, 10:58
verino verino is offline
 
Join Date: May 2008
Originally Posted by haytham View Post
Just an idea ok. Are you guys sure you put the images in the images folder of your style? Not the images of the VB folder? Again, just an idea.
well, i just have 1 style besides the default. And yes i'm sure i have put the images in the right folder
Reply With Quote
  #918  
Old 11 Oct 2008, 04:25
Hornstar's Avatar
Hornstar Hornstar is offline
 
Join Date: Jun 2005
Real name: Matt
It says The Administrator(s) did not defined a receiving forum for hosting poll results of the TOTW/TOTM contest.

but I set the forum ID, does it take time for it to be posted?
Reply With Quote
  #919  
Old 11 Oct 2008, 05:50
vbboarder's Avatar
vbboarder vbboarder is offline
 
Join Date: Jun 2008
Arrow Bug Report & Fix: Incorrect thread titles for fortnight contests

I didn't catch this bug when I reported the fix for the incorrect thread titles for monthly contests - sorry Data. It's a similar bug caused by creating threads at the last day of the month. To fix, in the ./includes/cron/nominate_topic_cron.php file,
FIND 2 occurences of:
if (($day == 15) || ($day == $days_in_month)){
CHANGE that to:
if ($day == 15 || $day == 1) {
Reply With Quote
  #920  
Old 11 Oct 2008, 05:51
vbboarder's Avatar
vbboarder vbboarder is offline
 
Join Date: Jun 2008
Originally Posted by hornstar1337 View Post
It says The Administrator(s) did not defined a receiving forum for hosting poll results of the TOTW/TOTM contest.

but I set the forum ID, does it take time for it to be posted?
If you set it for weekly contests, then it will create the thread on Monday.

If you set it for fortnight contests, it will create the thread on the 15 or the last day of the month (will be changed to the first day in next version).

If you set it for monthly contests, it will create the thread on the 1st day.
Reply With Quote
  #921  
Old 12 Oct 2008, 11:37
Britmovie Britmovie is offline
 
Join Date: Mar 2008
On www.britmovie.net/britforum i keep getting the following permission message when trying to nominate, but I just cant see where to change it. Can anyone give me the path to the permissions for it or tell me what I missed out. Or even does it work as I have vb 3.8.0 beta 1 installed which may be the problem?
-------------------------
Long John Silver, you do not have permission to access this page. This could be due to one of several reasons:

1. Your user account may not have sufficient privileges to access this page. Are you trying to edit someone else's post, access administrative features or some other privileged system?
2. If you are trying to post, the administrator may have disabled your account, or it may be awaiting activation.
Reply With Quote
  #922  
Old 13 Oct 2008, 13:27
haytham's Avatar
haytham haytham is offline
 
Join Date: Jan 2003
Real name: Haytham
What happens if there is a tie between 2 or 3 posts? I'd also prefer if only a certain group can nominate posts up to like a max. of 5 then members would vote on these 5 posts. But now, all members may choose different posts so we can get hundreds of threads with only 1 or 2 votes. They should concentrate on only a few chosen posts. What do you guys think?
Reply With Quote
  #923  
Old 13 Oct 2008, 13:36
haytham's Avatar
haytham haytham is offline
 
Join Date: Jan 2003
Real name: Haytham
One more thing. I am the Admin. I have been nominated same as another 2 members. They got awards under their names in postbit legacy but I didn't..why is that?

I am editing my post to add an idea. What if you can add some kind of mod that would show on the main page the nominated posts. I mean it would take its info. from your mode then display it in scrolling text or in a fixed table on the main forum page with medals or stars showing who was nominated and for which period. Just an idea that came to me now. Thanks for this mod. It's working great.

Last edited by haytham; 13 Oct 2008 at 14:18. Reason: Adding an idea.
Reply With Quote
  #924  
Old 13 Oct 2008, 21:37
vbboarder's Avatar
vbboarder vbboarder is offline
 
Join Date: Jun 2008
Originally Posted by Britmovie View Post
On www.britmovie.net/britforum i keep getting the following permission message when trying to nominate, but I just cant see where to change it. Can anyone give me the path to the permissions for it or tell me what I missed out. Or even does it work as I have vb 3.8.0 beta 1 installed which may be the problem?
-------------------------
Long John Silver, you do not have permission to access this page. This could be due to one of several reasons:

1. Your user account may not have sufficient privileges to access this page. Are you trying to edit someone else's post, access administrative features or some other privileged system?
2. If you are trying to post, the administrator may have disabled your account, or it may be awaiting activation.
This mod has not been tested in VB 3.8 and also VB 3.8 is still in beta.

Settings for users & usergroups permissions are at VB Options > Nominate Topic.
Reply With Quote
  #925  
Old 13 Oct 2008, 21:39
vbboarder's Avatar
vbboarder vbboarder is offline
 
Join Date: Jun 2008
Originally Posted by haytham View Post
What happens if there is a tie between 2 or 3 posts? I'd also prefer if only a certain group can nominate posts up to like a max. of 5 then members would vote on these 5 posts. But now, all members may choose different posts so we can get hundreds of threads with only 1 or 2 votes. They should concentrate on only a few chosen posts. What do you guys think?
You can limit posts that can be nominated to "first post only" in the setting "Which Post Must Be Considered For Nomination." You can limit # of nominations a user can submit in the setting "Maximun Number Of Topic A User Can Nominate Per Cycle Time."
Reply With Quote
  #926  
Old 13 Oct 2008, 22:38
pokesph's Avatar
pokesph pokesph is offline
 
Join Date: Mar 2002
Real name: Steve
well I STILL can't get this to work correctly on our board. when we enable it, NONE of the posts in any threads display.. (except deleted ones, go figure.)

Not sure what's up but oh well.. would be nice if we could get this to work.
Attached Images
File Type: jpg broken_addon_-_nominate.jpg (152.9 KB, 16 views)
__________________
The PokeCommunity Admin
- - - - - - - - - - - - - - - -
http://www.pokecommunity.com

Last edited by pokesph; 13 Oct 2008 at 22:48.
Reply With Quote
  #927  
Old 13 Oct 2008, 23:57
Jeordie015 Jeordie015 is offline
 
Join Date: Nov 2002
Is it possible to make this so there is only one winner per week instead of 3?
Reply With Quote
  #928  
Old 14 Oct 2008, 04:17
ikickass ikickass is offline
 
Join Date: Jul 2007
Well, I've installed this and, the "Nominate" button does not appear and whenever I go to replace the files again (To make sure there all correct) It says the date of the old one is, 14/10/2008 :S And it’s smaller than the one in the RAR file. :(
Reply With Quote
  #929  
Old 15 Oct 2008, 08:55
vbboarder's Avatar
vbboarder vbboarder is offline
 
Join Date: Jun 2008
Arrow Bug Report & Fix: links plugin uses wrong hook

The Nominations & Hall of Fame links will not appear when the users are viewing non-forum pages (ie: social groups or tags pages).
Solution: REMOVE the code below from the Topic Nomination global_setup_complete plugin and add a new plugin hooked to parse_templates (you can name it "Topic Nomination Navbar Links").

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

Reply With Quote
  #930  
Old 17 Oct 2008, 19:49
logicuk's Avatar
logicuk logicuk is offline
 
Join Date: Jan 2008
I just installed this today, but im getting this error

The Administrator(s) did not defined a receiving forum for hosting poll results of the TOTW/TOTM contest.

But its set in my admincp
Reply With Quote
Reply


Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
 
Mod Options

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off


New To Site? Need Help?

All times are GMT. The time now is 20:22.

Layout Options | Width: Wide Color: