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)

[m002.p]

Yes this mod will work with any game. The mod does not depend on the game as it is made as a customised & more sophisticated "showgroups.php" and the subject could be anything in truth. You could utilise this hack as a more detailed "view forum leaders".

Ive used mine for SWAT 4

[Wolf Link]

Originally Posted by m002.p

Yes this mod will work with any game. The mod does not depend on the game as it is made as a customised & more sophisticated "showgroups.php" and the subject could be anything in truth. You could utilise this hack as a more detailed "view forum leaders".

Ive used mine for SWAT 4

Thank you, sir. I've made up my mind, now.
*installs*

Appreciate it

[Sarcoth]

Wolf, sorry I didn't get back to you on that sooner. Thanks m002.p.

[VenomMaster]

Hi there,

fist i have to say that this mod is awesome.

Second, i got my first question: I use this on my site (http://www.kommando-xiv.de/board/showroster.php), and now i tried to integrate my Award System with this.

But - sorry to say - it doesn't work!

How can i make the awards show up in the table?

Thanks in advance,

Venom

[m002.p]

Ill have to look into it mate. Im sure it could be possible a variant will probably need adding to display it, but like I say ill get back to you on that one

[VenomMaster]

Wow, great... I look forward to this!

-Venom

[Finger78]

I hope I havent missed the magical answer here in the replies to this hack but here goes.

I am using this hack and it works great except for one of the option changes you placed in the option.txt, Number 3 to only show people that have a certain profile field filled out.

When I change the code as instructed (changed the field# to field9) and edited both pieces of code within the .php file.

Once loaded up tthe server it shows an error on line 153 with an unexpected }

I removed the offending } and it worked again, but it only lists 2 members of the Super Mod usergroup, neither of which have that profile field filled out.

I went back and redid the instructed changes again and same thing both with the error at first then the actual shown list.

This mod will be perfect if I can indeed get it to only show the users that have the field9 profile field filled out.

I am using the most current version of vB (3.6.7) if that makes any difference.

Any help would be appreciated.

[Sarcoth]

@ Finger - I received your PM.

First off, put back the } you removed.

Then find:
eval('$rosterbits .= "' . fetch_template('showroster_userbits') . '";');

Right below that is: //}, remove the // and everything should work. If that doesn't do it, please attach your showroster.php and I'll take a look.

@ Venom - What are the rewards? Not sure I understand what you are talking about regarding those. This may be a toughie since I haven't used german since High School.

[Finger78]

As requested the "showroster.php" is the php file with ONLY the changes made as instructed in the provided "optional.txt" file that came with the files downloaded form here.

The "showroster1.php" (renamed for easy of identification here) is the php file with the corrected "}" removed from line 153. (Parse error: syntax error, unexpected '}' in /showroster.php on line 153)

As you can see at http://www.err32.com/forums/showroster.php that this fixed the parse error but it doesnt work properly. When looking at the page the profile field that should be required to have something entered into is it the "Character name" field (field9)

[Sarcoth]

@ Finger - Replace the following with your line 132 to fix the problem.

if ($user['field9'] != '') {

You must have deleted the { somewhere along the line.