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]

I have tried removing forum, but the directory "images" is within it, so its needed in order to display.

May I ask, why are you not so keen on images in this hack?

I mean your hack is brilliant but I wanted to add the IM icons and an xfire icon too which of course requires an image as well as makes it look better than just pure text.

However I would understand the authors wish if so...

EDIT: After including the full link to the image and not including "$post[field10].gif" the image displayed. Any ideas if that code mentioned above is incorrect or is unsupported?

[hellbringer80]

I changed it to orderid, and all it does is put every user in one group and messed it all up =/

[m002.p]

When researching further into this, I believe that a particular variable needs to be customised in the showroster.php file.

Only thing is, looking at the code im not sure where it is located.

Could this be something to do with the other issues above also?

[Sarcoth]

moo2.p - By keen, I didn't mean I wasn't interested in putting images in it. I was hoping to eventually do that as well. I just meant I haven't tried it yet so I didn't know an answer. I'll see what I can find out about the $post variable. I haven't used it before so not sure what it is. Can you tell me another page where it is used?

hellbringer80 - What table is the orderid located in?

[m002.p]

Sorry, I didnt understand properly before. Ok well.. This variable will post a particular field or image so to speak like $post[field10] etc.

The variable is also used in templates such as "postbit_legacy"

Do a search to see the uses, but here are some examples:

$post[musername]
$post[usertitle]
$post[avatarurl]
$post['joindate']
$post[signature]

Hope this helps...

Out of interest, do you have xfire? I would be happy to help you on this one if needed

Regards

Matt

[hellbringer80]

orderid is int he groups table

[Sarcoth]

moo2 - NP. Sadly, no chat programs here at work and I really don't use any of them cept for MSN a couple times a week. I rarely have time for them since I'm usually playing Vanguard when I'm at home. I need to work today, so not sure I'll get to work on this much more till tomorrow. I'll be sure to check into it though.

hellb - I'm guessing you mean the usergroup table right? Not sure why it isn't working. Can you export your usergroup table (.sql) when you get a chance and send it to me. You can rename it to .txt. I think that will help me figure this out. I'll look into it more today if I get the time else tomorrow.

[m002.p]

Ok no problem Sacroth. Keep me informed on how it goes as I think adding images to it would be a good step for a clan roster.

Thanks for your time

[Sarcoth]

Originally Posted by m002.p

Hi,

Im having a problem inserting an image into the "showroster_usergroupbit" template.

This is what I enter:

<td align="center" class="$bgclass" nowrap="nowrap">$user[field10] 
<img src="forum/images/flags/$post[field10].gif"></td>

The image doesnt seem to display even when the code works elsewhere.

Can you spot the problem?

Thanks in advance!

Just out of curiousity, what is field10 set to and what's in it?

[m002.p]

field10 is set to the country of a user. Like UK, Germany, France etc

This is linked to a image (.gif) on the server which means using $post[field10].gif will result in it displaying the members country flag on the roster