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]

Thank you. (/bow) I feel this is all child's play though compared to what some of the coders here at vbulletin can do. I'm very proud that so many are using my mod though. Even more so with all those posting how they like it.

Yea, I forgot to add the "who's online" status to my instructions. If there is a way to add it to the .php file instead, I'll gladly go that route. Please tell.

[m002.p]

Ive just had a go myself trying it and i can confirm success. However I have found it easier adding plugins, which can be added to that product you have. I will give it a go so *deep breaths*

1) You need to add a plugin first.

Go to admin CP > Plugins & Products > Add Plugin

2) Info as follows:

Product > showroster hack
Hook Location > online_location_process
Title > Showroster WOL Process
Execution Order > 5
Plugin PHP Code >

if ($filename == 'showroster.php')
{
	$userinfo['activity'] = 'showroster';
}

Plugin is active > Yes

3) Add another Plugin:

Product > Showroster hack
Hook Location > online_location_unknown
Title > Showroster WOL Display
Execution Order > 5
Plugin PHP code >

if ($userinfo['activity'] == 'showroster')
{
            $handled            = true;
            $userinfo['action'] = 'Viewing Clan / Guild Roster';

Save both templates & then your done.

Alternatively, I made you a new product with it included. Simply overwrite product & your done.
BEWARE: If you are upgrading then backup those templates! I would advise you to do it the manual way!

__________________________________________________ ___________________________

I have tested it and spent a good few hours developing it so this better pay off! LOL

NOTE: If you install the product, then it uses "Viewing Guild Roster" as the status. You can change it (if you are like me and have a clan) by going:

Admin CP > Plugins & Products > Plugin Manager > Showroster Hack > Showroster WOL Display

then you can change the code by choosing edit


All the best mate, I hope it helps you like you have helped me

Matt

[Sarcoth]

Thanks Matt. Sometimes I wonder where my head is at. I actually knew how to do that. I learned it while helping someone else with another mod. Do I remember it for my own mod? Course not. I'll make sure to have it updated here. Thanks again.

[anywares]

*clicks install* Thanks alot

[Brian31fl]

great work man gets better and better might wanna update your options file with this spent an hour sorting roster by groupid here how tofix that in the new showroster.php

Find:

$t = strtoupper($user[$groupsort]);

after add:

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

when done the changes should look like this:

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

hope this helps

~Brian

[Brian31fl]

yo sarcoth for your class stat mod can u look at my page
http://sacred-dragoons.com/forums/showroster.php?

and look at the changes and help me make it look more uniform?

modifyed text file attached

[ShawnV]

Awesome mod, clicks install, nominated for MOTM!

Cheers,

_V

[ShawnV]

Originally Posted by Brian31fl

yo sarcoth for your class stat mod can u look at my page
http://sacred-dragoons.com/forums/showroster.php?

and look at the changes and help me make it look more uniform?

modifyed text file attached

Very nice,

Wouldn't it be better to just standardize the classes for the stats and put multiple choice buttons in the UserCP, ergo: Defensive Fighter, Offensive Fighter, Divine Healers, Arcane Casters, and then make the code add those, so you don't have to change everything every time your guild changes games?

Cheers,

_V

[Sarcoth]

Originally Posted by Brian31fl

great work man gets better and better might wanna update your options file with this spent an hour sorting roster by groupid here how tofix that in the new showroster.php

Find:

$t = strtoupper($user[$groupsort]);

after add:

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

when done the changes should look like this:

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

hope this helps

~Brian

Brian, that change there would pretty much kill sorting I think. That is fine if you don't want sorting, but I wouldn't make that change in the master. You'd be better off just replacing the default $t with yours since the first one gets ignored.

I would actually recommend going back to the default though and instead making another change.

Find:

if ($groupsort == '') { $groupsort = 'title'; $grouptitle = 'title'; }

Replace with:

if ($groupsort == '') { $groupsort = 'usergroupid'; $grouptitle = 'usergroupid'; }

Does the same thing though so really not important. I'll have to update my optional instructions though, so thank you.

[Sarcoth]

Brian & Shawn - I look at your class statistics files tomorrow.