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]

Thanks, but this is no where near a master piece. That would be the EasyForms code. I can't believe all the stuff banana was able to do in that thing. I'm lower than a beginner compared to him.

Well, I'm either crazy or somehow the code is randomly causing the sorting issue. I don't see how it could occur randomly, so I must be losing it. I looked over the code, couldn't find the problem, went back and tested it again and nothing was wrong. I walked away, came back, tested again, and thought I saw the problem again. I threw my hands up, retested, and nothing. I have now tested it over and over and I don't think the problem is there. I'm going to release the new version now.

If you are a new user of this mod installing it for the first time, it is very basic. Upload the showroster.php file and install the product_showroster.xml file.

If you are upgrading from a previous version, I recommend you play it safe and just delete all the old files and do a fresh install. If you don't delete the bitfield_showroster.xml file, you will have problems.

If you are upgrading from the beta 4.0.3 version, you should be safe just copying over the new showroster.php file and installing (overwriting) the beta. Although, you will need to revert your template changes if you want all the new code to take affect. I had to really do a number on the code this time. I really don't see how I will ever remember what it all does.

Please let me know if you find any problems. I'll consider suggestions but my week off from school is almost over and I need to get back to homework and studying.

[XLCR GODFATHER]

If the sort option could sort by and group together members by social group this mod would be perfect for me

[CoZmicShReddeR]

Originally Posted by XLCR GODFATHER

If the sort option could sort by and group together members by social group this mod would be perfect for me

If you mean like Facebook, Myspace this mod was originally intended for Guilds and Clans if I am not mistaken. You can make it show for specific user fields... Just have it use the registered user and for Filtering User the user field for Facebook or Myspace but you can only pic one with 4.03 might be a good suggestions to allow to have it filter to more then one and have it show in certain order.. Then for it to show for all users set it to Usergroups displayed which by default is Group #2...

Anyways for suggestions for this mod:
I was going to suggest it would be neat to set it by leaders of certain groups with a title if possible then have a list under those groups/subgroups then have it tear down into other subgroups which would be ideal for huge Guilds as well for runs if you set it to an event system!

Maybe even have it re-size the user images and avatars to show it in a tear system and then you could have user info in a small quick mini profile box show somewhere...

There is a Tournaments & Ladders mod here for just such a system but the roster could be ideal if it could produce a separate list for events maybe hooked into the calender...

But I see it like this for a Group that has separate group leaders and you want to have those leaders run separate groups of people underneath them for that day, week, month or year...

Leader Boards might be a better name then Roster Mod with all of this!

1st Division | 2nd Division | 3rd Division
Division Leader | Devision Leader | Devision Leader
1 Senior Officer | 1 Senior Officer | 1 Senior Officer
10 Members | 3 Members | 3 Members
3 Recruits | 2 Recruits | 1 Recruit

Now the members could be set to show just the list in a row of boxes if the system was too full rather then just showing all members at first glance. Then when you view the group it expands shows the actual user accounts with pictures and other info...

[Sarcoth]

@ Cozmic - Sadly, I don't see this mod being able to do that. A new one would have to be built. The code in this one only allows for users to be divided into groups. Rather than try and rework this code to make it do subgroups and sub-subgroups, it would be better if someone just started something from scratch.

For me, I mainly built this for use with my guild and then posted it to share with others. The suggestions were boundless and I was sucked into wanting to upgrade further. I don't mind adding to what is already here, but I doubt I'll have the time to rebuild it from the ground up. If there are options within the scope of this mod, I'll do my best to add them if they are within my power.

@ XLCR - I think he means the social groups within vBulletin. I know there is a table for that, but I'd need to see more interest in it (from people that click install) if I were to consider looking into it.

[CoZmicShReddeR]

Whatever you have built so far has been fine!

I am willing to support you along the way if you so chose to continue your work...:up:

[Sarcoth]

Thanks, I appreciate that. BTW, the roster looks operational Cozmic. May I suggest you not include the Wii column till someone is using it. You can probably also set up links for each of those profiles so if someone clicks on an ID it takes you to a page.

Time to study, online exam due by Sunday.

[CoZmicShReddeR]

Originally Posted by Sarcoth

Thanks, I appreciate that. BTW, the roster looks operational Cozmic. May I suggest you not include the Wii column till someone is using it. You can probably also set up links for each of those profiles so if someone clicks on an ID it takes you to a page.

Time to study, online exam due by Sunday.

Sure thing! Thanks!

[kevius]

i'm sorry but, where is the sort menu ?????

[dennisuello]

How do I rename the tab? I don't want it to say Roster.

[XLCR GODFATHER]

Originally Posted by CoZmicShReddeR

If you mean like Facebook, Myspace this mod was originally intended for Guilds and Clans if I am not mistaken. You can make it show for specific user fields... Just have it use the registered user and for Filtering User the user field for Facebook or Myspace but you can only pic one with 4.03 might be a good suggestions to allow to have it filter to more then one and have it show in certain order.. Then for it to show for all users set it to Usergroups displayed which by default is Group #2...

Anyways for suggestions for this mod:
I was going to suggest it would be neat to set it by leaders of certain groups with a title if possible then have a list under those groups/subgroups then have it tear down into other subgroups which would be ideal for huge Guilds as well for runs if you set it to an event system!

Maybe even have it re-size the user images and avatars to show it in a tear system and then you could have user info in a small quick mini profile box show somewhere...

There is a Tournaments & Ladders mod here for just such a system but the roster could be ideal if it could produce a separate list for events maybe hooked into the calender...

But I see it like this for a Group that has separate group leaders and you want to have those leaders run separate groups of people underneath them for that day, week, month or year...

Leader Boards might be a better name then Roster Mod with all of this!

1st Division | 2nd Division | 3rd Division
Division Leader | Devision Leader | Devision Leader
1 Senior Officer | 1 Senior Officer | 1 Senior Officer
10 Members | 3 Members | 3 Members
3 Recruits | 2 Recruits | 1 Recruit

Now the members could be set to show just the list in a row of boxes if the system was too full rather then just showing all members at first glance. Then when you view the group it expands shows the actual user accounts with pictures and other info...

The only reason I asked is I have altered my languages for social groups to list as squads, group owners=squad leaders etc. as this is how I keep my large clan more organized.

Having the roster display and sort by the social group would just create an easier way for members to view them. The only thing I see was the ability to sort by a userprofile field but with the way my set up is this would create more work changing the value of the field everytime a member joins or transfers to a squad manually. My user groups are set up for the squad leaders to accept or remove members from their squads at will, with minimal effort. My member ranking system is directaly tied to the user groups and the squad leaders have the ability to alter the user groups under them for changing ranks.

Please forgive me I am new to all this and a little unfamiliar with some of the more complex coding found on vb.org. But I have been learning fairly quickly.