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 Dragonsys

I got this working.
1 = Secondary Group Membership only
2 = Primary or Secondary Group Membership
Default = Primary Group Membership only

You can see it in action here:
Default - http://forums.texas-fbody.org/showroster.php
1 - http://forums.texas-fbody.org/showroster.php?m=1
2 - http://forums.texas-fbody.org/showroster.php?m=2
With Group ID - http://forums.texas-fbody.org/showroster.php?m=1&id=12

Very cool stuff Dragon. I am actually working on some other code for the roster, but I would be interested in using this as well. Credit to you for your help on this, nice work.

[Sarcoth]

Just a quick update. I only did about a few hours a day work on updating this a week for the last month. I am redoubling my efforts to get an update out soon though, hopefully next week. I am nearing completion of the style revisions (big thanks to Irish for help on that), just a few more tweaks and I can finish up a couple other things I have been working on. I can't swear I used everything that Irish suggested, but I really like having a CSS file now. It will allow users to edit the CSS rather than making those changes to the mod templates.

I also will have Dragon's revised code in the next version as well.

For those that are having style problems with their roster, please wait till the next version.

[Sarcoth]

Just another heads up. After some banging our heads together, Dragon's additional code is working for me now. It will be in the next version. I do need to add a few more things and am planning to do that today. I should have all testing completed by tomorrow or this weekend. I will aim for a Monday release.

[Trek]

Nice to hear Sarcoth, I've been waiting for this update myself. =)

[Sarcoth]

Okay, I think it is done. I'm going to send it to a couple users for testing while I work on typing up some new help files. It should be released on Monday or Tuesday unless I can finish the docs this weekend.

Please don't ask to be one of the testers. I will get it out soon.

[Trek]

Originally Posted by Sarcoth

Okay, I think it is done. I'm going to send it to a couple users for testing while I work on typing up some new help files. It should be released on Monday or Tuesday unless I can finish the docs this weekend.

Please don't ask to be one of the testers. I will get it out soon.

Good to hear! May my roster no longer look like crap, thank you! =)

[TripleChin]

Originally Posted by TripleChin

I love this mod. I am have done a few custom tweeks to it and would like some help with one I can't seem to work out.

In lieu of displaying a particular profile field, I would like to display an image in it's place. The field is not required, so some users will have it and other's won't. I am attempting to only display if the user has selected 'Yes'.

In "showroster_userbits" template I have made the following modification without success. If you have a suggestion as to how I could get it working that would be great.

<vb:if condition="$show[field4th]"><td nowrap="nowrap" align="center"><vb:if condition="$userinfo.$column[columns4] == /yes/i"><img src='http://myimages.com/image.gif'></vb:if></td></vb:if>

Thank you.

Does anyone have any suggestions to the questions I posted?

[Sarcoth]

Originally Posted by TripleChin

Does anyone have any suggestions to the questions I posted?

Not sure about your second IF condition there, but why not use something like:
<vb:if condition="$userinfo.$column[columns4] != ''">{vb:var userinfo.{vb:var columns[column4]}}<vb:else /><img src='http://myimages.com/image.gif'></vb:if>

Not 100% sure about that since I am a little rusty with the fields. If that does not work, I can take a look at it next week once the new version is released.

Here is how the entire line will look in version 4.0.4:

<vb:if condition="$show[field4th] AND exec_switch_bg()"><td><vb:if condition="$userinfo.$column[columns4] != ''">{vb:var userinfo.{vb:var columns[column4]}}<vb:else /><img src='http://myimages.com/image.gif'></vb:if></td></vb:if>

[Sarcoth]

Mod has been updated. I know this has been long in the waiting. Please let me know any issues that you find and I will try to get them fixed promptly. To those I sent a pre-release version to, download this one and use it instead. I ended up adding a few more things to the final.

Thank you and enjoy!

[ProFifaLeagues]

Loving this mod thanks Sarcoth great work.