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.

[Spank]

Hi I've just installed and need a little help. I need to not sort by usergroup, just to group all of the members together. also I have a calculation setup to work out the value of field6 'divided by' 7 'multiply by' 100 which I have as $percentage. How do I get this to display in the roster? I've tried just typing in $percentage but nothing is being displayed.

Once I can get those things sorted it will work exactly how I want.

[Warion]

How would I go about setting this mod up for people who wish to add their alt characters to the roster?

Any help would be appreciated.

[Dagothar]

Originally Posted by Warion

How would I go about setting this mod up for people who wish to add their alt characters to the roster?

Any help would be appreciated.

Easy. We do that. Merely create a User Profile Field in your ACP for each alt you wish to show on the Showroster, and set showroster to show that field.

Enjoy!

[Warion]

yea if I only wanted the names of the alts, but I want it to be a way for a person can click on a button named "Add Alt" this would allow a person to add anywhere from 1 to 10 alternate characters. For each alt to show all the fields that are in the roster

[Dagothar]

Originally Posted by Warion

yea if I only wanted the names of the alts, but I want it to be a way for a person can click on a button named "Add Alt" this would allow a person to add anywhere from 1 to 10 alternate characters. For each alt to show all the fields that are in the roster

Aha. Well, that's definitely more complicated, and also definitely not in my expertise. GL!

[Sarcoth]

I've been working on a few things lately and looking over this mod when I get the time. I'm not as awesome a coder as some of the other Coder/Designers around here, but I do try to give my mod some attention when able.

Anyhow, I will try to answer some questions. Please make sure you click installed if you want assistance. If I don't see installed, I will assume you are no longer using this mod and skip your question.

Originally Posted by Warion

yea if I only wanted the names of the alts, but I want it to be a way for a person can click on a button named "Add Alt" this would allow a person to add anywhere from 1 to 10 alternate characters. For each alt to show all the fields that are in the roster

That is going to be rather complicated. This mod has been designed around one entry per user. I suppose a new table could be added that links to the userid and then have everything feed off of that, but we are talking about a lot of work there. I still want to make the multi-roster work before I consider looking into something like this. I'll let you know.

Originally Posted by Spank

Hi I've just installed and need a little help. I need to not sort by usergroup, just to group all of the members together. also I have a calculation setup to work out the value of field6 'divided by' 7 'multiply by' 100 which I have as $percentage. How do I get this to display in the roster? I've tried just typing in $percentage but nothing is being displayed.

Once I can get those things sorted it will work exactly how I want.

That should be easy enough to figure out. Can you give me a link to your roster page? Make sure guests can view it please. I most likely will need you to PM me copies of your showroster.php and any templates you have made changes to.

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?

Do you still need help with this? The answer is yes. You need to set up a case or if statement that applies a value to something depending on the usergroupid. I'll go into more detail if you post a reply here.

[Spank]

My roster is at http://www.empyron.com/forums/showroster.php

I'll pm you the files if you need them

The calculation I have is a plugin at postbit_display_start, if that means anything =D

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

[gundrik]

Just installed it and I'm loving it so far. I am having a problem though when adding new user profile fields. Whenever I submit the new information in the "Edit Details" page I get an error that says, "You have entered an invalid birthday."

I sent you a PM with more details. Thanks for all the hard work Sarcoth. =)

SOLVED - I had to put in my year of birth in user cp for the error to go away.

[Arjan]

Great looking mod.
Are you planning to add some features to make it more like a clan management system or will you keep it to a roster only?
A system to enable people to signup would be nice for example.