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 Halfhearted

Awsome Hack.

1 Question tho, in LOTRO, you have 5 characters (10 with 2 accounts) with 3 professions with 5 levels per profession. Anyway to make this work? I know currently you would have crap loads of fields and wont sort by profession because of different profession fields.

What I am looking for is that Admin's add the character names and the members change their professions and profession levels to suit.

Thanks in advanced for any replies.

Thank you.

Let me see if I understand. You can have up to 5 characters per account. Each character gets 3 professions (classes). Max level for each profession is 5. Is that what you mean?

The way this hack is set up, each forum account gets one line on the roster each. You can have as many fields across as you like. So, if you really didn't care how far across you would have to scroll, you could put in as many as you like.

Now, if you'd want to have each account linked to multiple characters (more than one line), then there would need to be some additional coding. Honestly, I think a lot of coding.

[Sarcoth]

You would be amazed with all the stuff you can do with this hack. I added roughly 200 lines of code to my showroster.php file, 13 lines per class in Vanguard. The new code calculates how many members in my guild have which class and their level range. The next step is calculating a need level for that class by taking the sum of each member at all level ranges. For example, if I only have 2 members in my guild for a class, that class is a great need; if I have 5 members between the levels of 30 to 50 for a class, that class is a low need. I created a template to display the number calculations and then another to rate each class.

This does 2 things.

First, I am able to quickly see the numbers I have for each class at all the different level ranges. That helps me keep track of my members and how the guild is doing. I keep this page restricted to officers only since members usually aren't concerned about that stuff.

Second, I created a CMPS module for my guild's home page. It lists what classes we are recruiting over others. It will also recalculate on it's own depending on whether we get someone new added to the guild or is we lose someone OR as members go up in level.

Feel free to take a look at the Recruitment Needs module on my guild's home page.

I'm only posting this for informational purposes. I won't be adding something like this to the hack because of all the extra lines of code and b/c I've only done it for my Vanguard guild. It can easily be done for practicially any roster though if you have a need. It would probably be more useful for larger guilds though since those are the ones that would be restricting some classes from joining the guild.

Enjoy!

[UNP-Maximus]

Works well for my site although I have one small problem,

I have a Custom User Field that is a Single-Selection-Menu when I display this instead of displaying "Field Marshall" it displays "1" and for "General" "2"

Is there anyway to display the text rather than the field sequence please.

Thanks in advance.

[Sarcoth]

Originally Posted by UNP-Maximus

Works well for my site although I have one small problem,

I have a Custom User Field that is a Single-Selection-Menu when I display this instead of displaying "Field Marshall" it displays "1" and for "General" "2"

Is there anyway to display the text rather than the field sequence please.

Thanks in advance.

I have about 3 custom user fields using Single-Selection Menu and they all display the text. I've never seen them display the field sequence before. I'd be interested in a link to your site as well as a copy of the showroster.php file and a posting of your showroster_userbits template.

[UNP-Maximus]

Sarcoth,

Bizarrely I deleted the field and re-added and now working fine. Now to read the notes on how to sort by that field.

Thanks for the reply.

[UNP-Maximus]

OK OK, I am stuck......

I am new at this previosuly a Nuke-Evolution user (PHP-Nuke variant).

Instead of sorting by user I would like to sort by field13.

I got working the optional sort but I would like this permanently sorted.

Thanks again its a great enhancement.

[Sarcoth]

Originally Posted by UNP-Maximus

OK OK, I am stuck......

I am new at this previosuly a Nuke-Evolution user (PHP-Nuke variant).

Instead of sorting by user I would like to sort by field13.

I got working the optional sort but I would like this permanently sorted.

Thanks again its a great enhancement.

Sounds to me that you just want to make field13 your default field for sorting.

This is very similiar to #2 in the optional.txt file. Just take a look at that and instead of changing 'title' to 'usergroupid', change it to 'field13'. That will do the trick. I'm glad you got the other thing working. Let me know if you still have problems.

[UNP-Maximus]

Thanks again have working nicely - all sorting.

I would however like to add Instant Messenger Icons is this possible, I tried by copying the code from the Memberlist display template but everything was blank.

Would appreciate if you could give me some guidance when you have chance on this.

Cheers,

Max

[Sarcoth]

Originally Posted by UNP-Maximus

Thanks again have working nicely - all sorting.

I would however like to add Instant Messenger Icons is this possible, I tried by copying the code from the Memberlist display template but everything was blank.

Would appreciate if you could give me some guidance when you have chance on this.

Cheers,

Max

Great news! IM icons huh? I could easily get you icons that do nothing, but it will take some research getting them to work like the Memberlist. I'm working on some other projects right now and not sure when I will be able to get to that. If I come across something though, I'll post it here and send you a PM.

[vash911]

Hello, Im using this on my website currently and it is excellent. I use this mod for my gaming league and i love it. I have a request if anyone can point me in the right direction. Currently my roster looks like this

I was wondering if there was a way I could make it so that I can have 5 or so Person across instead of vertical. A crude example is the following

What I want to do: Name | Name | Name | Name | Name |

Mod Currently does:
Name
Name
Name
Name
Name

I was also wondering if it was possible to split the rosters into 2 groups with out modifying there usergroups. IE if I can split the group up by 1 of 3 based on an option perhaps like Class.

Any info would be great.