Register Members List Search Today's Posts Mark Forums Read

Reply
 
Mod Options
Customizable Roster Details »
Customizable Roster
Mod Version: 4.1.0, by Sarcoth (Coder/Designer) Sarcoth is offline
Developer Last Online: Mar 2017 I like it Show Printable Version Email this Page

This modification is currently quarantined.
vB Version: 4.1.0 Rating: (31 votes - 4.68 average) Installs: 318
Released: 08 Feb 2010 Last Update: 05 Jan 2011 Downloads: 1844
Not Supported Uses Plugins Auto-Template Additional Files Translations  

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!



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.

Download Now

Only licensed members can download files, Click Here for more information.

Show Your Support

  • If you like this modification support the author by donating.
  • This modification may not be copied, reproduced or published elsewhere without author's permission.
Similar Mod
Mod Developer Type Replies Last Post
Profile Enhancements Customizable Roster Sarcoth vBulletin 3.7 Add-ons 114 27 Jul 2013 15:42
Profile Enhancements Customizable Roster (Member List) Sarcoth vBulletin 3.6 Template Modifications 260 12 Apr 2012 14:21
Forum Home Enhancements Customizable Welcome Box EnIgMa1234 vBulletin 3.6 Add-ons 11 04 Apr 2007 20:46

Comments
  #2  
Old 08 Feb 2010, 18:42
Sarcoth Sarcoth is offline
 
Join Date: Mar 2006
Real name: Nick
Version Updates:

Version 4.0.0 - February 8, 2010
  • Release of this hack for vBulletin version 4.0.x.
  • This version works on both 4.0.0 and 4.0.1; message below for more information.

Version 4.0.1 - March 11, 2010
  • Converted all code to the new vBulletin 4.x format.
  • Improved sorting: Now each column will be sorting ASC and if you click on it again, it will go DESC.
  • Less php and template edits. You can now set everything from the options area.
  • The avatar, profilepic, birthday fields have not been added yet. I'll add them back if people show more interest in this mod.

Version 4.0.2 - March 17, 2010
  • The ShowRoster Title can now be set from the ShowRoster Settings.
  • Online Status indicator works again.
  • Online Status indicator can now be turned off/on in the ShowRoster Settings.
  • showroster_userbits template has been updated; online status and musername has been made into a table for a nicer layout.
  • showroster_header template has been updated; user_name field is now centered.
  • Default sorting has been added to the ShowRoster Settings.
  • Made a fix to the plugin Viewing ShowRoster Location Display.
  • Removed the phasegroup from the product file since the title is now set in the ShowRoster Settings. Also had to update the showroster.php file; $phrasegroups = array() part.
  • Added the Last Visit/Activity column with an option to turn it off.
  • Found and fixed a problem with one of the IF statements in the SHOWROSTER and showroster_header templates.
  • Added the Profile Picture column with an option to turn it on; default is off.
  • Added the Avatar column with an option to turn it on; default is off.
  • Updated the Viewing plugin to display whatever the user enters for the title.
  • TD class has been removed from the showroster_userbits template so the user data looks better for all website styles.

Version 4.0.3 - March 25, 2010
  • What usergroups are displayed on the roster can now be managed from the ShowRoster Settings. This is a huge thing because now you won't need to Edit Usergroups individually and there is no longer a use for the bitfield_showroster.xml file.
  • includes folder, xml folder, and bitfield_showroster.xml file removed from installation package; no longer needed.
  • showroster_permissions and showroster_add phrases removed from the install file; no longer needed.
  • installcode and uninstallcode for table removed from the install file; no longer needed.
  • Updated the Navbar plugin to check the permissions of the access_groups and to register/render the code for the navbar template.
  • Updated the navbar template to only display the Roster tab to those in the access_groups list.
  • New setting has been added to the ShowRoster Settings that allows the admin to select where the Roster tab should appear on the Navbar: Left, Middle, or Right.
  • Updated the Navbar plugin to check for the Roster tab location.
  • Added an option to each column for the default sorting; either ASC or DESC. Changes were made to SHOWROSTER template, showroster.php, and to the install file.
  • Added an option which allows an admin to set whether a column is sorted as groups or in a single table. Changes were made to SHOWROSTER and showroster templates, showroster.php, and to the install file.
  • Added an option which allows an admin to filter out users from the roster if they leave a certain field blank. Changes were made to the showroster.php and to the install file.
  • Added an option which allows an admin to filter out users from the roster when sorting certain fields. The users will not appear on the roster if the sorted field is blank. Changes where made to the showroster.php and to the install file.
  • Many adjustments have been made to the showroster.php and showroster_header template so the new sorting option will work correctly.
  • 4 stylevar vB4 variables have been fixed in the SHOWROSTER and showroster_header templates.
  • The roster title has been changed around a bit and the member count has been moved to work with all browsers.
  • The sorting links have been moved the mini navbar. They have been placed in a sorting options dropdown.
  • The navbar plugin has been adjusted and all coding has been copied to the showroster.php file. This allowed me to use the code from the php file in the mini navbar while allowing the Roster tab to still appear in the menu (whether on the Roster page or not).
  • Usergroups are now sorted in the order the id's are entered for the "Usergroups displayed on the roster" setting.

Version 4.0.4 - July 24, 2010
  • All templates have been updated to work better with the vBulletin 4.x.
  • CSS template has been added to help with the template updates.
  • The Roster tab on the navbar can now be turned off.
  • You can now choose whether to view just primary or secondary usergroups. Or just leave this alone to keep using the default of both. Check the Showroster Settings document and the FAQ post (2 posts down) for more information.
  • There is now an ability to use multiple roster on a single site. Although, each roster will use the same columns. Check the Showroster Settings document and the FAQ post (2 posts down) for more information.
  • Along with the ability to select usergroup ID's to be displayed on the roster, you can also select which usergroups to be blocked from using this new setting. This is for security purposes.


Version 4.0.5 - August 12, 2010
  • Templates: statbits has been added for the new statistics table. SHOWROSTER has had some code added to work with the new statbits template. Small changes have been made to other templates.
  • CSS template has had some new code added to address the new statistics table.
  • A new option settings "ShowRoster Group Settings" has been added for use with the new statistics table.
  • A lot of new code has been added to the showroster.php file to work with the new statistics table.
  • The image path that is used when a user does not have an avatar has been fixed.


Version 4.1.0 - January 4, 2011
  • id's and mid's are included in the sort functions.
  • Allow the Roster tab to be removed.
  • Allow the Roster tab to be renamed.
  • Fully redid the navtab code, many times.
  • Removed the stats template when sorting.
  • Navtab positioning is fully controlled via the plugin; change the execution order to move its order.
  • Border should now adjust correctly for all styles.

Future Releases:

Completed:
Possible Future Add-ons:
  • Maybe find a way to show how the roster tab can have a dropdown menu for multiple rosters.

Last edited by Sarcoth; 05 Jan 2011 at 00:20.
Reply With Quote
  #3  
Old 08 Feb 2010, 18:44
Sarcoth Sarcoth is offline
 
Join Date: Mar 2006
Real name: Nick
Main FAQ

Q: I set the "Usergroups displayed on the roster", yet none of those users are appearing! What is wrong?
A: Calm down. You probably have the following set: "Choose a field to be filtered (I.E. field7). Users that leave this field blank will not appear on the roster." Make that field blank until you are ready to use it.


Advanced Usergroup Settings FAQ

Q: What is the Primary/Secondary usergroup setting?
A: All users on your forum are placed in a Primary Usergroup. Some are also added to Additional Usergroups (membergroups). You would use this setting if you want to have your users only in Primary Usergroups or Additional Usergroups to appear on your roster. By default, both options are used. This means, if you have two usergroups shown on your roster, then a user could appear twice on the roster if they are in both usergroups. Most should not need this feature, but feel free to play with it if you like.

Q: What about using the m= function for my roster?
A: You will need to turn on the Primary/Secondary usergroup setting to use this function. This will allow you to have a default roster, and then use the ?m= function if you would like to view the roster in other ways. m=1 is used if you want to see users in both the primary/secondary groups, m=2 is used to view users only in the primary groups, and m=3 is used to view users only in the secondary groups.

Q: What is the ID usergroup setting?
A: This is the main setting that will allow you to have multiple rosters. It can be used in conjunction with the primary/secondary usergroup setting for more indepth rosters. Just add an ?id= followed by all the usergroups you want to view (comma separated), and it will display those usergroups for you. I.E. showroster?id=13,14,15,16.

Q: What about the ID usergroup block setting?
A: This setting is for security purposes and allows you to block certain usergroups from being displayed with the ?id= setting. After all, we don't want anyone to stumble across any of your private groups and have access to all the users in that group.

I'll add things here as questions come up.

Last edited by Sarcoth; 19 Aug 2010 at 14:24.
Reply With Quote
  #4  
Old 08 Feb 2010, 18:44
Sarcoth Sarcoth is offline
 
Join Date: Mar 2006
Real name: Nick
Screenshots
Attached Images
File Type: jpg screenshot_01.jpg (109.8 KB, 1068 views)
File Type: jpg screenshot_02.jpg (111.2 KB, 539 views)
File Type: jpg screenshot_03.jpg (118.3 KB, 635 views)
File Type: jpg screenshot_04.jpg (113.2 KB, 2315 views)
File Type: jpg screenshot_05.jpg (24.5 KB, 901 views)
File Type: jpg screenshot_06.jpg (132.2 KB, 1839 views)

Last edited by Sarcoth; 19 Aug 2010 at 15:03.
Reply With Quote
  #5  
Old 08 Feb 2010, 18:45
Sarcoth Sarcoth is offline
 
Join Date: Mar 2006
Real name: Nick
Reserved.

Last edited by Sarcoth; 19 Aug 2010 at 14:24.
Reply With Quote
  #6  
Old 08 Feb 2010, 20:30
abdobasha2004's Avatar
abdobasha2004 abdobasha2004 is offline
 
Join Date: Aug 2008
wow
nice work !
__________________
Egypt News website, latest Egyptian news updated instantly.
Reply With Quote
  #7  
Old 08 Feb 2010, 20:54
ProFifaLeagues's Avatar
ProFifaLeagues ProFifaLeagues is offline
 
Join Date: Aug 2009
Real name: Rob
Superb looking i will give this a try tonight many thanks!!
Reply With Quote
  #8  
Old 08 Feb 2010, 20:56
GrossKopf GrossKopf is offline
 
Join Date: Jan 2007
Yours looks so much nicer than mine: http://flotgaming.net/forums/showroster.php

Am I missing something?

It appears it shows the user groups based on their user group ID. Is there a way to change this? The reason I ask is because on my page, it shows the regular clan members before the admins. I'd like the admins listed first.
Reply With Quote
  #9  
Old 08 Feb 2010, 21:39
Crrrazzzy Crrrazzzy is offline
 
Join Date: Sep 2005
is there a way to select a specific usergroup out and only show that one

ie ..... showroster.php?group=301

whereas 301 is the usergroup id
Reply With Quote
  #10  
Old 08 Feb 2010, 21:46
Bouncer222 Bouncer222 is offline
 
Join Date: Oct 2009
Installed! Great! Easy to manage all my site members now!

Question... How do I order in which order the usergroups appear from top to bottom? www.brotherhoodofgamers.com/showroster.php
__________________

FRAG TOSS! Gaming Community Discussion Board!


Biggest Multi-Gaming Community in the World! www.brotherhoodofgamers.com
Reply With Quote
  #11  
Old 08 Feb 2010, 21:48
GrossKopf GrossKopf is offline
 
Join Date: Jan 2007
Originally Posted by Bouncer222 View Post
Installed! Great! Easy to manage all my site members now!

Question... How do I order in which order the usergroups appear from top to bottom? www.brotherhoodofgamers.com/showroster.php
It appears it shows the user groups based on their user group ID. I hope that a future release can allow us to organize this.
Reply With Quote
  #12  
Old 08 Feb 2010, 22:29
Sarcoth Sarcoth is offline
 
Join Date: Mar 2006
Real name: Nick
Originally Posted by GrossKopf View Post
It appears it shows the user groups based on their user group ID. I hope that a future release can allow us to organize this.
The optional_changes.txt has a way for you to adjust how things are ordered. Let me know if that helps. Otherwise, describe what you want in depth and I'll see what I can think up. Make sure you give me the id's and names of the groups you are planning to use.

BTW, if you want me to look at your roster you'll need to turn on the access for unregistered.
Reply With Quote
  #13  
Old 08 Feb 2010, 22:31
Sarcoth Sarcoth is offline
 
Join Date: Mar 2006
Real name: Nick
Originally Posted by Crrrazzzy View Post
is there a way to select a specific usergroup out and only show that one

ie ..... showroster.php?group=301

whereas 301 is the usergroup id
Interesting. I'm sure there is a way, I just need to think on it for a bit.
Reply With Quote
  #14  
Old 08 Feb 2010, 22:38
Sarcoth Sarcoth is offline
 
Join Date: Mar 2006
Real name: Nick
Originally Posted by Bouncer222 View Post
Installed! Great! Easy to manage all my site members now!

Question... How do I order in which order the usergroups appear from top to bottom? www.brotherhoodofgamers.com/showroster.php
I can't get to the code right now, but I'll look at it in a couple hours. I may have something in the optional_changes.txt though, so check it out. I noticed you have a field for your members steam ID's. If you can provide me with a full link to one of those, I can probably make those ID's into links for your roster. Not hard to do. Also, don't forget to update the field names of your sorting area.
Reply With Quote
  #15  
Old 09 Feb 2010, 00:45
Bouncer222 Bouncer222 is offline
 
Join Date: Oct 2009
Originally Posted by Sarcoth View Post
I can't get to the code right now, but I'll look at it in a couple hours. I may have something in the optional_changes.txt though, so check it out. I noticed you have a field for your members steam ID's. If you can provide me with a full link to one of those, I can probably make those ID's into links for your roster. Not hard to do. Also, don't forget to update the field names of your sorting area.
Wow making all those IDS into links... that is amazing. so once you click them, it takes you to their profile page... sweet. But I think you would need a converter and I have some place where I can get a converter for them into a link...

Anyway my Steam ID is: STEAM_0:1:17768031
It should link to my profile at: http://steamcommunity.com/id/bogbouncer
What also shows up on that roster is Steam Player ID but its named as Xfire at the moment of this post by accident...will fix that, that one is: bogbouncer (as you can see its on the link after /id/

And I looked at the extra txt file.. there was nothing about making the usergroups in a certain order I believe.

Thanks.
__________________

FRAG TOSS! Gaming Community Discussion Board!


Biggest Multi-Gaming Community in the World! www.brotherhoodofgamers.com
Reply With Quote
Reply


Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
 
Mod Options

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off


New To Site? Need Help?

All times are GMT. The time now is 01:10.

Layout Options | Width: Wide Color: