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. See the optional.txt file included in the installation for additional changes that you can make at your discretion. The most popular option is the ability to add sorting; check it out!


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

Step 1: Download the attached showrosterXXX.zip file.

Step 2: Upload the files to their correct directories.

Upload the showroster.php to the /forum/ directory.
Upload the bitfield_showroster.xml to the /forum/includes/xml/ directory.
Upload the spacer.gif to the /forum/images directory if you plan to use avatars.

Step 3: Admincp > Plugin & Products > Manage Products > Add/Import Product

Import the product-showroster.xml file.

Step 4: Admincp > Languages & Phrases > Phrase Manager > Phrase Type: ShowRoster > showroster_title --> Edit

Change this to whatever you want as the title of your roster.

Step 5: 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 6: Admincp > Styles & Templates > Expand > ShowRoster Templates > showroster_header

This template contains the headers for each of your columns. Add/Edit/Remove columns to your preference. Be sure to update both of the colspan variables to the number of columns you have.

Step 7: Admincp > Styles & Templates > Expand > ShowRoster Templates > showroster_userbits

This template gets the data from each of the fields you want to have viewed on your roster. Add/Edit/Remove columns and/or the nowrap="nowrap" to your preference. Be sure to update each of the field#'s to match the fields from Step 5.

Step 8: Admincp > Usergroups > Usergroup Manager > Edit Usergroup

• Set "Access - Should this usergroup have access to the Showroster page?" to Yes for whatever groups you want to have permissions to access the showroster page.
• Set "Viewable - Should this usergroup be viewable on the Showroster page?" to Yes for the groups you want to have appear on the showroster page.

(All instructions are included in the instructions.txt and optional.txt files)


Updates:

Version 1.2.0 - May 24, 2008

• Release of this hack for vBulletin version 3.7.x.
• This version works on all vBulletin versions from 3.6.0 and up.
• This version works with vBadvanced CMPS version 3.0.1.

Version 1.2.1 - June 11, 2008

• Updated code for XHTML validation.
• Added a Date Joined column with code to support.
• Added a Last Online column with code to support; also changes color.
• Added a Birthday column with code to support; will be blank for users wishing to hide their birthday.
• Added a ProfilePic column with code to support.

FUTURE VERSIONS

• This version will no longer be supported or upgraded.

Click Here For A Preview

PLEASE CLICK INSTALLED.

Support will no longer be given for anything below vB4.x.

Go to Customizable Roster 4.0 for the newer supported mod.

[Sarcoth]

<font color="Blue">I'd like some feedback from those of you interested in a multiple roster. I've thought up a few ways that I can go with this but I'd really only be willing to go one route.

How are you handling permissions on your forum? Is everyone in the same usergroup and you are using profile fields to distinguish the guild/game they are in? Or do you have a different usergroup for each guild/game?

I've thought about going with the usergroup route, but I fear it may limit adjustments and can really get complicated. The better way to go would be creating a new profilefield (I recommend multiselection checkbox) that gives either just you (private) or the members (open) the choice to pick what guilds/games they are a part of.

After that, I should be able to set up a way that you will get to each individual roster by adding a little extra string at the end of your showroster.php command; like showroster.php?goto=guild/game.

Either way, I can forsee quite a few coding changes from your side to get it to work. Easy enough if you can follow directions though. Mainly would just need to add coding to the showroster.php to identify each individual guild/game.

Something to think about. I will probably get started on the code tonight but my time right now is light so it may take awhile for me to get it working. I'll post an update when able.</font>

[Brian30fl]

well with my forum i have each guild with there own usergroup for exsample lets say take my guild named Protect your package or PyP for short i would go with 3 user groups PyP Leader Pyp Officer PyP member have ever this would be the same system for the other 9 guilds how ever instead of sperate guild roster pages perhaps haveing 1 roster where it would say alliance roster and having the ability to have a guiolds name then the user groups then guild 2 and so forth

[ProtoPC]

I would keep it simple as you suggested. I would like to add it to a new site I am putting together... here. Seems like it would be a good fit. Thanks again for your time and I will look forward to your update before I install.

[Brax]

Originally Posted by Sarcoth

[COLOR="Blue"]Is everyone in the same usergroup and you are using profile fields to distinguish the guild/game they are in?

I prefer this way.

[Brian30fl]

Originally Posted by ProtoPC

I would keep it simple as you suggested. I would like to add it to a new site I am putting together... here. Seems like it would be a good fit. Thanks again for your time and I will look forward to your update before I install.

what u useing for your nice navbar?

[ProtoPC]

Originally Posted by Brian30fl

what u useing for your nice navbar?

Joomla

[Brian30fl]

wow looked* like vbadvanced.......

[IR15H]

Originally Posted by Sarcoth

I'd like some feedback from those of you interested in a multiple roster. I've thought up a few ways that I can go with this but I'd really only be willing to go one route.

How are you handling permissions on your forum? Is everyone in the same usergroup and you are using profile fields to distinguish the guild/game they are in? Or do you have a different usergroup for each guild/game?

I've thought about going with the usergroup route, but I fear it may limit adjustments and can really get complicated. The better way to go would be creating a new profilefield (I recommend multiselection checkbox) that gives either just you (private) or the members (open) the choice to pick what guilds/games they are a part of.

After that, I should be able to set up a way that you will get to each individual roster by adding a little extra string at the end of your showroster.php command; like showroster.php?goto=guild/game.

Either way, I can forsee quite a few coding changes from your side to get it to work. Easy enough if you can follow directions though. Mainly would just need to add coding to the showroster.php to identify each individual guild/game.

Something to think about. I will probably get started on the code tonight but my time right now is light so it may take awhile for me to get it working. I'll post an update when able.

Whilst I have no particular need for an inbuilt multi-roster system, I have to say I don't think a profile field option would be the best route. As far as I'm aware, profile fields aren't linked to permissions, such as view certain forums, or have certain moderating powers - which is probably quite important to many multi clan/guild communities.

[CodyMuir]

hey, i have a question!

I downloaded this, and i love it.



clandwd.com/showroster.php have to be registered because its not set up yet.
Anyways, for my clan ranks, i have custom titles for everything that is admin written.
I want each category to be based off their custom title, But, i want to be able to chose the order so Recruits are at the bottom etc.

Is this possible??

Because i included the usertitle in the postbit and it shows up, but i had a general category of..
"High Council"
And it showed, Me, Leader, Commander And Generals on it, but in random order.
Is there a way where i can sort that so it maybe goes by avatar id? or.. i don't even know.
But i want it to be organized. I made a ton of usergroups ex:
Leader
Commander
General and put people in them 1 by 1, which was very time consuming, thank god for mysql could easily copy / make new usergroups

Anyways, any suggestions? please

[Sarcoth]

Originally Posted by IR15H

Whilst I have no particular need for an inbuilt multi-roster system, I have to say I don't think a profile field option would be the best route. As far as I'm aware, profile fields aren't linked to permissions, such as view certain forums, or have certain moderating powers - which is probably quite important to many multi clan/guild communities.

Actually, I could set up an if statement that only shows the data for the particular guild/game they have placed in their profile field. But, since you can already assign which usergroups can view the roster, is it really neccesary to block one usergroup from viewing the other roster? IMO, if you are giving a usergroup permission to view one roster, you may as well give them permission to view them all. Otherwise, they may as well create another site for their guild.