The Arcive of Official vBulletin Modifications Site.

About Developer · **Released**: 09-02-2006

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.

Code:

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:

Code:

$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":

If you didn't follow the instructions above, upload the product-alternating-forum-rows.xml file into your Product Manager
Replace your unmodified threadbit template with updated_threadbit.tmpl.php
Replace your unmodified 3.6.0 forumhome_forumbit_level1_post template with updated_forumhome_forumbit_level1_post.tmpl.php
Replace your unmodified 3.6.0 forumhome_forumbit_level2_post template with updated_forumhome_forumbit_level2_post.tmpl.php
Replace your unmodified 3.6.0 memberlist_resultsbit template with updated_ memberlist_resultsbit.tmpl.php
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

Code:

<tr>

to

Code:

<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

Code:

<tr align="center">

to

Code:

<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

Code:

<tr>

to

Code:

<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

Code:

<tr>

to

Code:

<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

Code:

<tr align="center">

to

Code:

<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)

nevetS · #32 09-06-2006, 04:46 AM

Just uploaded. I'm updating the instructions now, but for upgrades from 0.2, all you just overwrite the plugin, and update the new templates. I attached new pre-modified templates again, so it should be pretty easy.

Today I added memberlist and Private Message listings.

Smoothie · #33 09-06-2006, 04:56 AM

If we have the previous version installed and have added the new templates (forumhome level 1, level 2 and threadbit), do we need to update those templates too? Or just the newest templates(Memberlist and Private messages)?

nevetS · #34 09-06-2006, 04:57 AM

Quote:

Originally Posted by Ascor

i suggest: the same think for forumdisplay and showthread view, to have the most 3 views harmonised

Forgive me here - but I thought that forumdisplay and showthread were already updated. Either you posted this prior to the update, or maybe I am just thinking of the wrong views?

If I'm wrong, just post a sample url (i.e. forums/showthread.php?t=123) so I can check it on my own forum.

I took a peek and found something like 41 templates that have the possibility of being updated! I don't think I'll be tackling ALL of them just yet

nevetS · #35 09-06-2006, 04:57 AM

Quote:

Originally Posted by Smoothie

If we have the previous version installed and have added the new templates (forumhome level 1, level 2 and threadbit), do we need to update those templates too? Or just the newest templates(Memberlist and Private messages)?

Just the newest ones. The others have not changed.

Ascor · #36 09-06-2006, 09:43 PM

yes your right, i posted before the update

but when i look at your screen, showthread is not inclued
(what i think is this present view here, that you are just reading at this moment)
Tomorrow i install your upgrade

Smoothie · #37 09-07-2006, 02:00 AM

Quote:

Originally Posted by nevetS

Just uploaded. I'm updating the instructions now, but for upgrades from 0.2, all you just overwrite the plugin, and update the new templates. I attached new pre-modified templates again, so it should be pretty easy.

Today I added memberlist and Private Message listings.

Might want to check your memberlist_resultbit template. It's got some funny characters in the first line.

HTML Code:

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

nevetS · #38 09-07-2006, 02:23 AM

Quote:

Originally Posted by Smoothie

Might want to check your memberlist_resultbit template. It's got some funny characters in the first line.

HTML Code:

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

Thanks again smoothie. I copy pasted that from MS Word. It apparently smart-quoted me... In my text editor, they look almost exactly the same.

Template repaired and updated in the zip file. Anybody can use the new file, or replace align=?center? with align="center"

Smoothie · #39 09-07-2006, 08:39 AM

Installed new version and working. Thanks!

aceofspades · #40 09-09-2006, 09:01 PM

Please help me. I made a thread start column by using this tutorial:

http://www.vbulletin.com/forum/showthread.php?t=197265

which gave me this result:

Your hack worked perfectly before i added that column but now it doesnt match up. Can you please please please tell me how i would go about getting the row colours to alternate like the other columnbs (i.e last post). I would really appreciate it.

Regards,

James

nevetS · #41 09-10-2006, 08:45 AM

Quote:

Originally Posted by aceofspades

Please help me. I made a thread start column by using this tutorial:

http://www.vbulletin.com/forum/showthread.php?t=197265

which gave me this result:

Your hack worked perfectly before i added that column but now it doesnt match up. Can you please please please tell me how i would go about getting the row colours to alternate like the other columnbs (i.e last post). I would really appreciate it.

Regards,

James

Take a gander at your threadbit template. I suspect you will find an instance of

Code:

class="alt2"

or possibly, "alt1", but I'm pretty sure that it's alt2.
simply remove it and you should be fine. Basically, that class declaration is over-riding the color for cells in that column.

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.06108 seconds Memory Usage 2,341KB 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 (13)bbcode_code (2)bbcode_html (5)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 (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!