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.

[IR15H]

Originally Posted by stalkertj

I love this mod... just what I needed... couple of questions.

I have a couple different "styles (color schemes)" on my forum, the showroster mod is using the default one, but I of course don't want it to use that one. How do I make it use a different style?

Second, I'd like to make a clickable X-fire image link in one of the columns, that when you click it, it will interact with X-fire and automatically add the user. (Using the xfire:add_user... )

Any help, or any direction you can give I'd appreciate it. Thanks!

The roster should display in whatever style you are viewing the forum in.

In regards to the x-fire thing, assuming you already have a profile field for users to enter their x-fire and a column to place it on the roster, the code you want is;

<a href="xfire:add_friend?user=$user[fieldX]"><img src="http://miniprofile.xfire.com/bg/sh/type/3/$user[fieldX].png" border="0" alt="$user[fieldX]" /></a>

Replace "X" with the profiled field you are using, which will make it look like this. You can change the x-fire image, if you wish, by using the relevant code found on xfire's miniprofile page.

[stalkertj]

The xfire thing worked great, thanks!

However, I just finished up editing the navbar to show my Roster page instead of the Memberslist on the top... when I click that through the style I want it on, it goes back to the default style instead of the gaming style I have. Is there a way to force it? Or something else I can try?

[IR15H]

Originally Posted by stalkertj

The xfire thing worked great, thanks!

However, I just finished up editing the navbar to show my Roster page instead of the Memberslist on the top... when I click that through the style I want it on, it goes back to the default style instead of the gaming style I have. Is there a way to force it? Or something else I can try?

Are you able to change style once the roster has already loaded? Check to see if you've accidentally put styling information in the link to the roster; /blahblah/showroster.php?styleid=XX. If you have, then that'll be why it reverts to a different style to the one you're using. You can either remove that style info (so it displays in the same style the user is browsing in), or you can change the id to your gaming style, to force all users to view it in that style. If you haven't put style information in the link then I'd suggest reverting your showroster templates and seeing if that works, as there's nothing inherent in the mod to make it force to one style.

[stalkertj]

No, nothing is telling it to use a style, and yes I can switch styles once I'm on that page.

I'll force it to use the style I want by using that styleid in the link...

Thanks!

[bluesoul]

Originally Posted by Sarcoth

Hey everyone. I'm sorry I've been away so long. I started going back to school this semester and then on top of it all, my wife and I found a baby to adopt. All our time has been put towards the adoption and I haven't really had much of a chance at anything else. We are hoping to bring our baby girl home in the next couple weeks though. After that, I'll still be busy for awhile. But, as soon as things settle down I'll try to get back to work on updating this mod.

I'll try to reply to some of your questions over the next couple weeks. Please bare with me.

I assume that in the meantime there's absolutely no problem with using multiple php files for multiple communities, correct? While something that uses a query string might be a bit more elegant I can grin and bear it without too much trouble.

This looks like a really nice addon, I look forward to giving it a try.

[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

[stalkertj]

Not sure about that, but I just created new groups and then applied that group to the users I wanted... of course did the groups in what order I wanted them to appear.

[ddwgoose]

ok i have installed this mod but i cant seem to find it and have it appear on my website not sure what i missed.

[stalkertj]

Can you find it by going to the www.yoursite.com/forum/showroster.php ??


For me there was a lot of customization to do by hand, but once it was done the result is awesome.

[bryanb]

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