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.

[Brian30fl]

it all good no rush m8

[IR15H]

Originally Posted by michael5472

This worked with a bit of tweaking

I put this code in

<td class="$bgclass" nowrap="nowrap"><if condition="$user[field15]"><img src="http://www.gametracker.com/server_info/$user[field15]/b_560x95.png" alt="$user[field15]" border="0" /><else />No Server Tracked</if></td>

THANKS A LOT

No problem, glad it was useful for you .

Originally Posted by Sarcoth

UPDATE ALERT:

I've done a lot of updates on this mod over the last week. I am hoping to have the new version posted by the end of the week; Sunday maybe. The only thing I'm missing is the new permissions change that IR15H requested. I've always wanted to get switched over to that. I haven't looked at it yet, but I should have some time this week or weekend.

IR15H - I think I made all the changes you mentioned. I also have a working version with the color coded last activity you requested. I'll see about giving an optional addition for DOB for those that want it.

Michael - I added a profilepic part as well for those that want to use it.

Excellent! Thanks .

[Sarcoth]

<font color="Blue">I still can't get the permissions change thing to work. I tried to find a way to use what was suggested but I just don't see it. This hack uses a .php file, whereas the hack that I've been researching uses only templates and plugins. I still think it can be done, but it is just going to take me a lot longer.

I am going to take a look at getting the DOB added. Whether I get that working or not, I should have the new version released soon. The new version will be various fixes and minor additions that have been requested.</font>

[Replicators]

One thing i don't like about this mod is if a members has another usergroup, it shows them in that group in the list. Is there a way to not have them show up in their secondary usergroup in the roster?

[Sarcoth]

Originally Posted by Replicators

One thing i don't like about this mod is if a members has another usergroup, it shows them in that group in the list. Is there a way to not have them show up in their secondary usergroup in the roster?

This mod was mainly built for a guild roster where each member would only appear in one rank. Either they are the leader, officer, member, recruit or whatever. Not possible to be more than one. I will see if I can come up with some optional code to do this for you though. It just won't be part of the actual mod; you'll need to make the edit's to get it to work.

[theparentpack]

Does this replace my existing member list, or can I use it to create an additional roster for my various social groups and usergroups?

[Deyth]

Sarcoth, would you be willing to expand this mod for some money? I lead a multi-gaming guild and this roster, although nice, is single-game with no historical info. What I need is to define games, game servers, and their characteristics (races, classes, sub-classes, levels, etc.), let every board user enter their historical character data for every game and server I've defined, and then show a roster for the usergroups I select with the ability to narrow down by game and/or server. If you do this, it'll be THE definitive mod for gaming guilds.

[Dagothar]

I want to thank Sarcoth, who filled a major hole for us with this great mod. His upcoming update, to allow multiple versions, will also greatly help.

Originally Posted by theparentpack

Does this replace my existing member list, or can I use it to create an additional roster for my various social groups and usergroups?

No, and Yes.

Personally, I use this for my main Members' roster, for my Age of Conan guild. It's so nicely customizable, and sortable. I put it right up front on the menubar, and limit access to members who've successfully undergone our trial process.

I use the native showgroups.php for the leaders only, and crank it down to show just the leaders with the Admin CP Usergroups CP.

I use the native memberlist.php for all the registered users. That's buried in Quick Links.

http://the-sentinels.net/forum/

[ProtoPC]

Yes this will be a great addition! I am waiting for the multiple roster version.

[Brian30fl]

same i need the multiable roster edtion for my 10 guild alliance