The Arcive of Official vBulletin Modifications Site.

About Developer · **Released**: 07-01-2008

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:

Uses AJAX technology.
Uses one query per show thread page
Fully phrased to allow (language translation) (addition v 1.3)
Places an easy to use "Nominate Post" button next to the edit button
Automatically create a nomination thread for discussions on nominees
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)
Displays an award winner stamp op award winner posts at the end of the Topic Of The Week/Month contest. (addition v 1.2)
Via postbit pop-up, displays link to find all nominations or nominees made by a user (addition v 1.35)
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)
Option to select the maximum number of topics that must be displayed in the poll (addition v 1.2)
Option to take or not into account for nomination only posts made during the month preceding the nomination cycle time (addition v 1.2)
Option to consider the maximum number of posts a user can nominate per cycle time (addition v 1.2)
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)
Automatically closes the nomination thread at end of the contest cycle time (weekly/monthly)
Quick link to nomination thread via the "Quick Navigation" menu
Quick link to award winners page via the "Quick Navigation" menu (addition v.1.1)
Automatically update the nomination poll whenever a post is nominated or withdraw from the contest.
Separate looks for postbit and postbit_legacy
Places all post nominees in one small box
Displays award winners in one small box
Quick link to nomination thread via the "small box" on the thread page
Option to allow award winners to re-enter the contest after X days
Users cannot nominate the same post twice
Option to not allow users to nominate their own post
Counts nominees submitted by a user
Counts how many times a nominee is submitted
Shows how many nominees a user submitted in every post of his
Shows info in member's profile
Option to search for posts nominated by a user
Option to search for all nominated posts
Administrator can withdraw all nominees of a single post
Selected usergroups (e.g. Moderators or SuperModerators) can withdraw all nominees of a single post (addition v 1.10)
Users can withdraw their own nominee
Option to disable the mod on selected forums
Option to disable the mod on all but the first post of a thread
Option to disable the mod on all but the first post of a thread in specific forums
Option to enable/disable view of nomination date on specific or all forums
Option to add to post count when someone nominate a post.
Option to give reputation points to the user whose post is nominated.
Option to ban selected usergroups from using the mod
Option to ban selected users from using the mod
Option to display user?s nomination statistics on postbit (addition v 1.10)
Option not to display nomination statistics on postbit for selected users (addition v 1.10)
Option not to display nomination statistics on postbit for selected usergroups (addition v 1.50)
Option to display or not the hall of fame link in Quick-Links (addition v 1.3)
Option to select forums on which nominations must be considered (addition v 1.35)
Hall of fame re-designed to handle a Top 10 award winners, all time cumulated (addition v 1.3)
Option to refresh the poll thread if for some reason a post referenced in the poll came to be deleted (addition v 1.3)
Option to use the current week number or month, or the next week number or month, in the contest title (addition v 1.3)
Option for archiving nominations in the "Nomination Thread" automatically whenever a user nominate a post. (addition v 1.35)
Option to automatically send a PM to award winners at the end of the contest (addition v 1.4)
Option to automatically add points to award winners? reputation at the end of the contest (addition v 1.4)
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.
Option to nominate blog entries (addition v 1.6)
Option to have award winners or nominated posts icons displayed on posts, so that nominated posts can be easily identified when listing posts.
Option to close current nomination thread and create a new one directly from the ACP

Installation instructions

Version 1.63

Uncompress the archive
Upload the content of the "upload" folder into your forum root directory
Import the "product_nominate_topic.xml" product via your ACP:
ACP -> Plugins & Products -> Manage Product -> Add/Import Product (Allow Overwrite if you are upgrading)
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
Save the specified settings
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

Postbit_legacy fixed
Quick link to award winners page via the "Quick Navigation" menu
Selected usergroups (e.g. Moderators or SuperModerators) can withdraw all nominees of a single post
Option to display user?s nomination statistics on postbit
Option not to display nomination statistics on postbit for selected users
Small bugs fixed
Tested on vB 3.7.0 and vB 3.7.2
Working on vB 3.6.8 and above

Update in version 1.2

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)
Displays an award winner stamp op award winner posts at the end of the Topic Of The Week/Month contest. (addition v 1.2)
Via postbit pop-up, displays link to find all nominations made by a user (addition v 1.2)
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)
Option to select the maximum number of topics that must be displayed in the poll (addition v 1.2)
Option to take or not into account for nomination only posts made during the month preceding the nomination cycle time (addition v 1.2)
Option to consider the maximum number of posts a user can nominate per cycle time (addition v 1.2)

Update in version 1.21

Fix for transition to Week 28 on cron file
Fix Unknown column error when adding a nomination.
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

Fix Duplicate entry issue.
Clean cron file
Full phrasing for those who wish to translate it.

Update in version 1.3

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)
Option to display or not the hall of fame link in Quick-Links (addition v 1.3)
Option to select only one forum on which nominations must be considered (addition v 1.3)
Hall of fame re-designed to handle a Top 10 award winners, all time cumulated (addition v 1.3)
Option to refresh the poll thread if for some reason a post referenced in the poll came to be deleted (addition v 1.3)
Option to use the current week number or month, or the next week number or month, in the contest title (addition v 1.3)
Fully phrased to allow language translation (addition v 1.3)
Cron file up-to-date

Update in version 1.35

Option to select forums on which nominations must be considered
Option for archiving nominations in the ?Nomination Thread? automatically.
Fortnightly cycle time added
Fully phrased to allow language translation (addition v 1.35)
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

Option to automatically send a PM to award winners at the end of the contest (addition v 1.4)
Option to automatically add points to award winners? reputation at the end of the contest (addition v 1.4)
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

Option not to display nomination statistics on postbit for selected usergroups (addition v 1.50)
Few display titles fixed
Additions made for users who had problems displaying the nomination button and stamp on their styles. Checkout the "Readme and installation" file.
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

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:

Refresh your poll from the ACP -> Nominate Topic -> Refresh Poll (This will update the display title of both the poll and the nomination thread)
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

Automatic PM subject phrase moved from "<phrasetype name="Email Subject Text" fieldname="emailsubject">" to "<phrasetype name="GLOBAL" fieldname="global">"
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

Function updated (see attachment) as a result of exchanges with Kevil via TeamViewer.

Update in version 1.60

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

Update in version 1.61

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

Update in version 1.62

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

Update in version 1.621

Fixed "Parse error: syntax error, unexpected '}' in /includes/cron/nominate_topic_cron.php on line 584"
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

Fixed link call, requested by TsirhCitna
Fixed "Hall of fame" display.

Update in version 1.635

Bug Fix by vbboarder implemented ? ?can?t find phrase? error in PM subject

Update in version 1.636

Default value for "cycle time header" set to use the current cycle time (current week/fortnight/month instead of next week/fortnight)
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.

jl255 · #**1032** 04-06-2009, 02:18 AM

Quote:

Originally Posted by flashwave

I am getting the following error:

Any idea?

any solutions to this problem too? i'm getting it too.... argg!

jl255 · #**1033** 04-06-2009, 05:39 AM

ok my db got quite screwed up at the end of the week when my 1st nominations close. tried fixing the db but need some urgent help:

1. what happens to posts that have been nominated in previous week but didn't win? what shld their db entries be for the following fields under vb_post:
nominate_topic_amount , nominate_topic_award & nominate_topic_award_rank

2. what happened at the end of the week, all these 3 fields above were set to 0 for all nominated posts. As a result, when members try to search for nominated posts of a member, it returns a nil result. Is that supposed to be the way? I would think that it shld list all past posts that have been nominated and not just the current week's nomination right?

3. does it cater for poll results with equal number of votes? What happens then?

Really hope to get some support, even if you cannot solve it, hope you can at least help to clarify the structure so I can try to fix it myself. Tks!!!

powerful_rogue · #**1034** 04-06-2009, 02:28 PM

Quote:

Originally Posted by powerful_rogue

With regards to the postbit info, does anyone know how I could condense it down? It currently shows -

Nominated 31 Times in 16 Posts
Nominated TOTW/F/M Award(s): 5

However I would like it to show:

Nominated TOTF Award(s): 5

With the

linking to the hall of fame.

Any help greatly appreciated

Bump!

vbboarder · #**1035** 04-06-2009, 06:16 PM

Quote:

Originally Posted by jl255

ok my db got quite screwed up at the end of the week when my 1st nominations close. tried fixing the db but need some urgent help:

1. what happens to posts that have been nominated in previous week but didn't win? what shld their db entries be for the following fields under vb_post:
nominate_topic_amount , nominate_topic_award & nominate_topic_award_rank

2. what happened at the end of the week, all these 3 fields above were set to 0 for all nominated posts. As a result, when members try to search for nominated posts of a member, it returns a nil result. Is that supposed to be the way? I would think that it shld list all past posts that have been nominated and not just the current week's nomination right?

3. does it cater for poll results with equal number of votes? What happens then?

Really hope to get some support, even if you cannot solve it, hope you can at least help to clarify the structure so I can try to fix it myself. Tks!!!

Here's the answers to your Q's:

1. For non-awarded posts, nominate_topic_amount , nominate_topic_award & nominate_topic_award_rank should all be 0.
For awarded posts, those values vary with when & what award they got.

2. It only shows nominated posts for the current contest or that have past awards. It does not show past nominations that did not win.

3. It will award a maximum of 3 awards per contest period - this is can not be changed, it's hard-coded. Less than 3 awards are given if there's < 3 posts nominated.

vbboarder · #**1036** 04-06-2009, 06:17 PM

Quote:

Originally Posted by powerful_rogue

With regards to the postbit info, does anyone know how I could condense it down? It currently shows -

Nominated 31 Times in 16 Posts
Nominated TOTW/F/M Award(s): 5

However I would like it to show:

Nominated TOTF Award(s): 5

With the

linking to the hall of fame.

Any help greatly appreciated

Replace nominate_topic_postbit_info template with:

Code:

                <if condition="$post[userid]">
                        <if condition="$post[nominate_topic_nominated_awards] == 0">
                            <div>$vbphrase[nominate_topic_has_not_won_TOTWFM_yet]</div>
                        <else />
                            <div><phrase 1="$post[nominate_topic_nominated_awards_formatted]"><img src="$stylevar[imgdir_misc]/nominate/award_star_gold_3.png" alt="$vbphrase[nominated_topic_nominations]" style="vertical-align:middle" border="0" />&nbsp;$vbphrase[nominate_topic_nominated_awards_TOTWFM]</phrase></div>
                        </if>
                </if>

.

If you know HTML, then you can convert the image to a link.

vbboarder · #**1037** 04-06-2009, 07:24 PM

Quote:

Originally Posted by jl255

any solutions to this problem too? i'm getting it too.... argg!

This problem has been posted several times already. It has something to do with allowing users to withdraw their nominations. I suggest disabling nominations withdrawal until this bug has been fixed.

I'm only running this mod on a test site so I have not been able to replicate this problem. On my test site, I have several users in different usergroups, and I tried 'withdraw your nominations' and 'withdraw all nominations', but still have not been able to reproduce this problem. So it probably involves some convoluted series of added nominations/ withdraw nominations actions. If people post more useful info (instead of obvious error/ bug complaints) about the series of nomination actions that happens on a specific post, then I may be able to debug this problem.

powerful_rogue · #**1038** 04-06-2009, 08:15 PM

Quote:

Originally Posted by vbboarder

Replace nominate_topic_postbit_info template with:

Code:

                <if condition="$post[userid]">
                        <if condition="$post[nominate_topic_nominated_awards] == 0">
                            <div>$vbphrase[nominate_topic_has_not_won_TOTWFM_yet]</div>
                        <else />
                            <div><phrase 1="$post[nominate_topic_nominated_awards_formatted]"><img src="$stylevar[imgdir_misc]/nominate/award_star_gold_3.png" alt="$vbphrase[nominated_topic_nominations]" style="vertical-align:middle" border="0" />&nbsp;$vbphrase[nominate_topic_nominated_awards_TOTWFM]</phrase></div>
                        </if>
                </if>

.

If you know HTML, then you can convert the image to a link.

Worked a treat. Thank you so much.

I will have a play around with the HTML regarding the image. At least i know where to look now!

Thanks again.

jl255 · #**1039** 04-07-2009, 12:57 AM

Quote:

Originally Posted by vbboarder

Here's the answers to your Q's:

1. For non-awarded posts, nominate_topic_amount , nominate_topic_award & nominate_topic_award_rank should all be 0.
For awarded posts, those values vary with when & what award they got.

2. It only shows nominated posts for the current contest or that have past awards. It does not show past nominations that did not win.

3. It will award a maximum of 3 awards per contest period - this is can not be changed, it's hard-coded. Less than 3 awards are given if there's < 3 posts nominated.

tks alot for taking the time to help us all

For Q3, what I mean to ask is, what if the results of the poll are 5, 4, 3, 3, 3, which means that some of the polls share same number of votes. How does it award the top 3?

For Q2, I understand how it works now. I observe that if i retain the values of the variable nominate_topic_amount, then when a search is done for a members' nominated posts, it will show all past nominations as well. I think that it is important, just like the 'thank you' mod for members to be able to see what posts of other members were previously nominated. However, the main problem is that it will then display that the post has 'won' the TOTW. Where do I go to change the check to exclude nominate_topic_amount to determine if the post has won? I believe that the variable nominate_topic_award_rank shld be sufficient to determine if the post has won previously and we can exclude the condition on nominate_topic_amount?

BlueNinjaGo · #**1040** 04-07-2009, 03:56 PM

Quote:

Originally Posted by vbboarder

Replace nominate_topic_postbit_info template with:

Code:

                <if condition="$post[userid]">
                        <if condition="$post[nominate_topic_nominated_awards] == 0">
                            <div>$vbphrase[nominate_topic_has_not_won_TOTWFM_yet]</div>
                        <else />
                            <div><phrase 1="$post[nominate_topic_nominated_awards_formatted]"><img src="$stylevar[imgdir_misc]/nominate/award_star_gold_3.png" alt="$vbphrase[nominated_topic_nominations]" style="vertical-align:middle" border="0" />&nbsp;$vbphrase[nominate_topic_nominated_awards_TOTWFM]</phrase></div>
                        </if>
                </if>

.

If you know HTML, then you can convert the image to a link.

I did this, but it still says "TOTW/F/M Award(s): 0"

How would I chant it to "TOTW Award(s): 0"

TheLastSuperman · #**1041** 04-07-2009, 04:03 PM

Quote:

Originally Posted by BlueNinjaGo

I did this, but it still says "TOTW/F/M Award(s): 0"

How would I chant it to "TOTW Award(s): 0"

I'm not familiar w/ this Mod BNG however you could remove the phrase and type what you want

just make sure any href tags etc stay in place or anything telling it the count

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.10140 seconds Memory Usage 2,369KB Queries Executed 26 (?)
More Information
Template Usage: (1)SHOWTHREAD (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (1)ad_showthread_beforeqr (3)bbcode_code (9)bbcode_quote (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_post (1)navbar (6)navbar_link (120)option (1)pagenav (1)pagenav_curpage (4)pagenav_pagelink (3)pagenav_pagelinkrel (11)post_thanks_box (11)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (11)post_thanks_postbit_info (10)postbit (11)postbit_onlinestatus (11)postbit_wrapper (1)spacer_close (1)spacer_open (1)tagbit_wrapper Phrase Groups Available: global inlinemod postbit posting reputationlevel showthread	Included Files: ./showthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/functions_bigthree.php ./includes/class_postbit.php ./includes/class_bbcode.php ./includes/functions_reputation.php ./includes/functions_post_thanks.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete showthread_start showthread_getinfo forumjump showthread_post_start showthread_query_postids showthread_query bbcode_fetch_tags bbcode_create showthread_postbit_create postbit_factory postbit_display_start post_thanks_function_post_thanks_off_start post_thanks_function_post_thanks_off_end post_thanks_function_fetch_thanks_start post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end fetch_musername postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_display_complete post_thanks_function_can_thank_this_post_start pagenav_page pagenav_complete tag_fetchbit_complete forumrules navbits navbits_complete showthread_complete
Messages:

The Arcive of Official vBulletin Modifications Site.

It is not a VB3 engine, just a parsed copy!