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.

[Pauleh]

I like this roster Im in the process of installing it to my site, im wondering though is it possible to add a option to add characters that belong to members (since in most guilds almost everyone has a alt) so to display the alt level etc would be a nice feature to add.

[Warion]

Originally Posted by Warion

Any help would be appreciated. I know I am asking alot, but I think this would be something not only I woudl use but others as well. I am also interested in mulit-guild roster too. One question I have on the multi-guild roster would be would each guild have its own primary roster or would it be listed all on one.

Also would like the ability to allow users to add alts to roster. I run a site with 4 games. I need to be able to run a roster for each game. Some user have characters in a couple of the games so users would be allowed to add alts in any of thier choice. This would be an awsome mod if someone would help here.

[fatal1980]

Great mod.

I have some ideas to improve on this mod, I don't know if they have been brought up before as I haven't read the all the responses to this mod. But I'm just going to give you my ideas, take them or leave them I just want to share them.

The one way I see this working out as a great mod is by centering everything around creating rosters. You could create as many rosters as you like.

The options when creating the roster would be, name of roster, variable to call roster in template system, template to display roster (this would allow you to add all the fields you wanted and any html so you could make the roster look the way you wanted it to look) and of course sorting or manual sorting.

Once the roster is created. You can then add roster items. These items would either be an entire usergroup, specific users, or users based on a user field they have set or created as a hidden field by the administrator. The user field or specific users could be used to list administrators of specific game server. You could create usergroups instead, however who wants 5 usergroups just for a mod, it wouldn't be clean.

Furthermore, you may want user field roster items to be generated one creation and saved in the db. Calling a SELECT * on the user db for a specific field everytime someone loads the roster page would be time consuming on big boards. New users with new field items, well you could create a cron to do a daily update, or provide a link to re-generate the lists.

The last options would be sorting of the items within the roster, depending you may want founders first, then a specific group..etc. This is something that is huge.

I may be doing this for a site that I run at the moment, would it be possible for me to build on your mod? Or at least use bits and pieces giving you full credit for your work?

Cheers, and thanks again for a great mod.

[Warion]

That is an awsome idea. Do you think you would be able to do this yourself with the mod in hand. I have attempted to contact the coders here several times. Actually I'm a member of the vangaurds forums but yet to get a response from them. It is like the coders gave up on this mod. It has great potential.

[Kurgan]

Originally Posted by Unshra

Is there anyway to have the roster sort by 'usergroupid' but have the 'title' displayed? When I follow the optional install for sorting by usergroupid it sorts correctly but the group titles are replaced by the groupid number on the roster or is there something I am doing wrong?

Easy fix for this:

Change this line of code in showroster.php

		if ($groupsort == '') { $groupsort = 'title'; }

to

		if ($groupsort == '') { $groupsort = 'usergroupid'; }

as described in optional.txt

Then, edit the showroster_header template, and find this text:

	<if condition="($groupsort == 'username')"><td class="tcat" colspan="12">Usernames &nbsp; ($usercount)</td>
	<else /><td class="tcat" colspan="12">$user[$groupsort] &nbsp; ($usercount)</td></if>

and replace it with:

	<if condition="($groupsort == 'username')">
		<td class="tcat" colspan="12">Usernames &nbsp; ($usercount)</td>
	</if>
	<if condition="($groupsort == 'usergroupid')">
		<td class="tcat" colspan="12">$user[title] &nbsp; ($usercount)</td>
	<else />
		<td class="tcat" colspan="12">$user[$groupsort] &nbsp; ($usercount)</td>
	</if>

[Warion]

1. Has anyone figured out how to set this up to allow users to add multiple characters to the roster.

2. I am also interested in using this for multi game rosters all on same database.

I have searched and waited so long, i grow dim with hope. Someone has to know how to do this. I have attempted to contact mod creator but they arent respondinf to emails, IM's. Heck, I bough Vanguard just so I could talk to the coder but they havent been in game for awhile according to the people on their website and in game.

Anyone, anywhere, someone, somewhere.... help.

[Trek]

Originally Posted by Warion

1. Has anyone figured out how to set this up to allow users to add multiple characters to the roster.

2. I am also interested in using this for multi game rosters all on same database.

This is pretty much what I'm looking for as well, multiple toons per user and multiple rosters.

[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.

[IR15H]

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.

No worries. Thanks for the info and good luck with things!

[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!