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.

[rowedf]

Another possible option to think about is a feature where each usergroup has the option of having their own roster. So you can display a roster that way and it would only show those in that usergroup on the roster page ?

[Sarcoth]

Originally Posted by rowedf

Another possible option to think about is a feature where each usergroup has the option of having their own roster. So you can display a roster that way and it would only show those in that usergroup on the roster page ?

It can already do that. You need to read the "Advanced Usergroup Settings FAQ" on the first page.

[Sarcoth]

Originally Posted by rowedf

Another possible option to think about is a feature where each usergroup has the option of having their own roster. So you can display a roster that way and it would only show those in that usergroup on the roster page ?

This is 4 usergroups together. Just use one ID if you only want the one.

http://sacredhaven.org/forumsh/showr...id=19,13,17,18

Here is another 4 usergroups, but there are only 2 with members in them at the moment. That will change in about a month.

http://sacredhaven.org/forumsh/showr...id=40,41,42,43

This is what I was talking about 4 posts ago. I now have my roster separated, but this breaks the sorting. When you sort, it uses all the usergroups you have in your default roster (without any id's). One of my goals is to fix that and I plan to start working on that today.

[MISTER2]

Being able to query off of more than one column would make the Group Settings / Group table options more useful.

[Sarcoth]

Not sure I know what you mean, but I'll take a stab. If you mean sorting multiple columns at the same time like first sort by one column and then another...then sadly that one is not possible with the way I did the code. At least, not from what I can see. I have looked into that a few times and the whole thing always brakes on me. From what I understand, I would have to rebuild it from scratch. Not something I really want to do.

If that is not what you mean though, please clarify. I'm bored at work right now and just focused on updating this. I want to do some more things, but I haven't upgraded my forums to 4.1 yet and I really want to do that before I get involved in updating the templates. Although, I already finished the id sorting issue I mentioned earlier.

[ShawnV]

Any news on the 4.1.x version?

[Sarcoth]

The current version should be working fine. I do plan to release a 4.1.0 version before I go back to school though. It will fix a few problems I have found plus add some extra tiny features. If you have something particular you would like to see or problems, let me know. Expect the release to be the first week of January.

[Barteh]

I'd love to see an easier way to change multiple choice user options to images. We're in a gaming clan that has fanned out significantly over the last few years, and it'd be great to allow individual users specify their preferred games (play it regularly - sometimes - don't have it), then get game columns with coloured pips as a result. Had a brief go at it when we upgraded to vB4 a couple of months ago, but I'm not sure if I understand vB4's code well enough.

[Sarcoth]

@ Barteh - Not sure I understand what you mean. Do you have an example?

[Barteh]

Bit like this:

          CoD4 CoD5 CoD7 BFBC2 etc etc
Member  1  ?    ?    ?     ?
Member  2  ?    ?    ?     ?
Member  3  ?    ?    ?     ?
...
Member 40  ?    ?    ?     ?

User input field per category (i.e. game) would be a pulldown menu or a set of radio buttons, either simply with the same colour codes or descriptive texts like this:

Are you active in this game?

Yes
Occasionally
Rarely
Don't own it

I'm not entirely sure how to properly do the conversion bit from text values to images. Maybe the last value should be simply 'no' so the options can simply be variables translating to image names (occasionally.jpg -> dark green pip for example). But at my first attempts I mostly just broke the script