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)

[Sarcoth]

Originally Posted by Brian31fl

bump check the post above it was edited with the information

Ohhh, I thought you meant line up in regards to header vs. rows. You mean they don't all have the same column width. That's easy enough. Just edit the _header template. Copy the following.

<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
<tr>
	<td class="tcat" colspan="9">$user[title] &nbsp; ($usercount)</td>
</tr>
<tr>
	<td class="thead" width="15%"><center>$vbphrase[user_name]</center></td>
	<td class="thead" width="20%"><center>Character Name</center></td>
	<td class="thead" width="15%"><center>Character Class</center></td>
	<td class="thead" width="15%"><center>Character Level</center></td>
	<td class="thead" width="15%"><center>Character Sex</center></td>
	<td class="thead" width="20%"><center>Avatars</center></td>
	
$rosterbits
</table>
<br />

I also updated the counter in the group title for you (  ($usercount)). Take it out if you don't like it.

[Brian31fl]

thanks buddy like my skin for my guild site ?

[Sarcoth]

Originally Posted by Brian31fl

thanks buddy like my skin for my guild site ?

Yes. I especially like the runed side and bottom borders.

BTW, don't forget to upload that spacer.gif file to your /forum/images/ folder. That will get rid of those little red x image errors.

[Brian31fl]

oh okay didnt see them i use firefox yeah i started doing that theme during my xmas vaction and still keep improving it btw great job on the guild hack

[m002.p]

Hi again Sacroth, ive upgaded to your new 1.02 with success bar the username display. You have changed the variable $user[musername] to $user[username]. I use colour coded usernames so this new variable I dont like could I request you add the old one too?

Thanks & GJ

EDIT: I noticed the showroster.php you added above for Gator included the $user[musername] variable. I tried this by overwriting the current on server only to get a db error mentioning that this is unrecognised in the db :s

WHERE (usergroup.showrosterviewpermissions = 1)

If you want I can post the whole message

Thanks

[Sarcoth]

Originally Posted by m002.p

Hi again Sacroth, ive upgaded to your new 1.02 with success bar the username display. You have changed the variable $user[musername] to $user[username]. I use colour coded usernames so this new variable I dont like could I request you add the old one too?

Thanks & GJ

EDIT: I noticed the showroster.php you added above for Gator included the $user[musername] variable. I tried this by overwriting the current on server only to get a db error mentioning that this is unrecognised in the db :s

WHERE (usergroup.showrosterviewpermissions = 1)

If you want I can post the whole message

Thanks

moo2 - I'm not sure I understand. I'm going to go ahead and update the hack and you can try that. See if that fixes your problem. I have it all working on my test site. I'll help you if I can.

[Sarcoth]

I just updated the showroster hack with various changes. Please don't upgrade to it if you used the permissions installer. It isn't making use of the permissions. That will be introduced in my variation hack I plan to release soon. If you have any problems with this hack or my permissions test from last week, let me know and I'll do my best to help.

[grecostimpy]

Still using the permissions version...working great!

[lulanglo]

Hi Sarcoth,
really nice roster, I am trying to modifie the code to our guild need and i would like to have an icon instead of the name of the class, I am not a Vbulletin guru do you think you could help me ?

I created a Single-Selection Menu user profile field with a selection of 8 classes, what I am trying to do is do a if condition and show the right class icon acording to the selection.

here is what I tried but i cant get it to work

<td class="$bgclass" nowrap="nowrap">
<if condition="$user[field6] = warrior "><img src="images/classes/warrior_icon.gif" alt="Warrior" /><else />$user[field6]</if></td>

the icon is showing up but the problem is, it showing up even if field6 does not equal warrior...... and how can i do multiple statement ? like if it warrior show warrior_icon.gif and the same for 8 different class ?

Thank you.

[Sarcoth]

Originally Posted by lulanglo

Hi Sarcoth,
really nice roster, I am trying to modifie the code to our guild need and i would like to have an icon instead of the name of the class, I am not a Vbulletin guru do you think you could help me ?

I created a Single-Selection Menu user profile field with a selection of 8 classes, what I am trying to do is do a if condition and show the right class icon acording to the selection.

here is what I tried but i cant get it to work

<td class="$bgclass" nowrap="nowrap">
<if condition="$user[field6] = warrior "><img src="images/classes/warrior_icon.gif" alt="Warrior" /><else />$user[field6]</if></td>

the icon is showing up but the problem is, it showing up even if field6 does not equal warrior...... and how can i do multiple statement ? like if it warrior show warrior_icon.gif and the same for 8 different class ?

Thank you.

Try this instead.

Open the showroster.php file.

Find:

$usercount++;

Below it add:

$classurl = 'images/spacer.gif';
if ($user[field9] == 'Warrior') { $classurl = 'images/classes/warrior.gif'; }
if ($user[field9] == 'Bard') { $classurl = 'images/classes/bard.gif'; }
$classimage = '<img src="'.$classurl.'" border="0" alt="'.$user[field9].'">';

Add more if { } lines for additional classes and change the $classurl path to match the location and names of your images.

Then go to the showroster_userbits template.

Use this instead of the code you are using:

<td class="$bgclass" nowrap="nowrap">$classimage</td>

I don't see the need for a conditional here here as long as you list all the class if statements in the .php file. Since you already supply the user with a drop down with all the classes, they can't enter their own.

I hope that helps. I tested it and worked for me.