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]

Originally Posted by m002.p

Hmm ive just installed and get this:

http://www.sog-team.co.uk/forum/showroster.php

It appears the "<" correspond to the usergroup member count :s

Any ideas?

BTW also the member count is not in the header correctly; am I correct in thinking that this "right%" is only to adjust the alignment of the total count text? Im guessing some code is set incorrectly here :s

EDIT: I think the "showroster_sort_title" isnt correct. The phrase doesnt appear on the roster as it is not in the phrase manager.

Thanks

Matt

Matt, how did you upgrade? Did you start from scratch? It looks like you have an extra < somewhere.

The "right: #%" is only for adjusting alignment away from the right margin.

Yea, I did it again. I was supposed to take the "_sort" part out of the optional.txt. I'm going to update it now with the correct update. I'll also relook over the code to see if a < was added somewhere on accident.

[m002.p]

I was running the first version you released. I backed up the templates then imported your product allowing overwrite.

I then noticed the old templates were left "showroster_usergroups" & "showroster_usergroupbits" then reverted those to delete.

The showroster template got overwritten as you would expect.

Thanks Sarcoth

Matt

[Sarcoth]

Regarding the "<". Look at the top line of your showroster_userbit template.

I bet it looks like: <<tr>

[m002.p]

you were close lol it was the "<td" underneath

Thanks Sarcoth

BTW.... regarding the Member count text, is that my genuine fault or some coding? :s

[Sarcoth]

NP.

Originally Posted by m002.p

BTW.... regarding the Member count text, is that my genuine fault or some coding? :s

I don't understand, it looks correct to me. You are free to change the words or edit it another way if you like. I was just providing a default.

[m002.p]

ah i see now.....

You must be using Net explorer.

Try using Firefox

The error is clearly seen

But yes for some reason IE seems to correct it

[Sarcoth]

Ahhh, my bad. Sorry, I can only use IE here at work, so because of that, I do the same at home. Feel free to change the coding around to work with all browsers.

BTW, the sorting looks great on your roster. I can probably come up with a way for the group title to work for the username group as well. I'll post something shortly.

[m002.p]

Thats the thing... im not sure what is wrong with the code. Here is what I see:

Could you perhaps identify what might need changing?

http://www.sog-team.co.uk/gallery/file.php?n=28&w=o

^ Thanks, yes i will have a play myself if you dont object, but i will look forward to hearing from you regarding that

[Sarcoth]

It looks like Firefox forces "DIV" to go to the next line like it would normally do in IE. The only reason IE doesn't put it on the next line is because of the "position: absolute". Maybe change the <div and </div> to <span and </span>.

For your username thing, do this:

First, change the [musername] to just musername without the brackets in the SHOWROSTER template.

Then in your showroster_header template:

Find:

<tr>
	<td class="tcat" colspan="10">$user[$groupsort] &nbsp; ($usercount)</td>
</tr>

Change to:

<tr>
	<if condition="($groupsort == 'musername')"><td class="tcat" colspan="10">Usernames &nbsp; ($usercount)</td>
	<else /><td class="tcat" colspan="10">$user[$groupsort] &nbsp; ($usercount)</td></if>
</tr>

That should work like a charm.

[m002.p]

You are one hell of a coder

Fantastic work I cannot fault it one bit

BTW... are you going to add that "whos online" status to your instructions?

Instead of doing it the way I did, you can add the code to the showroster.php file also

Ask me if you need any code for it.

Matt

This needs nominating as mod of the month