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.

[JohnnyNorCal]

Ok...I'm going to set up a secondary usergroup and see if I can just manually add users to that group with permissions to access the specific profile fields the roster uses. The reason I was hesitant to do this is because the rank system is somewhat intricate and I didn't want to interfere with it.

I guess my question now is, where can I control this new usergroup to be able to view the extra profile fields and set the old usergroup to not view or edit the extra profile fields? I don't remember seeing a way to do this in the usergroup manager. Theres so many options, sometimes I get lost in with all the switches here and there.

[Dragonsys]

Originally Posted by JohnnyNorCal

Ok...I'm going to set up a secondary usergroup and see if I can just manually add users to that group with permissions to access the specific profile fields the roster uses. The reason I was hesitant to do this is because the rank system is somewhat intricate and I didn't want to interfere with it.

I guess my question now is, where can I control this new usergroup to be able to view the extra profile fields and set the old usergroup to not view or edit the extra profile fields? I don't remember seeing a way to do this in the usergroup manager. Theres so many options, sometimes I get lost in with all the switches here and there.

add this new usergroup to the users as a secondary group, and it should not affect your rank system at all.

[Dragonsys]

Originally Posted by Sarcoth

I guess the look all depends on the style of the forum and how that style translates to this mod. I am looking into a css for this though and maybe that will help, but the problem is that every forum has a different style so it will always look different. You can always make your own adjustments in the templates though. That requires a little html knowledge.

I could have sworn I had this problem with the vb3.7 version of this mod, and it was just one little tweak I had to make to get it to view properly, but I can't find where I posted about it.

well they do say the memory is the first thing to go...


EDIT: ok, so I was looking at the templates, and it's something with this mod. Looking at the garage templates (http://forums.texas-fbody.org/garage.php) it uses the same classes your templates do, but it displays properly, when the roster does not. At least this is what it looks like to me.

[Sarcoth]

Originally Posted by Dragonsys

EDIT: ok, so I was looking at the templates, and it's something with this mod. Looking at the garage templates (http://forums.texas-fbody.org/garage.php) it uses the same classes your templates do, but it displays properly, when the roster does not. At least this is what it looks like to me.

I am going to be incorporating a bunch of template changes in the next version thanks to IR15H. Maybe that will fix your problem. If not, I will look into it more then. I've got some other things going on but my goal is to have the update released by the end of the month.

[Dragonsys]

Originally Posted by Sarcoth

I am going to be incorporating a bunch of template changes in the next version thanks to IR15H. Maybe that will fix your problem. If not, I will look into it more then. I've got some other things going on but my goal is to have the update released by the end of the month.

Cool, I will wait for your update. In the meantime, I'm gonna keep looking at my site and just see if I can narrow it down some. I made several changes to the SHOWROSTER template, but they don't seem to have any real affect on the page display.

Thanks

[a7lameza.com]

thank you

[strudinox]

Not working since I upgraded to 4.0.4

Any development on a solution? The issue is when I click on the custom profile options, it takes me to an empty page within the profile.

[Dragonsys]

would it be possible to only display users on the roster based upon their primary UserGroup, not all of their Usergroups?

For example, I have two groups, Members & Officers. All of the Officers (primary group) belong to Members (secondary group), but not vice versa. I want to Display a Roster of the members, but not have the Officers listed. As it is right now, the Officers get listed, since they belong to the members Group, even though it is not their primary group.


EDIT:
Ok, I found it, I just needed to remove:

 OR FIND_IN_SET(usergroup.usergroupid, user.membergroupids)

But I think it might work best if this was a selectable option. Or maybe a var, like m=x
Where x is 1, 2 or 3 (1 for primary, 2 for secondary, or 3 for either/both)

I have also made this script work for multiple group displays (almost multiple rosters). I will PM my changes to the Author and see if he is interested. It still uses all the same settings in admincp, only the group displayed changes.
You can see an example here:
Default View - http://forums.texas-fbody.org/showroster.php
Single Usergroup - http://forums.texas-fbody.org/showroster.php?id=6
Multiple Usergroups - http://forums.texas-fbody.org/showroster.php?id=6,9

[Barteh]

I've been trying to modify the clan roster to include images in the user fields, but so far without much luck. Would it be possible to simply let the script interpret all html (or BB codes) within these fields, thus displaying images? I've set the corresponding profile options to only be radio button selectable, so no risk of someone inadvertently breaking the layout.

[Dragonsys]

Originally Posted by Dragonsys

 OR FIND_IN_SET(usergroup.usergroupid, user.membergroupids)

But I think it might work best if this was a selectable option. Or maybe a var, like m=x
Where x is 1, 2 or 3 (1 for primary, 2 for secondary, or 3 for either/both)

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