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.

[Foxtrotelite]

this might be a novice question, but is there a way i can add links in the profile fields that show on the roster? For instance my clan uses the steam client for games. I have a Steam Id field on my roster with the IDs, but I would like to have those ID's clickable(to take the user to the Steam Profile page).

Thanks

[betts02]

+ 1 on the above post

[Sarcoth]

Originally Posted by owning_y0u

any change that you are planning to use the all the Vb stylevars? as i dont like the black border for the table's and cells

Nothing planned. I'll make a change like that if 10+ request it. If you tell me what you want though, I can tell you what to change for your own personal roster.

Originally Posted by CMSTemplateZ

Do you think this would be a nice addition for a Battlefield forum ?

Any forum where you'd like to have a roster.

Originally Posted by AfterWorldForum

Are there any plans to set this up on a per-usergroup level so multiple clans could be supported on the same forum?

Sorry if this has been asked before, I just saw the mod, and missed that functionality when I went over the first few posts.

It's already there. Check out the Advanced Usergroup Settings FAQ, the 3rd post in this mod. If confused, check other posts here too. Someone has asked a few questions on that. That part takes some time to understand.

Originally Posted by Foxtrotelite

this might be a novice question, but is there a way i can add links in the profile fields that show on the roster? For instance my clan uses the steam client for games. I have a Steam Id field on my roster with the IDs, but I would like to have those ID's clickable(to take the user to the Steam Profile page).

Thanks

That is definitely doable and already explained a couple times. I have classes today and thursday, so I'll come back to answer questions on Friday.

[AfterWorldForum]

Originally Posted by Sarcoth

It's already there. Check out the Advanced Usergroup Settings FAQ, the 3rd post in this mod. If confused, check other posts here too. Someone has asked a few questions on that. That part takes some time to understand.

I'll check it out tomorrow and play around with it a little bit. Thanks for the reply

[Foxtrotelite]

Originally Posted by Sarcoth

That is definitely doable and already explained a couple times. I have classes today and thursday, so I'll come back to answer questions on Friday.

Awesome, thanks for the reply

[betts02]

With the new code, How would i go about adding :

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

to the roster via a fillied in profile field

and how would i make make a user profile field clickable ?

So in the roster it would show a users xbox live gamer card and a url that is clickable

cheers

[Sarcoth]

Originally Posted by betts02

With the new code, How would i go about adding :

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

to the roster via a fillied in profile field

and how would i make make a user profile field clickable ?

So in the roster it would show a users xbox live gamer card and a url that is clickable

cheers

For starters, don't use post at all in this mod. That is only needed in postbits and I doubt it will work here. Off the top of my head, I think you will need something like:

<vb:if condition="$show[field1st] AND exec_switch_bg()"><td><iframe src="http://gamercard.xbox.com/{vb:var userinfo.{vb:var columns[column1]}}.card" scrolling="no" frameBorder

You did not include the whole line though, so I can't give you more than that. The above is only for the first column. Obviously, you'll need to adjust "field1st" and "column1" to the correct column #.

If that does not work, give me more to go on and I'll take a closer look at it tomorrow.

[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!

[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

[Eazy1]

nevermind... bonehead question, figured it out.

great mod! installed and nominated!