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]

@ Cozmic - Got it working. No changes to the showroster.php file. I'll repost the beta version for further testing. Just do an install, no need to reinstall Cozmic. BTW, the tab button order setting (What order would you like your Roster tab to appear on the Navbar?) doesn't work yet. I may have to remove that from the release.

If you have 4.0.2 installed, you will have to uninstall and do a fresh install of this version. MAKE SURE YOU DELETE THE BITFIELD_SHOWROSTER.XML FILE in the includes/xml folder before doing this install.

[CoZmicShReddeR]

Awesome the tab is finally showing globally!

Also too is under "Permission Settings" ; "Usergroups displayed on the roster" I set it too show 26,25,21 but the view order is showing 26, 21, 25 can you make it so it forces the display order?

And another thing maybe way down the road would be to have the gamecard mod/ icons work with this like maybe even the actual banners since with a guild or clan it would come as a helpful addition since we both use xfire at least... Might be just allow the user field to be edited by whatever script those use from the post bit and have an example here how to add the script might be really simple just need to be able to edit the view field area...

But first things first...

[Sarcoth]

Originally Posted by CoZmicShReddeR

Awesome the tab is finally showing globally!

Also too is under "Permission Settings" ; "Usergroups displayed on the roster" I set it too show 26,25,21 but the view order is showing 26, 21, 25 can you make it so it forces the display order?

And another thing maybe way down the road would be to have the gamecard mod/ icons work with this like maybe even the actual banners since with a guild or clan it would come as a helpful addition since we both use xfire at least... Might be just allow the user field to be edited by whatever script those use from the post bit and have an example here how to add the script might be really simple just need to be able to edit the view field area...

But first things first...

I had to be sneaky to get that to work, but I'm glad it is working. In regards to those usergroupids displayed on the roster...I think the mod would have to be fully rebuilt to get it to do that. I've already looked at it once, and I just didn't see a way. There is an alternative though and I'm looking into it. You'll need to do what I do though. Change your usergroup titles to something so they are alphabetically. Take a look at my roster to see what I mean. I'll then see if I can use the Description or User Title for that Usergroup for display rather than the title.

It's easy to make adjustments to each private own roster, but I don't know about putting in those types of selections. That's something I'll probably add to the HOW TO document. Who knows though, we'll see.

I also still need to fix a small sorting malfunction, but I'll get to it tomorrow. Not to mention that I would like to get the avatar thing working, but without knowing what settings are preventing it...I'm having a hard time figuring out what to do there. Someone said they have avatar's off in the profile's, but what setting controls that?

I doubt I'll be available the rest of the day, so I'll check back this evening.

[Shadawg]

I liked this mod, but it would be nice to have the usergroups displayed in whatever order wanted by using the i.d's, i.e. 6,2,8,12,7,5 etc....

[Sarcoth]

@ Cozmic - I was at a LabView programming seminar yesterday and a possible solution for arranging the usergroups came to me. Surprisingly, I actually got it working 5 minutes ago. I won't need to rewrite the code like I thought I might have to do. So, in the next version you will now be able to arrange the usergroups from the display field in the ShowRoster settings.

I still have to fix the sorting problem I found and the avatar's before I release it though.

[Sarcoth]

Frontrunner confirms that the avatars are working in this version as well, so that just leaves my sorting issue and this should be ready for release.

[CoZmicShReddeR]

Well I am excited you were able to fix the group sorting issue! Am eager to see what lies down the road with your abilities! Hopefully this hasn't been interfering with your studies too much!

[Front Range 4x4]

I just need to say thanks again Sarcoth. While my use is far from the clan/guild it's pretty easy for anyone to modify this for just about any member list format they would care to have. I run a 4x4 club and have this set to provide a snapshot view of all members profile information including added fields, avatar, join/activity dates, etc.

Very nice for anyone wanting the perfect memberlist alternative.

*installed*
*nominated*
*very happy*

[Sarcoth]

Welcome. I was trying to get the release done before I went out for lunch, but sadly I encountered yet another problem with the sorting. The sorting is very tricky and probably the most difficult part of the coding. If and Switch statements make it do one thing or another and I'm even having a hard time keeping track of them now. Fun stuff though.

Anyhow, yesterday I had come to a decision that I just couldn't get the usergroup thing to work without breaking the sorting. I had given up. While I was typing the message here though, another idea came to me; and it worked. I figured, since sorting by usergroupid is only important when...SORTING by usergroupid, I could add an IF...Statement for that. Bingo, that did the trick. So, this way, when sorting via another field, it will use the old code for that which works for the other fields.

Well, that sounded all good, but while retesting things this morning after a fresh install, I noticed that something wasn't right with the sorting again. I'll have to recheck the code again to double check, but now groups appear to always want to start off with ASC, so maybe I copied something out of old code over my new stuff and screw the sorting up for some dumbass reason. I need some food now though, so off to lunch.

[CoZmicShReddeR]

Well take your time don't rush it rather see a Master Piece of your work then a horrible numbered job!