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)

[cerulean]

How can I change the sort so it isnt by username but by say Field11?

[Sarcoth]

Originally Posted by cerulean

How can I change the sort so it isnt by username but by say Field11?

Please remember to click installed.

Right now it is by group title and then username, so I'm assuming you want to keep the group and then do field11 in place of username.

Open the showroster.php.

Find:

$u = strtoupper($user['username']);

Replace with:

$u = strtoupper($user['field11']);

That's it.

[Sarcoth]

Originally Posted by JBMoney

Maybe a better choice of words is simply style.

I'd like to use a style other than my forum's default style. I haven't seen a place where I can change the style for this page.

Sorry for the misstatement.

I'm sorry JB, I'm still not sure what you mean. I'm more than willing to help if I can.

Are you trying to change the layout of the showroster.php page?

@ moo2.p - I'm working hard to get the coding for sorting put in this as well. I am hoping to have that included in the next update. I came up with a good way to handle it today and now just need to get the code together.

[m002.p]

@JB > if you mean the showroster.php forum style, you need to edit the templates for the particular style you have not the default style templates. Like Sarcoth im not understanding what you mean but im sure we could help

@Sarcoth > im looking forward to the release it has helped me learn alot more about variables & coding. I like my roster now thanks to your work but doesnt mean to say i wont install it and see whats new

Good Job.. are you planning to release any other hacks clan or guild related? lol

Matt

[Sarcoth]

@ moo2.p - Well, I got the sorting to work on my test server. I need to play with it a bit more so it looks nice and then I'll get it added to my live version so others can see it in action. I should have it ready for release on Monday or Tuesday.

I'm always up for making new things useable for my guild site, but I don't have any idea's right now. The roster has always been a biggy for me.

[Sarcoth]

I've gotten the sorting put together for the most part. I still need to work out a few parts of the code. Take a look at my test example on my guild site. Let me know if the sorting interests you.

Showroster Sort Testing

The sorting bar is just beneath the ShowRoster Title. I'll get the color for that changed later as well so it stands out more.

[m002.p]

yea i like that alot mate. I would utilize that for my site also.

Good job and keep up the good work!

[JBMoney]

Originally Posted by Sarcoth

Are you trying to change the layout of the showroster.php page?

My main forums use a certain style.

My gaming forum use a different style.

I'd like the roster to use the style that the gaming forum uses, not the style that the main forums use.

How can I set that or customize it?

[Sarcoth]

Sorry guys. I'm going to have a delay on getting an update out. I also won't be active her for about a week. Something has come up and I'll be on travel till next week.

@JBMoney - Can you give us a link to your site for an idea of what you mean. I'm not quite sure how you are using two different styles. I'll try to help you when I get back.

[cerulean]

I see your Mod relies on a file that is downloaded from another area. I would like to use this program to its full extent but our site is not WOW. Any easy way to convert this or give the way this file looks so we can use it.