This product will only work with vBulletin 4.x.x!

IMPORTANT: Backup your database before proceeding! I will not be held responsible for any data loss!

Step 1 - Product Installation & Upgrade

1. Open your admincp, go to "Plugins & Products" (admincp->Plugins & Products->Manage Products).
2. Then select "Add/Import Product".
3. Browse to where you unzipped the file and select the product-forumcategoryicons.xml file.
4. Select "Overwrite".
5. Then click on "Import".

If you haven't modified the templates "forumhome_forumbit_level1_post" and "forumhome_forumbit_level2_post" you may proceed to "Step 3", otherwise you should proceed to "Step 2 - Manual Template Changes".

Step 2 - Manual Template Changes (If upgrading then you need to revert your templates before doing these 2 template edits.)

1. forumhome_forumbit_level2_post
   Find:
   <img src="{vb:stylevar imgdir_statusicon}/{vb:raw forum.imageprefix}forum_{vb:raw forum.statusicon}-48.png" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="" /> <div class="forumdata"> <div class="datacontainer"> <div class="titleline"> <h2 class="forumtitle"><a href="{vb:link forum, {vb:raw forum}}">{vb:raw forum.title}</a></h2> <vb:if condition="$show['browsers']"><span class="viewing">({vb:raw forum.browsers} {vb:rawphrase viewing})</span></vb:if> </div> <vb:if condition="$show['forumdescription']"><p class="forumdescription">{vb:raw forum.description}</p></vb:if>
   
   Replace:  
   
   <!-- Forum Category Icons --> <vb:if condition="$vbulletin->options['forumiconimg_enabled'] && $forum['forumiconimg']"> <vb:if condition="$vbulletin->options['forumiconimg_location'] == '2'"> <!-- replace status icon with category icon --> <!-- new posts --> <vb:if condition="$forum['statusicon'] == 'new'"><a href="forumdisplay.php?{vb:raw session.sessionurl}do=markread&f={vb:raw foruminfo.forumid}&markreadhash={vb:raw bbuserinfo.securitytoken}" rel="nofollow"> <img src="images/{vb:raw vboptions.forumiconimg_folder}/{vb:raw forum.forumiconimg}" style="<vb:if condition="$vbulletin->options['forumiconimg_margin_location'] == '1' OR $vbulletin->options['forumiconimg_margin_location'] == '3'">margin:{vb:raw vboptions.forumiconimg_margin};</vb:if> <vb:if condition="$vbulletin->options['forumiconimg_size'] == '1'">width:{vb:raw forum.forumiconimg_forum_width}px; height:{vb:raw forum.forumiconimg_forum_height}px;<vb:else />width:{vb:raw vboptions.forumiconimg_width}px; height:{vb:raw vboptions.forumiconimg_height}px;</vb:if>" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="{vb:rawphrase doubleclick_forum_markread}" /></a> <!-- new posts locked --> <vb:elseif condition="$forum['statusicon'] == 'new_lock' && $vbulletin->options['showlocks']" /> <img src="images/{vb:raw vboptions.forumiconimg_folder}/lock.png" style="background-image:url('images/{vb:raw vboptions.forumiconimg_folder}/{vb:raw forum.forumiconimg}'); background-repeat:no-repeat; <vb:if condition="$vbulletin->options['forumiconimg_margin_location'] == '1' OR $vbulletin->options['forumiconimg_margin_location'] == '3'">margin:{vb:raw vboptions.forumiconimg_margin};</vb:if> width:48px; height:48px;" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="" /> <!-- old posts locked --> <vb:elseif condition="$forum['statusicon'] == 'old_lock' && $vbulletin->options['showlocks']" /> <img src="images/{vb:raw vboptions.forumiconimg_folder}/lock.png" style="background-image:url('images/{vb:raw vboptions.forumiconimg_folder}/{vb:raw forum.forumiconimg}'); background-repeat:no-repeat;<vb:if condition="$vbulletin->options['forumiconimg_margin_location'] == '1' OR $vbulletin->options['forumiconimg_margin_location'] == '3'">margin:{vb:raw vboptions.forumiconimg_margin};</vb:if> width:48px; height:48px;" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="" /> <vb:else /> <!-- old posts --> <img src="images/{vb:raw vboptions.forumiconimg_folder}/{vb:raw forum.forumiconimg}" style="<vb:if condition="$vbulletin->options['forumiconimg_margin_location'] == '1' OR $vbulletin->options['forumiconimg_margin_location'] == '3'">margin:{vb:raw vboptions.forumiconimg_margin};</vb:if> <vb:if condition="$vbulletin->options['forumiconimg_size'] == '1'">width:{vb:raw forum.forumiconimg_forum_width}px; height:{vb:raw forum.forumiconimg_forum_height}px;<vb:else />width:{vb:raw vboptions.forumiconimg_width}px; height:{vb:raw vboptions.forumiconimg_height}px;</vb:if> <vb:if condition="$vbulletin->options['forumiconimg_status'] == '1' && $forum['statusicon'] == 'old' && $bbuserinfo['userid']"><vb:if condition="is_browser('ie')">filter:alpha(opacity={vb:raw vboptions.forumiconimg_opacity}); -ms-filter:"alpha(opacity={vb:raw vboptions.forumiconimg_opacity})";<vb:else />opacity:0.{vb:raw vboptions.forumiconimg_opacity};</vb:if></vb:if>" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="{vb:rawphrase forum_contains_no_new_posts}" /> </vb:if> <vb:else /> <!-- do nothing --> <img src="{vb:stylevar imgdir_statusicon}/{vb:raw forum.imageprefix}forum_{vb:raw forum.statusicon}-48.png" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="" /> </vb:if> <div class="forumdata"> <div class="datacontainer"> <vb:if condition="$vbulletin->options['forumiconimg_location'] == '0'"> <!-- category icon after status icon --> <img src="images/{vb:raw vboptions.forumiconimg_folder}/{vb:raw forum.forumiconimg}" alt="{vb:raw forum.title}" style="float:left; <vb:if condition="$vbulletin->options['forumiconimg_margin_location'] == '1' OR $vbulletin->options['forumiconimg_margin_location'] == '3'">margin:{vb:raw vboptions.forumiconimg_margin};<vb:else />margin-right:4px;</vb:if> <vb:if condition="$vbulletin->options['forumiconimg_size'] == '1'">width:{vb:raw forum.forumiconimg_forum_width}px; height:{vb:raw forum.forumiconimg_forum_height}px;<vb:else />width:{vb:raw vboptions.forumiconimg_width}px; height:{vb:raw vboptions.forumiconimg_height}px;</vb:if>;" /> <div> <h2 style="font-weight:bold; font-size:13px;"><a href="{vb:link forum, {vb:raw forum}}">{vb:raw forum.title}</a></h2> <vb:if condition="$show['browsers']"><span class="viewing">({vb:raw forum.browsers} {vb:rawphrase viewing})</span></vb:if> <vb:if condition="$show['forumdescription']"><p>{vb:raw forum.description}</p></vb:if> </div> <vb:elseif condition="$vbulletin->options['forumiconimg_location'] == '1'" /> <!-- category icon under forum title --> <div class="titleline"> <h2 class="forumtitle"><a href="{vb:link forum, {vb:raw forum}}">{vb:raw forum.title}</a></h2> <vb:if condition="$show['browsers']"><span class="viewing">({vb:raw forum.browsers} {vb:rawphrase viewing})</span></vb:if> </div> <vb:if condition="$show['forumdescription']"><p class="forumdescription"><img src="images/{vb:raw vboptions.forumiconimg_folder}/{vb:raw forum.forumiconimg}" style="float:left; <vb:if condition="$vbulletin->options['forumiconimg_margin_location'] == '1' OR $vbulletin->options['forumiconimg_margin_location'] == '3'">margin:{vb:raw vboptions.forumiconimg_margin};<vb:else />margin-right:4px;</vb:if> <vb:if condition="$vbulletin->options['forumiconimg_size'] == '1'">width:{vb:raw forum.forumiconimg_forum_width}px; height:{vb:raw forum.forumiconimg_forum_height}px;<vb:else />width:{vb:raw vboptions.forumiconimg_width}px; height:{vb:raw vboptions.forumiconimg_height}px;</vb:if>" alt="{vb:raw forum.title}" />{vb:raw forum.description}</p></vb:if> <vb:else /> <!-- do nothing --> <div class="titleline"> <h2 class="forumtitle"><a href="{vb:link forum, {vb:raw forum}}">{vb:raw forum.title}</a></h2> <vb:if condition="$show['browsers']"><span class="viewing">({vb:raw forum.browsers} {vb:rawphrase viewing})</span></vb:if> </div> <vb:if condition="$show['forumdescription']"><p class="forumdescription">{vb:raw forum.description}</p></vb:if> </vb:if> <vb:else /> <!-- Forum Category Icons Disabled --> <img src="{vb:stylevar imgdir_statusicon}/{vb:raw forum.imageprefix}forum_{vb:raw forum.statusicon}-48.png" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="" /> <div class="forumdata"> <div class="datacontainer"> <div class="titleline"> <h2 class="forumtitle"><a href="{vb:link forum, {vb:raw forum}}">{vb:raw forum.title}</a></h2> <vb:if condition="$show['browsers']"><span class="viewing">({vb:raw forum.browsers} {vb:rawphrase viewing})</span></vb:if> </div> <vb:if condition="$show['forumdescription']"><p class="forumdescription">{vb:raw forum.description}</p></vb:if> </vb:if> <!-- End Forum Category Icons -->
   
   
   
2. forumhome_forumbit_level1_post
   Find:
   <img src="{vb:stylevar imgdir_statusicon}/{vb:raw forum.imageprefix}forum_{vb:raw forum.statusicon}-48.png" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="" /> <div class="forumdata"> <div class="datacontainer"> <div class="titleline"> <h2 class="forumtitle"><a href="{vb:link forum, {vb:raw forum}}">{vb:raw forum.title}</a></h2> <vb:if condition="$show['browsers']"><span class="viewing">({vb:raw forum.browsers} {vb:rawphrase viewing})</span></vb:if> </div> <vb:if condition="$show['forumdescription']"><p class="forumdescription">{vb:raw forum.description}</p></vb:if>
   
   Replace:  
   
   <!-- Forum Category Icons --> <vb:if condition="$vbulletin->options['forumiconimg_enabled'] && $forum['forumiconimg']"> <vb:if condition="$vbulletin->options['forumiconimg_location'] == '2'"> <!-- replace status icon with category icon --> <!-- new posts --> <vb:if condition="$forum['statusicon'] == 'new'"><a href="forumdisplay.php?{vb:raw session.sessionurl}do=markread&f={vb:raw foruminfo.forumid}&markreadhash={vb:raw bbuserinfo.securitytoken}" rel="nofollow"> <img src="images/{vb:raw vboptions.forumiconimg_folder}/{vb:raw forum.forumiconimg}" style="<vb:if condition="$vbulletin->options['forumiconimg_margin_location'] == '1' OR $vbulletin->options['forumiconimg_margin_location'] == '3'">margin:{vb:raw vboptions.forumiconimg_margin};</vb:if> <vb:if condition="$vbulletin->options['forumiconimg_size'] == '1'">width:{vb:raw forum.forumiconimg_forum_width}px; height:{vb:raw forum.forumiconimg_forum_height}px;<vb:else />width:{vb:raw vboptions.forumiconimg_width}px; height:{vb:raw vboptions.forumiconimg_height}px;</vb:if>" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="{vb:rawphrase doubleclick_forum_markread}" /></a> <!-- new posts locked --> <vb:elseif condition="$forum['statusicon'] == 'new_lock' && $vbulletin->options['showlocks']" /> <img src="images/{vb:raw vboptions.forumiconimg_folder}/lock.png" style="background-image:url('images/{vb:raw vboptions.forumiconimg_folder}/{vb:raw forum.forumiconimg}'); background-repeat:no-repeat; <vb:if condition="$vbulletin->options['forumiconimg_margin_location'] == '1' OR $vbulletin->options['forumiconimg_margin_location'] == '3'">margin:{vb:raw vboptions.forumiconimg_margin};</vb:if> width:48px; height:48px;" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="" /> <!-- old posts locked --> <vb:elseif condition="$forum['statusicon'] == 'old_lock' && $vbulletin->options['showlocks']" /> <img src="images/{vb:raw vboptions.forumiconimg_folder}/lock.png" style="background-image:url('images/{vb:raw vboptions.forumiconimg_folder}/{vb:raw forum.forumiconimg}'); background-repeat:no-repeat;<vb:if condition="$vbulletin->options['forumiconimg_margin_location'] == '1' OR $vbulletin->options['forumiconimg_margin_location'] == '3'"> margin:{vb:raw vboptions.forumiconimg_margin};</vb:if> width:48px; height:48px;" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="" /> <vb:else /> <!-- old posts --> <img src="images/{vb:raw vboptions.forumiconimg_folder}/{vb:raw forum.forumiconimg}" style="<vb:if condition="$vbulletin->options['forumiconimg_margin_location'] == '1' OR $vbulletin->options['forumiconimg_margin_location'] == '3'">margin:{vb:raw vboptions.forumiconimg_margin};</vb:if><vb:if condition="$vbulletin->options['forumiconimg_size'] == '1'">width:{vb:raw forum.forumiconimg_forum_width}px; height:{vb:raw forum.forumiconimg_forum_height}px;<vb:else />width:{vb:raw vboptions.forumiconimg_width}px; height:{vb:raw vboptions.forumiconimg_height}px;</vb:if> <vb:if condition="$vbulletin->options['forumiconimg_status'] == '1' && $forum['statusicon'] == 'old' && $bbuserinfo['userid']"><vb:if condition="is_browser('ie')">filter:alpha(opacity={vb:raw vboptions.forumiconimg_opacity}); -ms-filter:"alpha(opacity={vb:raw vboptions.forumiconimg_opacity})";<vb:else />opacity:0.{vb:raw vboptions.forumiconimg_opacity};</vb:if></vb:if>" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="{vb:rawphrase forum_contains_no_new_posts}" /> </vb:if> <vb:else /> <!-- do nothing --> <img src="{vb:stylevar imgdir_statusicon}/{vb:raw forum.imageprefix}forum_{vb:raw forum.statusicon}-48.png" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="" /> </vb:if> <div class="forumdata"> <div class="datacontainer"> <vb:if condition="$vbulletin->options['forumiconimg_location'] == '0'"> <!-- category icon after status icon --> <img src="images/{vb:raw vboptions.forumiconimg_folder}/{vb:raw forum.forumiconimg}" alt="{vb:raw forum.title}" style="float:left; margin-right:4px; width:{vb:raw vboptions.forumiconimg_width}px; height:{vb:raw vboptions.forumiconimg_height}px; top:{vb:raw vboptions.forumiconimg_top}px;" /> <div> <h2 style="font-weight:bold; font-size:13px;"><a href="{vb:link forum, {vb:raw forum}}">{vb:raw forum.title}</a></h2> <vb:if condition="$show['browsers']"><span class="viewing">({vb:raw forum.browsers} {vb:rawphrase viewing})</span></vb:if> <vb:if condition="$show['forumdescription']"><p>{vb:raw forum.description}</p></vb:if> </div> <vb:elseif condition="$vbulletin->options['forumiconimg_location'] == '1'" /> <!-- category icon under forum title --> <div class="titleline"> <h2 class="forumtitle"><a href="{vb:link forum, {vb:raw forum}}">{vb:raw forum.title}</a></h2> <vb:if condition="$show['browsers']"><span class="viewing">({vb:raw forum.browsers} {vb:rawphrase viewing})</span></vb:if> </div> <vb:if condition="$show['forumdescription']"><p class="forumdescription"><img src="images/{vb:raw vboptions.forumiconimg_folder}/{vb:raw forum.forumiconimg}" style="float:left; <vb:if condition="$vbulletin->options['forumiconimg_margin_location'] == '1' OR $vbulletin->options['forumiconimg_margin_location'] == '3'">margin:{vb:raw vboptions.forumiconimg_margin};<vb:else />margin-right:4px;</vb:if> <vb:if condition="$vbulletin->options['forumiconimg_size'] == '1'">width:{vb:raw forum.forumiconimg_forum_width}px; height:{vb:raw forum.forumiconimg_forum_height}px;<vb:else />width:{vb:raw vboptions.forumiconimg_width}px; height:{vb:raw vboptions.forumiconimg_height}px;</vb:if>" alt="{vb:raw forum.title}" />{vb:raw forum.description}</p></vb:if> <vb:else /> <!-- do nothing --> <div class="titleline"> <h2 class="forumtitle"><a href="{vb:link forum, {vb:raw forum}}">{vb:raw forum.title}</a></h2> <vb:if condition="$show['browsers']"><span class="viewing">({vb:raw forum.browsers} {vb:rawphrase viewing})</span></vb:if> </div> <vb:if condition="$show['forumdescription']"><p class="forumdescription">{vb:raw forum.description}</p></vb:if> </vb:if> <vb:else /> <!-- Forum Category Icons Disabled --> <img src="{vb:stylevar imgdir_statusicon}/{vb:raw forum.imageprefix}forum_{vb:raw forum.statusicon}-48.png" class="forumicon" id="forum_statusicon_{vb:raw forum.forumid}" alt="" /> <div class="forumdata"> <div class="datacontainer"> <div class="titleline"> <h2 class="forumtitle"><a href="{vb:link forum, {vb:raw forum}}">{vb:raw forum.title}</a></h2> <vb:if condition="$show['browsers']"><span class="viewing">({vb:raw forum.browsers} {vb:rawphrase viewing})</span></vb:if> </div> <vb:if condition="$show['forumdescription']"><p class="forumdescription">{vb:raw forum.description}</p></vb:if> </vb:if> <!-- End Forum Category Icons -->

Step 3 - Forum Category Icon Settings.

1. Create a folder under images and call it what you want. (Make sure this is under the images folder otherwise you will get errors!)
2. Upload your images to this newly created folder. Note: Only jpg, gif and png icons allowed.
3. Upload the included lock.png file to your newly created folder.
4. If you want to show locked forums then go to vBulletin "Options->Forum Listings Display Options->Show Lock Icons to Users" and select Yes.
   Note: The status icons will default to 48x48 pixels. This cannot be controlled as background images cannot be resized when using CSS Sprites.
5. Go to vBulletin options and set the "Forum Category Icons" Options.
6. If you are upgrading from an earlier version (1.2.2 or earlier) and didn't do the manual template edits above you will need to revert
   the templates; "forumhome_forumbit_level1_post" and "forumhome_forumbit_level2_post" otherwise the "Auto Templates" WILL NOT work!
7. Go to Forum Manager and select the icon for each forum.

Final Notes

• Please ensure that you have followed the instructions above before posting that something doesn't work.
  I have taken every effort to make this bug free and the instructions clear and concise.
• If you did not click "Installed" on vBulletin.org you will not receive support, period!
• Suggestions/Comments are always welcome.
• Donations: Thank you to those who have donated to this hack.

Support Provided At:

• vBulletin.org