Alternating Row Color for Forums / Search Results / Thread Listings

What this plugin/modification does:
In the default vBulletin implementation, the colors alternate from left to right - from table cell to table cell. This plugin/modification changes it so that each row changes colors instead.

For a visual, we're talking about changing this:
---------------------------
| red | blue | red | blue |
---------------------------
| red | blue | red | blue |
---------------------------
| red | blue | red | blue |
---------------------------
To this:
-----------------------------
| red | red | red | red |
-----------------------------
| blue | blue | blue | blue |
-----------------------------
| red | red | red | red |
-----------------------------


Currently, this plugin enables changing row colors in

• Forum Listing in the Forum Home page (screenie attached)
• Sub Forum Listing (screenie attached)
• Thread Listing (screenie attached)
• Search Results Page (screenie attached)
• PM Listing
• Member Listings
  

How it works:
The way the colors are currently assigned is via CSS classes. The template changes remove the class definitions from the table cells, and add class definitions to the displayed rows. The CSS Classes used are the "Alt1" and "Alt2" classes - defined in the Admin Control Panel under Style Manager, (style), Main CSS, "First Alternating Color" and "Second Alternating Color".

The Product is named "Alternating Row Color for ForumBits".
Attached to the product are Four plugins:
Alternating Row Color for ForumBits Function - this defines a brief function enabled at the "global_start" hook location.

function forumRowClass($myrownum){
 return $result = ($myrownum %2 == 0)? ('alt1') : ('alt2');
}

This function is called from other plugins to define whether or not they should be presented with the "alt1" CSS Class, or the "alt2" CSS Class.
The other three plugins -Alternating Threadbit background, Alternating Row Color for ForumBits, Alternating Row Color Search Threadbit - are copy/paste functionality enabled in three separate locations:

$myrownum++;
$rowClass = forumRowClass($myrownum);

Basically, as vbulletin iterates through creating the rows to display, it calls the function to find out which CSS class to use.
Making minor changes:
If you would rather the colors be switched, simply swap 'alt1' and 'alt2' in the "Alternating Row Color for ForumBits Function" plugin.

What's Involved?
1 Product Installation
4 Plugins (installed all at once, via the product)
47 Changes to 5 Templates

Credit To
VBSeo.com for giving me the idea.

Updates
9/6/2006
got rid of funky quotes in updated_memberlist_reslutsbit.tmpl.php

9/5/2006
Version .3
Updated Mod Description, Install Instructions, downloadable files
Added functionality for Memberlist Alternating Colors
Added functionality for PM Listing Alternating Row Colors
Added new templates - pm_messagelistbit and memberlist_resultsbit

9/3/2006
Updated Mod Description
Installation Instructions
Added additional Screenshots
Uploaded pre-modified out-of-the-box templates
Re-uploaded zip file with appropriate paths
Mod Title Update

9/2/2006
Version .2 - Added plugin to alternate row colors in search results, which also implies the ability to alternate row colors in thread listings.

Installation:
Downloads are on the right. The zip file contains the xml plugin file as well as pre-modified template updates. Only use the premodified templates if the following statements are all true:
1) You are running vBulletin 3.6.0
2) You have not modified the templates to be updated.

There are now 5 templates I have identified that need updating. These templates are:

• threadbit
• forumhome_forumbit_level1_post
• forumhome_forumbit_level2_post
• memberlist_resultsbit
• pm_messagelistbit
  

Step 1) Go into your AdminCP, Click Add/Import Product, Upload the product-alternating-forum-rows.xml file.

For the remaining steps, I'm going to go through three iterations of instructions: "The Really Easy Way", "The Easy Way", and "The Hard Way"
Just Pick ONE set of instructions to follow!
Instructions for "The Really Easy Way":

1. If you didn't follow the instructions above, upload the product-alternating-forum-rows.xml file into your Product Manager
2. Replace your unmodified threadbit template with updated_threadbit.tmpl.php
3. Replace your unmodified 3.6.0 forumhome_forumbit_level1_post template with updated_forumhome_forumbit_level1_post.tmpl.php
4. Replace your unmodified 3.6.0 forumhome_forumbit_level2_post template with updated_forumhome_forumbit_level2_post.tmpl.php
5. Replace your unmodified 3.6.0 memberlist_resultsbit template with updated_ memberlist_resultsbit.tmpl.php
6. Replace your unmodified 3.6.0 pm_messagelistbit template with updated_ pm_messagelistbit.tmpl.php

At this point, you are done. No need to read further or execute anymore steps. Take a look at your forum, if it doesn't look right come back and ask for help.

============================

Installation Instructions for "The Easy Way"
If you didn't follow the instructions above, upload the product-alternating-forum-rows.xml file into your Product Manager

threadbit template updates
1) On the very first line, change

<tr>

to

<tr class="$rowClass">

2) search and remove:
2) Find all ' class="alt1"' and remove
3) Find all ' class="alt2"' and remove

forumhome_forumbit_level1_post updates
1) On the second line, change

<tr align="center">

to

<tr class="$rowClass" align="center">

2) search and remove:
2) Find all ' class="alt1"' and remove
3) Find all ' class="alt2"' and remove
4) Find all ' class="alt1Active"' and remove

forumhome_forumbit_level2_post
1) On the very first line, change

<tr>

to

<tr class="$rowClass">

2) search and remove:
2) Find all ' class="alt1"' and remove
3) Find all ' class="alt2"' and remove
4) Find all ' class="alt1Active"' and remove


pm_messagelistbit
1) On the very first line, change

<tr>

to

<tr class="$rowClass">

2) search and remove:
2) Find all ' class="alt1"' and remove
3) Find all ' class="alt2"' and remove
4) Find all ' class="alt1Active"' and remove

memberlist_resultsbit
1) change

<tr align="center">

to

<tr class="$rowClass" align="center">

2) search and remove:
2) Find all ' AND exec_switch_bg()"' and remove
3) Find all ' class="$bgclass"' and remove
4) Find all ' class="alt1Active"' and remove
5) Find all ' class="alt2"' and remove

At this point, you are done. No need to read further or execute anymore steps. Take a look at your forum, if it doesn't look right come back and ask for help.

============================

Installation Instructions for "The Hard Way"
(see the attached zip file. It was making this thread too difficult to read)

[magnus]

Originally Posted by needaltuna

Well it turned out that this hack didn't work so well in 3.6.8. In the memberslist page, I got the following error message.



Anyway, I had to replace the new code with the old.

It'd be nice if somebody came up with a updated version of this hack for the latest version of vBulletin. Got a feeling, though, that everybody but me has abandoned this thread. Pity.

The method in my previous post(s) works fine (tested in 3.6.8). I'd check for typos.

[bulletinboard]

Excellent, just what I was looking for.

[NicholasMarshal]

Originally Posted by magnus

I was using this modification up until I read PayBas's post. To accomplish this without the need for plugins or extra functions simply uninstall the product (leaving the template changes in place) and re-edit the templates listed in the instructions, adding the following to the top of each template:

<if condition="$altrow =& $GLOBALS['altrow']"></if>
<if condition="!isset($altrow)">
	<if condition="$altrow = 0"></if>
</if>
<if condition="++$altrow % 2 == 0">
	<if condition="$rowClass = 'alt1'"></if>
<else />
	<if condition="$rowClass = 'alt2'"></if>
</if>

That's it.

Well done, works like a treat

[MichaelJohnston]

Sweet man, this is the way it should be. Thanks a MILLION!

[brendanc]

Would like to point out that this works with 3.7.0 as well. Thanks!

[karp2381]

This code is great! Thanks a bunch.

[ringleader]

Works great with 3.7.3 PL1.

Thanks so much for making it!

[Uneek]

Is this method still safe for vbulletin 3.8.0?

[ddurazo]

it does work for 3.8.0 however one of the templates u have to modifiy is slightly different, it has a few lines of code above the first <tr> so be careful with that and you should be good to go

[escavern]

Doesnt work with Internet Explorer.. and im googling it and there are many people says alternate row color is not compatible with IE8+IE9.. any solutions ?