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.

[Sarcoth]

Originally Posted by IR15H

Some Questions

1) My suggestion for custom order is to have all usergroups named with a number in front of it: 1-, 2-, etc. Then put something like the following within the .php file to change the $user['title'] names to what you want to appear.

switch($user['title']) { 
	case '1-A':
		$Title = "A";
		break;
	case '2-D':
		$Title = "D";
		break;
	}

Then you need to figure out how to get that into your template.

2 & 3) I'll look into that when time permits.

Originally Posted by IR15H

Some Suggestions

I'll definitely try out your suggestions and put those in my next version, thank you.

Originally Posted by IR15H

A Request

I originally tried to do that when I first started off making this mod but had some problems. I have a much better understanding of the code now though and will see about getting it changed for the next version. Again, thank you.

[michael5472]

Originally Posted by IR15H

I don't know how to enable BB code in the field, and I can't view users profiles without signing up, so don't know what else you use the "Play Monitor" field for, but a possible idea that may you might find suitable is;

• Change your "Play Monitor" description to say "Enter the server IP you wish to track".
• Enter the IP in that field: eg; 217.163.28.224:28960
• In your showroster_userbits template, put this;

If that's not of any use to you then I'm afraid you'll have to wait for someone else to reply regarding enabling BB code, as I can't help you.

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

[michael5472]

ok i just showed my members what i had been working on and one thinks it would be a good idea to have the profile pic on like the avatarl.

How would i work this in ?

[Code Monkey]

Is this limited to one clan only or can it be used by multiple clans that home at a forum? To show their own separate clan page.

[Dagothar]

Well, I apologize, but my newness to vBulletin has potentially screwed something here. Your instructions were very clear, and I've been looking forward to your roster.

But I see no difference to the configurable Members List nor to the Roster/Show Groups (View Forum Leaders' Page).
I've ensured I've added the 3 files to the correct place; I've followed all the Readme.txt instructions.
Why would it then not show? It should replace the Members List, correct?

[Sarcoth]

Originally Posted by michael5472

ok i just showed my members what i had been working on and one thinks it would be a good idea to have the profile pic on like the avatarl.

How would i work this in ?

I'll see what I can figure out on that.

Originally Posted by Code Monkey

Is this limited to one clan only or can it be used by multiple clans that home at a forum? To show their own separate clan page.

I'm sure it can be done with multiple clans. The easiest way would probably be to have separate showroster.php files for each clan. Just rename the showroster.php to the name of your clan like, clan1roster.php. Add a new field that has the players pick their clan. Somewhere near the top of the code, set up an <if> statement that only runs the code for those that happen to be in that particular clan.

I'm sure there's a way you could also do it with just the showroster.php file and by adding some more code, I just can't see it yet. As long as your fields are not too difficult, I could try to come up with something for you.

Originally Posted by Dagothar

Well, I apologize, but my newness to vBulletin has potentially screwed something here. Your instructions were very clear, and I've been looking forward to your roster.

But I see no difference to the configurable Members List nor to the Roster/Show Groups (View Forum Leaders' Page).
I've ensured I've added the 3 files to the correct place; I've followed all the Readme.txt instructions.
Why would it then not show? It should replace the Members List, correct?

Did you go to the /forum/showroster.php? You'll need to type that in and make a link to it somewhere on your site. You could find where the Member List code is in the navbar template and change the link too.

[Dagothar]

...Did you go to the /forum/showroster.php? You'll need to type that in and make a link to it somewhere on your site. You could find where the Member List code is in the navbar template and change the link too.

:erm: :up:
No, I hadn't. But type that in, and Voil?, there it is!
Now to find that pesky navbar code...
Thanks!!

[Sarcoth]

<font color="Blue">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.</font>

[Brian30fl]

are u adding the ability to have differant guilds to be used instead of just 1? or maybe seperate roster pages?

[Sarcoth]

Originally Posted by Brian30fl

are u adding the ability to have differant guilds to be used instead of just 1? or maybe seperate roster pages?

Brian, I'll try to dabble in that a little this week and see how far off I would be from implementing it. If I can't finish it by the end of this week though, I'll make that my top priority for the next version. I've been playing with some idea's lately though and I think I know how it can be done; no promises yet.