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)

[dbirosel]

<a href="http://www.caraudiojunkyard.com/forum/showroster.php" target="_blank">www.caraudiojunkyard.com/forum/showroster.php</a>

Those who did not input anything on the field, how can they be invisible?

[turnipofdoom]

This did not appear to be compatable with the version of php I'm currently running, I ended up going with RosterMaster standalone (what I wouldn't give for it to be vB integrated.) Ah well, thanks, though, for creating this for the gaming community. We need more mods like this for games other than "that Blizzard one."

[dbirosel]

I want to change the filename and variables to "donationlist". If it's possible, how do i accomplish this?

[Sarcoth]

Originally Posted by oglsmm

That worked great. Thanks a lot. This really is a great MOD for Guild sites. I've been looking for one forever, and finally there is one

One last question, is it possible to make the list sortable by the custom fields?

There is, but I'm not quite there yet. I plan to add this in the future though.

Originally Posted by dbirosel

What if i want to add them manually to the list? I don't want them to edit there member profile and get automatically to a usergroup. Is it possible for me to add them manually and of course easier?

You can create or edit the fields so they can't be editable by the user. There is a selection for that. Go to Admincp > User Profile Fields > User Profile Field Manager. Click on Edit next to the fields you want to change and select 'No' for 'Field Editable by User'. You can then enter the data for each user by going to their user profiles; where you edit their membergroups.

Originally Posted by dbirosel

Those who did not input anything on the field, how can they be invisible?

I hadn't thought about doing that since I'm rather strict. I gave all my members a deadline of two weeks. If they don't have it updated I'm removing them from the guild. I like to keep track of who updated their data. Not sure I'm going to go that route with this mod. I'm sure there is a way to do it though.

Originally Posted by turnipofdoom

This did not appear to be compatable with the version of php I'm currently running, I ended up going with RosterMaster standalone (what I wouldn't give for it to be vB integrated.) Ah well, thanks, though, for creating this for the gaming community. We need more mods like this for games other than "that Blizzard one."

Sorry that didn't work for you. What version of PHP are you running?

[Sarcoth]

Originally Posted by dbirosel

I want to change the filename and variables to "donationlist". If it's possible, how do i accomplish this?

There is an easy way and a harder way. You'll have to figure out the harder way on your own because it would take also updating the .php file. Follow all my steps above except rename the showroster.php to donationlist.php.

For Step 3, I would put 'Donation List' in for your text.

The .php file refers to the templates, not the other way around. So there shouldn't be any need to change anything else. If you have a problem let me know and I'll look into it some more for you.

[sheryarpatel]

hey nice mod
is their anyway that the data can be organized like form highest player level to the lowest or something like that?

[Sarcoth]

Originally Posted by sheryarpatel

hey nice mod
is their anyway that the data can be organized like form highest player level to the lowest or something like that?

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

[JeffreySmith]

Hi, great mod man. really I mean it. Thanks.

But my problem is this:

The order that the usergroups show up in.

I currently have the following usergroup order:
1. admin ID 6
2. enlisted ID 12
3. officers ID 11

What I need:

1. admin ID 6
2. OFFICERS ID 11
3. enlisted ID 12

I would be fine in leaving it the way it is, but knowing my clan they are gonna want the Officer usegroup listed above the Enlisted guys.

Any ideas?

Thanks so much

Jeff

PS: The roster is located at: http://dmclanforum.com/showroster.php

[Sarcoth]

Jeff, I had the same problem. The groups are organized alphabetically. The way I got around it was renaming the groups a little.

My groups were originally: Guild Leader, Member, Officer, Recruit. I wanted Officer to be second, so I decided to rename it Guild Officer.

In your case, I would recommend renaming DM Enlisted to DM Member. Another option would be taking DM off the DM Enlisted. Not sure it will work for you, but that's the best advice I can recommend for that one. Sorry.

Please click install.

[Sarcoth]

Jeff, I found an answer for you while playing with some of the code.

This change will allow you to sort the groups by their groupid.

Open showroster.php

Find:

$t = strtoupper($user['title']);

Replace with:

$t = strtoupper($user['usergroupid']);

Then upload the updated showroster.php to your site.

FYI - Anyone that wants support, you need to click Install.