Profile Enhancements - Customizable Roster

Customizable Roster

Introduction:

This Mod is ideal for a Guild/Clan roster, but it is also a great replacement for the memberlist. Customize it any way you like: add or remove columns with just a few easy edits. The installer includes permission control that allows you to set which groups appear on the roster and which ones can view it. The most popular option is the ability to control advanced sorting; check it out!

Click Here For A Preview

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). When upgrading from version, make a copy of all your templates, then revert the templates back to their default, and then uninstall the older version. Also, make sure you delete the bitfield_showroster.xml file in the /includes/xml directory; this will cause database errors if not deleted.

Step 1: Download the showroster_vX.X.X.zip file and unzip it.

Step 2: Upload the files to their correct directories.

Upload the showroster.php to the /forum/ directory.
Delete the bitfield_showroster.xml in the /forum/includes/xml/ directory (if there).

Step 3: Admincp > Plugin & Products > Manage Products > Add/Import Product

Import the product-showroster_v4.x.x.xml file.

Step 4: 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 5: Admincp > Settings > Options > ShowRoster Settings

Update the settings for your roster: usergroups allowed to view the roster, usergroups that are displayed on the roster, the title and field# for each of your columns on the roster, and any of the many other settings.

Step 6: Admincp > Styles & Templates > Expand > ShowRoster Templates > SHOWROSTER, showroster_header, and showroster_userbits

You only need to adjust these if you have custom adjustments to make. Otherwise, there is no longer a need to change these.

NOTE: See installation and upgrading instructions in the included corresponding txt files.

Version Updates: See 2nd post.
FAQ: See 3rd post.
Screenshots: See 4th post.

PLEASE CLICK INSTALLED.
Support will be given to those that do.

[Sarcoth]

Originally Posted by Foxtrotelite

<td class="$bgclass" nowrap="nowrap" align="center"><if condition="($user[field27] == '')">$user[field30]<else /><a href="http://steamcommunity.com/id/$user[field27]">$user[field30]</a></if></td>

field27 being the Steam ID number
field30 being Steam Profile ID

The above code is what you posted previously (on page 2 or 3 of the topic). I just changed the field numbers to reflect my forum. Can you update this to work for the newest VB version please?

Thanks in advance!

<vb:if condition="$show[field8th] AND exec_switch_bg()"><td><vb:if condition="$userinfo[field27] == ''">{vb:var userinfo.field30}<vb:else /><a href="http://steamcommunity.com/id/{vb:var userinfo.field27}">{vb:var userinfo.field30}</a></vb:if></td></vb:if>

That should do it. The change is done in the showroster_userbits template. You'll need to pick one of the columns already there. I chose the field8th for testing. Make sure you also rename the column in the Showroster Settings page.

[Sarcoth]

Originally Posted by betts02

What i need is to add the xbox gamer card to the roster via our members filling in a profile field

I have this in my signature area with this code :

<vb:if condition="$post['field5']"><tr><td class="vbmenu_option">
<iframe src="http://gamercard.xbox.com/{vb:raw post.field5}.card" scrolling="no" frameBorder="0" height="140" ></iframe></td></tr></vb:if>

I want to know how to get this shown in the roster
What file and where ?

Also if possible, I have our members enter a URL of their choice via a profile field

This shows up in the roster, But i want it to be clickable

How and where would i do this also

If possible a full explanation of where and what to edit

many thanks in advance

This is very similar to the one I just did for Foxtrot. The template to edit is showroster_userbits. I need some more info though. What field#'s are you using and please give me some sample data so I can do the testing. Or, if you like, I can do it on your site. PM me if you want me to do it manually. Otherwise, post the data I requested here.

[Foxtrotelite]

Thanks for the help Sarcoth! The code worked. I got the links part working, but I am having one minor issue. I must be overlooking something. When I use the code, it offesets my columns.
My steam id is in column 4 via the showroster settings. Here is a piece of what i have in the userbits template.

columns[column3]}}</td></vb:if>
        <vb:if condition="$show[field4th] AND exec_switch_bg()"><td><vb:if condition="$userinfo[field30] == ''">{vb:var userinfo.field27}<vb:else /><a href="http://steamcommunity.com/profiles/{vb:var userinfo.field30}">{vb:var userinfo.field27}</a></vb:if></td></vb:if>
        <vb:if condition="$show[field4th]"><td nowrap="nowrap" align="center" width="13%">{vb:var userinfo.{vb:var 
columns[column4]}}</td></vb:if>

I think the to conditions need to be combined in some way. If I change the 2nd condition's field to an unused one, say field8th, then my roster page doesnt add an extra field 4 column so it doesn't offset the roster alignment. Doing that makes my column settings for field 4 not work obviously.. so i end up with a big column and non centered text.

[Sarcoth]

Originally Posted by Foxtrotelite

Thanks for the help Sarcoth! The code worked. I got the links part working, but I am having one minor issue. I must be overlooking something. When I use the code, it offesets my columns.
My steam id is in column 4 via the showroster settings. Here is a piece of what i have in the userbits template.

columns[column3]}}</td></vb:if>
        <vb:if condition="$show[field4th] AND exec_switch_bg()"><td><vb:if condition="$userinfo[field30] == ''">{vb:var userinfo.field27}<vb:else /><a href="http://steamcommunity.com/profiles/{vb:var userinfo.field30}">{vb:var userinfo.field27}</a></vb:if></td></vb:if>
        <vb:if condition="$show[field4th]"><td nowrap="nowrap" align="center" width="13%">{vb:var userinfo.{vb:var 
columns[column4]}}</td></vb:if>

You want to remove the 2nd $show[field4th] line completely. You can only have one. If you are using it for something else, then you need to remove one of the other columns instead. The code I gave is a replacement for one column.

[Foxtrotelite]

When I tried removing it I got this error:

adding child to non-existent node!

This code seemed to make everything work fine:

columns[column3]}}</td></vb:if>
        <vb:if condition="$show[field4th] AND exec_switch_bg()"><td nowrap="nowrap" align="center" width="13%"><vb:if condition="$userinfo[field30] == ''">{vb:var userinfo.field27}<vb:else /><a href="http://steamcommunity.com/profiles/{vb:var userinfo.field30}">{vb:var userinfo.field27}</a></vb:if></td></vb:if>
        <vb:if condition="$show[field9th]">{vb:var userinfo.{vb:var 
columns[column4]}}</td></vb:if>

I moved around the align code and stuff.. but i still had to leave the 2nd if condition there.

Thanks again for all the help and the quick replies!

edit: actually i still had to use an unused field in the 2nd if statement to prevent any extra junk from appearing the roster. Can that code be cleaned up? I guess I am doing something wrong

[betts02]

How is the group settings done ?

What is it for and how do you use it ?

Cheers

[Sarcoth]

Originally Posted by Foxtrotelite

When I tried removing it I got this error:

This code seemed to make everything work fine:

columns[column3]}}</td></vb:if>
        <vb:if condition="$show[field4th] AND exec_switch_bg()"><td nowrap="nowrap" align="center" width="13%"><vb:if condition="$userinfo[field30] == ''">{vb:var userinfo.field27}<vb:else /><a href="http://steamcommunity.com/profiles/{vb:var userinfo.field30}">{vb:var userinfo.field27}</a></vb:if></td></vb:if>
        <vb:if condition="$show[field9th]">{vb:var userinfo.{vb:var 
columns[column4]}}</td></vb:if>

I moved around the align code and stuff.. but i still had to leave the 2nd if condition there.

Thanks again for all the help and the quick replies!

edit: actually i still had to use an unused field in the 2nd if statement to prevent any extra junk from appearing the roster. Can that code be cleaned up? I guess I am doing something wrong

Not sure what the problem was, but glad you got it working. Enjoy.

[Sarcoth]

Originally Posted by betts02

How is the group settings done ?

What is it for and how do you use it ?

Cheers

Group settings are for keeping track of certain fields. Go to the Preview link at the top of this mod. The bottom of my roster gives an example of how I use the group settings. Not sure it would be a use for you betts; from what I saw of your site. It only works with fields that allow the users to choose one selection from a dropdown basically.

[jlevi]

I cannot seem to get this working - i just get a blank page with the roster title and no members show up? I've tried changing the settings and nothing seems to work.

Many thanks in advance

[Sarcoth]

Originally Posted by jlevi

I cannot seem to get this working - i just get a blank page with the roster title and no members show up? I've tried changing the settings and nothing seems to work.

Many thanks in advance

I think I'm just going to release another version next week with the filter off by default. Please read the FAQ.