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)

[JBMoney]

Sorry, I don't know any other way to describe it. At my place, different sub-forums use different styles. I thought that was pretty common in vb world. I didn't want to use my forum's default style for the game roster.

e.g. the default, http://bressler.org/forum/index.php
e.g. a subforum, http://bressler.org/forum/forumdisplay.php?f=10
e.g. gaming forum, http://bressler.org/forum/forumdisplay.php?f=8

If there's not a way to set it dynamically, I can just strip out and replace $header in the SHOWROSTER template. Fortunately, so far, the difference is limited to mostly the banner. Just means I'll have to change that template by hand every time I change styles.

[JBMoney]

Great mod, btw!

I'm using it in conjunction with 'Extra Profile Fields Page v.2.1.0', which gives me a separate place for folks to enter their character info. Only a small % of my members are involved with the gaming guild, so it keeps those form fields from being combined with the general info form fields.

[odie3]

I wonder if I could use this some how for our roster but we play First Shooter games [BF2:PR and sometimes Americas Army]....

[Brian31fl]

Originally Posted by odie3

I wonder if I could use this some how for our roster but we play First Shooter games [BF2:PR and sometimes Americas Army]....

yeah you can you just have to make the profile fields you need.... I have a guildwars guild site and i use this for that ill show an exsample altho its an older version havent had time to mess with the new 1 but i do have it downloaded.
http://sacred-dragoons.com/forums/showroster.php

[m002.p]

Hey nps Sarcoth, there is only so much you can do

I also have a question;

Could it be possible to add a total member count?

$usercount is used for catergory totals, but what about an absolute total of all catergories? It could be displayed next to the showroster title....

[Sarcoth]

Originally Posted by 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.

Cerulean - What file do you mean? This Mod has no connection to WoW or any other game, it should be useable for just about any site or for any reason. I use it for my Vanguard: Saga of Heroes guild. My Mod can work well with the Extra Profile Field hack if that is what you mean. I think using that hack will make it easier to use this Mod if you are using profile fields.

[Sarcoth]

Originally Posted by JBMoney

Sorry, I don't know any other way to describe it. At my place, different sub-forums use different styles. I thought that was pretty common in vb world. I didn't want to use my forum's default style for the game roster.

e.g. the default, http://bressler.org/forum/index.php
e.g. a subforum, http://bressler.org/forum/forumdisplay.php?f=10
e.g. gaming forum, http://bressler.org/forum/forumdisplay.php?f=8

If there's not a way to set it dynamically, I can just strip out and replace $header in the SHOWROSTER template. Fortunately, so far, the difference is limited to mostly the banner. Just means I'll have to change that template by hand every time I change styles.

The good news, I understand what you mean now. I'll look into this for you soon as I get back from my travel. I'm sure there is a way to do it. Just figuring it out is the key.

Great mod, btw!

I'm using it in conjunction with 'Extra Profile Fields Page v.2.1.0', which gives me a separate place for folks to enter their character info. Only a small % of my members are involved with the gaming guild, so it keeps those form fields from being combined with the general info form fields.

Thanks. Yea, that I think is the best way to do it when you are using profile fields.

[Sarcoth]

Originally Posted by odie3

I wonder if I could use this some how for our roster but we play First Shooter games [BF2:PR and sometimes Americas Army]....

This game be used for any game or site that would like to display a roster with profile fields. I think it has a lot of use. I don't see why you couldn't use it for a FPS game.

[Sarcoth]

moo2.p - Yea, that would be easy to do. I'll give you a file update next week when I get back. I'll make sure to have that in the next upgrade as well. I always meant to have it in there, but kept getting side-tracked with other options.

[lulanglo]

Hey Sarcoth !

I really love the sort feature you have on your roster how did you do it ?

another thing i like is the joined date, I am trying to use $user[joindate] but i end up with the unix date, how did you format it ?

Cheer!