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.

[CoZmicShReddeR]

Thanks for the update!

[koolasia]

Is it possible to use this mod as an house system like we have in harry potter were points are alloted on diffrent aspects

[Sarcoth]

Originally Posted by koolasia

Is it possible to use this mod as an house system like we have in harry potter were points are alloted on diffrent aspects

Sorry, but I really don't know what you mean. You can always try it out.

[Dragonsys]

Originally Posted by koolasia

Is it possible to use this mod as an house system like we have in harry potter were points are alloted on diffrent aspects

this mod only displays a list of users who are members of a certain usergroup. So you could use it to display your Houses with their members.

As for the points, you would need a different mod. vBExperience 4 might be worth checking into.

[Sarcoth]

No problems reported so far so I will assume all is well. I did realize I missed testing the sorting functions, so definitely let me know if you run into any problems there. I'll start working on adding a few more things I wanted in there and maybe have something ready before my fall semester begins.

[Trek]

I'm confused on how to use the multiple-rosters thing.

What I'd like to do is have it display different profile fields if the roster is set to something else.

Like if it's displaying game 1, then fields 1,2,3 and if game 2, then fields 4,5,6.

Not sure if you can do that with the mod, but.. thought I'd ask.

If you can't, what exactly is the multiple roster thing for as well?

[Sarcoth]

Originally Posted by Trek

I'm confused on how to use the multiple-rosters thing.

What I'd like to do is have it display different profile fields if the roster is set to something else.

Like if it's displaying game 1, then fields 1,2,3 and if game 2, then fields 4,5,6.

Not sure if you can do that with the mod, but.. thought I'd ask.

If you can't, what exactly is the multiple roster thing for as well?

By default, you can't display different fields from one roster to another. I'd have to add a LOT more settings in the showroster settings to accomplish this. There are already 4 settings for each column, so I'd have to add another 8x4 for each time lines of settings just to accomplish one extra roster.

The multi-roster is meant to allow the viewers to see different rosters but using the same fields for each. For instance, my guild can be found in different games (Vanguard, AoC, etc.). If I want, I can display each guild on its own roster, but I would have to use the same profile fields to accomplish this. That could be a little annoying because I would have to set all the race/class names in the same profile field and then my members would have to go through a larger list, but oh well. They usually only need to set it once anyhow. You can also just use the multi-roster to show different grouping of usergroups. Say you want to just see Recruits, type in their usergroup id and there you go.

Now, I did say by default. That does not mean you can't get around this with a little extra coding. Something in the code like, if (usergroup = #), then column = field#. I'll test it out and let you know.

[Sarcoth]

Here you go Trek, try this out.

Find:

PHP Code:

            $userinfo['datejoined'] = vbdate($vbulletin->options['dateformat'], $userinfo['joindate'], true);
            $userinfo['lastactive'] = vbdate($vbulletin->options['dateformat'], $userinfo['lastactivity'], true); 


Add Below:

PHP Code:

if ($userinfo['usergroupid'] == 19) { $columns['title1'] = "TEST"; $columns['column1'] = "field12"; } 


Follow this rule. For "$userinfo['usergroupid'] == 19", use the usergroupid for the first group appearing on your alternative roster. This will cause the Title and field id for all following usergroups to use the same as the first. You will need to add additional code for each column you wish to change. Feel free to use this at your own discretion, it may break some things, I don't know. I can see a way to trim down the number of columns as well, if you want that, but I'll leave that one up to you.

Enjoy!

[Trek]

Thanks for the info Sarcoth, I'll fool around with it and see what I can break. =)

[Sarcoth]

Originally Posted by Trek

Thanks for the info Sarcoth, I'll fool around with it and see what I can break. =)

I did leave enough info for you right? I just realized that what I see as something easy may not be for someone that did not make a lot of this code. Basically, you keep adding more title# and column# within that new if statement for each column you want to change. I'll expand on it if you need me to though.