Profile Enhancements - Customizable Roster

Customizable Roster

Introduction:

This Mod is ideal for a Guild/Clan roster, but it is also a great replacement for the memberlist. Customize it any way you like: add or remove columns with just a few easy edits. The installer includes permission control that allows you to set which groups appear on the roster and which ones can view it. See the optional.txt file included in the installation for additional changes that you can make at your discretion. The most popular option is the ability to add sorting; check it out!


Installation:

Step 0: If you are upgrading from a previous version, save a copy of your old showroster.php and rename your showroster templates (I recommend giving them an underscore prefix; Example: _SHOWROSTER).

Step 1: Download the attached showrosterXXX.zip file.

Step 2: Upload the files to their correct directories.

Upload the showroster.php to the /forum/ directory.
Upload the bitfield_showroster.xml to the /forum/includes/xml/ directory.
Upload the spacer.gif to the /forum/images directory if you plan to use avatars.

Step 3: Admincp > Plugin & Products > Manage Products > Add/Import Product

Import the product-showroster.xml file.

Step 4: Admincp > Languages & Phrases > Phrase Manager > Phrase Type: ShowRoster > showroster_title --> Edit

Change this to whatever you want as the title of your roster.

Step 5: Admincp > User Profile Fields > Add New/Update User Profile Field

Add all the Profile Fields you plan to use and keep track of their number(s) (i.e. field6, field7, etc.).

Step 6: Admincp > Styles & Templates > Expand > ShowRoster Templates > showroster_header

This template contains the headers for each of your columns. Add/Edit/Remove columns to your preference. Be sure to update both of the colspan variables to the number of columns you have.

Step 7: Admincp > Styles & Templates > Expand > ShowRoster Templates > showroster_userbits

This template gets the data from each of the fields you want to have viewed on your roster. Add/Edit/Remove columns and/or the nowrap="nowrap" to your preference. Be sure to update each of the field#'s to match the fields from Step 5.

Step 8: Admincp > Usergroups > Usergroup Manager > Edit Usergroup

• Set "Access - Should this usergroup have access to the Showroster page?" to Yes for whatever groups you want to have permissions to access the showroster page.
• Set "Viewable - Should this usergroup be viewable on the Showroster page?" to Yes for the groups you want to have appear on the showroster page.

(All instructions are included in the instructions.txt and optional.txt files)


Updates:

Version 1.2.0 - May 24, 2008

• Release of this hack for vBulletin version 3.7.x.
• This version works on all vBulletin versions from 3.6.0 and up.
• This version works with vBadvanced CMPS version 3.0.1.

Version 1.2.1 - June 11, 2008

• Updated code for XHTML validation.
• Added a Date Joined column with code to support.
• Added a Last Online column with code to support; also changes color.
• Added a Birthday column with code to support; will be blank for users wishing to hide their birthday.
• Added a ProfilePic column with code to support.

FUTURE VERSIONS

• This version will no longer be supported or upgraded.

Click Here For A Preview

PLEASE CLICK INSTALLED.

Support will no longer be given for anything below vB4.x.

Go to Customizable Roster 4.0 for the newer supported mod.

[stalkertj]

Originally Posted by bryanb

Is this working on 3.8? Please let me know - thanks!

Yes it is.

[Gleedo]

Should a link to this roster page get added to the navbar automaticaly? I just installed on my test site, and no link was added?

EDIT: I have set my usergroup to Access and Viewable yes before anyone asks lol

Also found another issue i think. Some of our members had avatar style images for the profilepic field. I have gone through changing those profilepic images to their actual photos as we want those showing on the showroster.php page. Upon refreshing showroster.php, the old avatar style images are still showing.

If i view their profiles, the photo images I changed them to, show correctly? So I dont know why showroster.php does not show the updated profilepic images.....

Member profiles that had NO profilepic before I updated them, are showing correctly in showroster.php.

Any help appreciated

[XFSImperial]

Just installed this mod and was curious if I could have an option to sort the roster by Last Online date?

Edit: Nevermind, found the line of code in the file & edited it.

[Dagothar]

Greetings!

I have xfsimperial's question, but haven't found the correct line, evidently. :erm:

I need to sort by the Last Online, and followed the instructions in your optional.txt.

All fields sort fine except lastonline. I tried to sort by fieldname groupsort=lastonline (and groupsort=last_online), but I get a strict a alphabetic sort of username.

My SHOWROSTER is attached... what'm I doin' wrong??

Thanks!

[betts02]

ok we have this installed on our site but the lad who installs eveything on our site asked to to say :
"Checking the roster out I have noticed that the "On Trial" section is not being controlled by the set default sizes I have put on the <td> tags in the showroster_header & showroster_userbits <td> in terms of content it works fine, but size constraints I have edited into the td tags it hasnt picked up on the code and refuses to budge."

any ides what to do would be greatfull.cheers

[WavMixer]

Thank you for making this mod available to us. I have installed it and it is working as it is supposed to. Is there a way to add paid subscription information? I would like to display when they paid and when their subscription expires.

[yotsume]

Can you please post screen shots and a demo please.

THANKS!

[cbiweb]

This is a great mod. But when I add the following code to the showroster_userbits template, it doesn't work.

    <if condition="$show['imicons'] AND exec_switch_bg()"><td class="$bgclass">$userinfo[icqicon] $userinfo[aimicon] $userinfo[msnicon] $userinfo[yahooicon] $userinfo[skypeicon]</td></if>

Any suggestions?

[grey_goose]

So this will only do one character per user unless you do seperate rosters?

[CypherSTL]

Originally Posted by Murex

So there is no one that posted a way to only add certain groups in a certain order yet?

IE: groupid 10,6,20,18,14,21

I am also trying to figure this out. Anyone have any luck?