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]

^^^^ that would be AWESOME to have. Would be very very useful and I would think flexible so if your clan only plays one game, they could put different values in for games like "skills, positions, roles, etc".

[Sarcoth]

Originally Posted by 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

That's a bit complicated to put into the actual code b/c it forces me to add more options (there are already so many). Especially for something not everyone would use. I'm sure a good number of people would use it, but it really does not look like a majority. Also, you need to consider this would most likely have to be its own column. What to do if people want to use this for multiple columns?

So, the better way to go for this would be to give you a walk through on how to do it. This would allow you to update any of the columns you want and as many as you want. Give me the weekend and I'll try to tell you how to do it by Monday. Give me a reminder on Tuesday if I have not posted it. Also, please click install. I only put special code together for those that have Install clicked.

[Barteh]

Appreciate it! And don't worry, I keep my list of plugins up to date. Just hadn't clicked 'installed' because it currently isn't

[Sarcoth]

It really isn't that. For us developers, the only thing we can brag about is how many people are using our mod. It is not like people are paying me to produce updates, ROFLMAO! So, we got to take the little pleasures we can get.

"Neener, my mod has more installs than your mod. "

[rowedf]

Woo hoo Thanks Sarcoth, can you please post those instructions on here so I can add the same feature? Thanks again.

[Barteh]

Don't worry, I had already clicked 'install' at the last post! Duly appreciated

[grey_goose]

How can I make it handle multiple characters?

For example, UserOne has 3 characters, listed as field26, field31, and field36

[Sarcoth]

@ Grey_Goose - Think of this like the member list that can appear on every forum. There are columns, but each user only has 1 row. You cannot give a user more than that.

So, to answer your question, there is not a way to currently make it handle multiple characters. Not without a lot of additional programming. Sorting would also no longer work since that has to be done per a single column. This is not something I would be willing to work without compensation for my time. Sorry.

Barteh/rowedf - I started looking into the changes for that one, not too hard, but I will want to release the next version before I give the needed changes. Just in case what I give you no longer is the same after the next version. I would not be willing to redo it. Anyhow, I'll tell you how after the release. Scheduled for 1st week of January, unless I get a burst of free time before then or my trip gets canceled. The latter is looking likely right now.

[Barteh]

Thanks! And if you need a guinea pig, let me know

[Mobo]

I have a couple of questions about this mod if you have the time.

1. Is it possible to have members added to a roster based on a custom user profile field instead of by usergroup?

2. Is it possible to have members added to a roster based on usergroup and custom user profile field?

I have a site that is dedicated to a table top wargame (Wings of War) and one of my biggest challenges is organizing and networking the players in the real world.

I have Wing Commanders that oversee an entire country, they in-turn appoint Squadron Commanders over States/Provenances, and then those guys appoint Flight Leaders which actually head up the local gaming group/club (the members).

The Wing and Squadron Commanders also act as moderators on the site. This limits me from breaking each location down to a usergroup (would have to have an ungodly number of usergroups to cover all the locations and leaders).

Thank you for your time,

Keith