Profile Enhancements - Customizable Roster (Member List)

Customizable Roster (Member List)
[How to] get a working Guild/Clan Roster

Note: This modification is now discontinued - this means that while it will remain available for download and use, support will no longer be provided as the thread is no longer monitored. Please see the 3.7 release of this modification for future updates here.

Introduction:

This Mod started off as a [How to] template modification. I have since added in permission control and an installer. Those that install this Mod will need to make adjustments to two templates and one phrase depending on what you want displayed. I'll include instructions for each step as well as optional changes you can make at your decretion.

Click the following link for a Guild Roster preview: http://vanguard.sacredhaven.org/forums/showroster.php

You'll notice that I use the "Extra Profile Fields Page" by Wired1. It isn't needed for the Roster, but I think it makes the field updates look nicer for the users.


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 the colspan 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.

Enjoy!!!


Versions:

v1.1.3 - April 22, 2007

• Added 'Who's Online' plugin to the installer (Thanks m002.p).
• Made an update to the optional.txt file for changing the default sort.

v1.1.2 - April 20, 2007

• Added sorting to the roster. This is optional and will work without adding the sorting features.

v1.1.1 - April 19, 2007

• Small update. Just added total member count.

v1.1 - April 5, 2007 (Mod Revamp)

• Revamped everything. There is now an installer to do most of the work for you.
• The installer adds two new fields to your usergroup table. This allows you to set permissions for the showroster rather than using the showgroups permissions.
• Removed a few options from the optional.txt file since they are now a part of the mod.

v1.03 - April 2, 2007

• Added some code back to the showroster.php so join date, last activity, and usernames HTML markups could be used.
• Changed $user[username] to $user[musername] in the showroster_userbits template. This will allow HTML markups to the usernames again.
• Added instructions on how to change which usergroups appear on the Roster.
• Added optional.txt to the zip for optional changes.

v1.01 - March 27, 2007

• Changed a few variable names.
• Changed template names.
• Removed a lot of unneeded code from the showroster.php.
• Added the ability to include user avatars.
• Added a counter to keep track of how many users in each usergroup.

v1.01 - March 9, 2007

• Removed a lot of unneeded code from the SHOWROSTER template.
• Fixed a couple code problems.

v1.0 - March 6, 2007 (Initial Release)

[sheryarpatel]

Originally Posted by Sarcoth

That question was already asked and is something I'm working on. I need to get something else done first though.

woot ok can't wait for the changes :up:

[JeffreySmith]

Awesome, your da MAN! Thanks for the support my friend.

I clicked installed too.

[Sarcoth]

I've attached instructions on how to add a Class Statistics Counter to those Vanguard Rosters. You could easily do something similiar for any game, but you would need to alter the class names within the code.

Class Statistics Counter

[hellbringer80]

Hey sacroth, thanks for this mod, am using and lovin it. One question, I see on your demo site you have the groups organized, I have a group for ever rank in my clan kind of like what you have. However I need to order them by a mysql column that I made titled orderid... Is there anyway to order them in a different way then what they are. I tried adding a "ORDER BY orderid ASC" type code to the end of the mysql query you have set in the php file for showroster.php however you already have a order in alphabetical order that I just don't understand because I don't code with vB, only custom. If you could help me out on this, I would greatly appreciate it.

[grecostimpy]

I only get a blank white page unfortunately....

Here's what I did, I'm using your hack (brilliant, BTW) to display our member's Ebay Usernames from a custom profile field.

Here's what I did:

I uploaded showroster.php to my forum's root

I created a custom profile field called Ebay Usernames (field5)

I created a custom phrase (GLOBAL) with the varname: show_roster Text: Users on Ebay

I created the SHOWROSTER template exactly as shown in the instructions...no changes

I created the showroster_usergroup as shown below:

<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
<tr>
	<td class="tcat" colspan="2">$user[title]</td>
</tr>
<tr>
	<td class="thead">$vbphrase[user_name]</td>
	<td class="thead">Ebay<br>Username</td>

	
$usergroupbits
</table>
<br />

I then created the template for showroster_usergroupbit as shown below:

<tr>
	
	<td class="$bgclass">
		<a href="member.php?$session[sessionurl]u=$user[userid]">$user[musername]</a>
	</td>
	
	<td class="$bgclass">$user[field5]</td>


</tr>

I then set View Forum Leaders to Yes (and changed all usergroups to show on the Forum Leader's list)

Any ideas why this would not be working? All I get is a blank white page.

Note: When I go into Vbulletin Options and disable the Forum Leader's Page, I get the permission error as opposed to the blank white page.

I know this is bit outside the scope you originally intended it, but I think its a great way to display custom profile fields.

Thanks for your help!

[m002.p]

Hi,

Im having a problem inserting an image into the "showroster_usergroupbit" template.

This is what I enter:

<td align="center" class="$bgclass" nowrap="nowrap">$user[field10]
<img src="forum/images/flags/$post[field10].gif"></td>

The image doesnt seem to display even when the code works elsewhere.

Can you spot the problem?

Thanks in advance!

[SgtOliver]

Anyone know how I can include the persons avatar in this list? I have tried adding

<td><img src="$user[avatarurl]" $user[avatarsize] alt="<phrase 1="$user[username]">$vbphrase[xs_avatar]</phrase>" border="0" style="border:1px solid $stylevar[tborder_bgcolor]; border-top:none" /></td>

[Sarcoth]

Originally Posted by hellbringer80

Hey sacroth, thanks for this mod, am using and lovin it. One question, I see on your demo site you have the groups organized, I have a group for ever rank in my clan kind of like what you have. However I need to order them by a mysql column that I made titled orderid... Is there anyway to order them in a different way then what they are. I tried adding a "ORDER BY orderid ASC" type code to the end of the mysql query you have set in the php file for showroster.php however you already have a order in alphabetical order that I just don't understand because I don't code with vB, only custom. If you could help me out on this, I would greatly appreciate it.

Look at post #30 above. I think you may be able to get this to work by changing $user['title'] to $user['orderid'].

grecostimpy - I've only seen blank pages when something in the PHP file doesn't call up the correct template files. Double-check the names of your templates. I'll see if I can figure out any other problems that may be causing it.

m002.p - I'm not too keen on images in this hack, but try removing forum/ from that code.

SgtOliver - I'll look into it.

[Sarcoth]

Originally Posted by SgtOliver

Anyone know how I can include the persons avatar in this list? I have tried adding

<td><img src="$user[avatarurl]" $user[avatarsize] alt="<phrase 1="$user[username]">$vbphrase[xs_avatar]</phrase>" border="0" style="border:1px solid $stylevar[tborder_bgcolor]; border-top:none" /></td>

I tested a few things but I couldn't get it to work. I can't really spend much time on it, sorry. I would suggest looking over the memberlist.php and using code from there. There will be a lot of if statements involved with it for sure. I'll try to get back to this eventually though. I'm interested in making it work.

[Sarcoth]

grecostimpy - I've looked over your process a dozen times and I don't see anything wrong with it. The only thing I can think of is that one of the templates are spelled incorrectly; typo maybe. Double check and let me know.