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.

[masonox]

Hello! Great product, I do have a problem however. I did not read all these replies, but my problem is if I make a new user field like

Class = Bounty Hunter

when I select that in the profile, and go to the roster page it just shows numbers, like 1, 2, 3 or whatever my classes would be, but not the text that I had entered in the profile field creation. Any ideas?

Thanks in advance.

[Sarcoth]

It sounds like you are using radio selections rather than a dropdown selection. It can still work with radio, but you'd have to do some extra coding. I suggest you do dropdown selection instead.

[masonox]

Originally Posted by Sarcoth

It sounds like you are using radio selections rather than a dropdown selection. It can still work with radio, but you'd have to do some extra coding. I suggest you do dropdown selection instead.

I tried a multiple line text, I didn't see a traditional "form like" drop down. But checkbox and multiple line is same results, 1,2,3,4 etc,

[masonox]

nm it works now, it was as you said, they just labeled it odd. Thanks for help

[Sarcoth]

No problem!

[Sarcoth]

Originally Posted by IR15H

Every time I look at PHP I can never quite figure it out and end up with a headache but from what I can gather, you've basically said;

1. What usergroups do you want to show on the roster?
2. What attribute of usergroups should be the primary one, user id or user title?
3. How should I sort that attribute, ascending or decending? (If none defined, then sort ascending)

As I don't really understand PHP, this may be overly simplistic, but what happens if you simply remove steps 2 and 3? Is the default behaviour to simply fetch display in the order they are entered, or is there some inherit sort behaviour that needs to be overwritten?

You are 100% correct and it gave me a headache just trying to get it to work. Definitely not simplistic. Most likely it could be coded better, but it was the best I could do with what I had. One day, I will rewrite it all and make it a lot better, but not for awhile. For now, we are stuck with my hogwash mod of code. Initially, back in the previous versions, it did a sort by userid or username. So many people asked to have the usergroups sorted in whatever way they wanted though. I did my best.

---------------------

Originally Posted by IR15H

In regards to multiple rosters, I was thinking along the lines of two entries for showroster_display_groups in the settings then some crazy if conditions like if showroster_display_groups_2 is not blank then display roster2, which would use the same fields/columns as roster1, but appear on a different tab. Of course the downside to that approach would be that you'd be limited to using the same user profile fields for both rosters. However, as I said, I don't really understand PHP so don't know how feasible such an idea would be.

Actually, I set something up for my guild officers where they could see some additional columns. It works along a similiar way to what you just described. I think it is doable, but I need to come up with a way to make it all configurable by the admins. I was thinking of making two ShowRoster Setting pages, but as soon as I give the option for two rosters, someone will want three. I have another idea that will deal with that problem and should make it much easier for me. I want to get the next version published that fixes a few problems and adds some more options...and then I will begin work on the multiple rosters.

[Dragonsys]

CSS does not seem to be applying to the roster. I mean, it just looks ugly. I'm sure I am just missing something here, as in your demo it looks as I would expect.

You can see what I mean here - http://forums.texas-fbody.org/showroster.php

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

[JohnnyNorCal]

Great System, thanks so much.

I have a question. I have a gaming group and the only people I want on the roster are people that are active according to who the mods and admins think should be on there. Basically we only have one usergroup for registered users. Is there an easy way to have the admins control who goes on the roster? If I did it by usergroup I am either allowing everyone or disallowing everyone...if that makes sense.

[Sarcoth]

Originally Posted by JohnnyNorCal

Great System, thanks so much.

I have a question. I have a gaming group and the only people I want on the roster are people that are active according to who the mods and admins think should be on there. Basically we only have one usergroup for registered users. Is there an easy way to have the admins control who goes on the roster? If I did it by usergroup I am either allowing everyone or disallowing everyone...if that makes sense.

I have something similiar in place on my roster. I set up a "user profile field" called status with the choices of "Active/Inactive". I made the default "inactive". I then told all the active users to set it to active. You then can put some code in the php file that only displays users if this is set to active. I will look up the code for you if that is the way you really want to go...

Personally, I think you should go another route. The reason is, for some of these people, you are going to have to set their status anyhow because users tend to be ignorant when it comes to updating their information. Just the way it is. Because of that, you'll need to go into their profiles. The better way to go is to make a usergroup, and add all the users you want to be on the roster to this group. You don't have to give the group any permissions or anything, just use your registered group for that. Keep that as the primary usergroup for everyone while you check the box of the people you want on the roster. Maybe even call the group the Roster group or something.

That's what I would do. I'll check back in a couple days and give you the code though if you want to go the more difficult route.