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.

[jlevi]

Originally Posted by Sarcoth

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

OK, thanks, it's working now. Another question - is it possible to have images in a custom column, e.g. rank images?

[Foxtrotelite]

Could you show me the code for aligning columns? I just upgraded to the newest showroster version and the code looks a little different. Here is what I used to have:

<vb:if condition="$show[field1st]"><td nowrap="nowrap" align="center" width="13%">{vb:var userinfo.{vb:var columns[column1]}}</td></vb:if>

Here is what i have now:

<vb:if condition="$show[field1st] AND exec_switch_bg()"><td>{vb:var userinfo.{vb:var columns[column1]}}</td></vb:if>

[owning_y0u]

how can i make that the roster is only showing the member 1 time?

little example

user X is in Group B and in Group C

but i dont want to see user X in group C on the roster cause it counts this users as a new user.

[Sarcoth]

Originally Posted by jlevi

OK, thanks, it's working now. Another question - is it possible to have images in a custom column, e.g. rank images?

Do a search on rank in this mod.

Originally Posted by Foxtrotelite

Could you show me the code for aligning columns? I just upgraded to the newest showroster version and the code looks a little different. Here is what I used to have:

<vb:if condition="$show[field1st]"><td nowrap="nowrap" align="center" width="13%">{vb:var userinfo.{vb:var columns[column1]}}</td></vb:if>

Here is what i have now:

<vb:if condition="$show[field1st] AND exec_switch_bg()"><td>{vb:var userinfo.{vb:var columns[column1]}}</td></vb:if>

I think you would only have to change the <td> to <td nowrap="nowrap" align="center" width="13%">. Most of this is controlled from the css template now though. Let me know if that does not work and I'll look into it further.

Originally Posted by owning_y0u

how can i make that the roster is only showing the member 1 time?

little example

user X is in Group B and in Group C

but i dont want to see user X in group C on the roster cause it counts this users as a new user.

The only way is by controlling whether you can see members in their usergroup or secondary groups. I will tell you how to do this, but if you want to allow some members to be shown in their usergroup and some in their member groups, then your request is not possible with the current code. Does that make sense?

If user1 has a primary group A, and secondary group B, I can tell you how set up the features so you only see them in group A or group B. But, once you choose to go with the primary or secondary groups, then it is like that for ALL users.

So, let's say you choose the secondary group option. Now user1 shows on the roster in group B. You have user2 in the primary group B, and in the secondary group A. He will only show in group A b/c it is his secondary group.

Let me know your plan and I'll tell you how to do it.

[unknown22]

How can I add post count on the roster? Turn it into a user field or something?

[Sarcoth]

Originally Posted by unknown22

How can I add post count on the roster? Turn it into a user field or something?

This is the code for post count: {vb:var userinfo.field27}

Just put that in place of one of the other fields. Don't add an extra column since that will cause some other code to break. You need to replace one of the fields already in there.

[Dragonsys]

The only problem I have is with the newer versions of this is the CSS layout. On a light colored background the Black lines around the cells just looks wrong.

Compare these for what I mean:
Nice, fitting CSS - http://forums.texas-fbody.org/showroster.php
Default CSS - http://www.texasfba.com/test/showroster.php

Also, for a future request
Can you make the NavBar Tab Label customizable?

[unknown22]

Originally Posted by Sarcoth

This is the code for post count: {vb:var userinfo.field27}

Just put that in place of one of the other fields. Don't add an extra column since that will cause some other code to break. You need to replace one of the fields already in there.

Won't work

Entered it under User Name (column 1)
{vb:var userinfo.field27}

and just field27 didn't work

tried on an empty column number 4 which is not in use nothing

[PreciseDemise]

NICE! Dude, this is sweet. I'm impressed, this is a must for all Clans, lots of options, lots of customisation, AbFab =)

[Sarcoth]

Originally Posted by Dragonsys

The only problem I have is with the newer versions of this is the CSS layout. On a light colored background the Black lines around the cells just looks wrong.

Compare these for what I mean:
Nice, fitting CSS - http://forums.texas-fbody.org/showroster.php
Default CSS - http://www.texasfba.com/test/showroster.php

Also, for a future request
Can you make the NavBar Tab Label customizable?

I'll see what I can do about the CSS. Can you list the changes you made in your "Nice, fitting CSS". I'll test it out and see if I like it for the default. Otherwise, I can list your CSS changes in the FAQ.

In regards to the NavBar Tab label...you know, I had meant to do that in the last version so I'll eventually get around to doing that in the next version. I'll go add that to the Things to do so I don't forget. I probably won't do another version till December and most likely I'll forget requests.

Originally Posted by unknown22

Won't work

Entered it under User Name (column 1)
{vb:var userinfo.field27}

and just field27 didn't work

tried on an empty column number 4 which is not in use nothing

I'll look into this later this week.