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.

[GlitchersCorner]

Nice Mod!

By any chance can you make an add-on for this or an option for users to create their own rosters? That would be extremely cool. I'd pay for that option!

[iogames]

Originally Posted by GlitchersCorner

Nice Mod!

By any chance can you make an add-on for this or an option for users to create their own rosters? That would be extremely cool. I'd pay for that option!

I chip-in!

[michael5472]

I have installed but can i make it show BBCODE in the profile field ?

doesn't work for me
http://www.theoldbreed.com/showroster.php

[Sarcoth]

Originally Posted by stwilson

Allow for a header footer field that shows above or below the Roster/Memberlist?

I don't think that would be very difficult to add, but what do you want to put there? The roster should already be using the forums header/footer.

Originally Posted by stwilson

I have a question. I am trying to include a member's Join Date in a column but the number that shows up is a ten digit number. How do I convert it back to the standard VB date format?

I recall something similiar to that, I'll look into it this week.

Originally Posted by ssslippy

Added a usergroup with almost 400 members and the script fails to run, gives a white page. I get no emails reporting errors.

We had a problem with large usergroups back in vBulletin 3.6.x as well. I just tested it out on my roster with a usergroup that has 289 users in it; it worked successfully. I'd be curious to know if others are having any problems? How many fields are you using? Did you also try a smaller usergroup; if you have one? I'm sure you did, just asking though.

Originally Posted by GlitchersCorner

By any chance can you make an add-on for this or an option for users to create their own rosters? That would be extremely cool. I'd pay for that option!

Maybe in the future...but I fear that would be a lot of work. I'll research it though and maybe it can be done. No promises though.

Originally Posted by michael5472

I have installed but can i make it show BBCODE in the profile field ? doesn't work for me http://www.theoldbreed.com/showroster.php

You need to give unregistered users permissions to view it as well. I can't see it.

[michael5472]

Originally Posted by Sarcoth

You need to give unregistered users permissions to view it as well. I can't see it.

Done

[Sarcoth]

Originally Posted by stwilson

I have a question. I am trying to include a member's Join Date in a column but the number that shows up is a ten digit number. How do I convert it back to the standard VB date format?

Completed.

Open the showroster.php file.

Find:

  fetch_musername($user);

After it add:

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

Your code in the showroster_userbits template should look similiar to this:

	<td class="$bgclass" nowrap="nowrap">$user[datejoined]</td>

I'll be sure to add this in the next version for those that wish to use it.

[stwilson]

Worked like a charm. Thank you for the super mod!!!

[michael5472]

Originally Posted by Sarcoth

You need to give unregistered users permissions to view it as well. I can't see it.

Done any chance ?

[IR15H]

A few things...

Firstly, thanks for releasing this .

Some Questions

• How do I sort user groups in a custom order, say id 1, 4, 5, 3, 2 or name A, D, E, C, B? A similar thing is done for user groups in a legend by Cyberntec in his "Visitors in Last X Hours" mod, but not being a coder I can't work it out myself.
• How would I pull a user's age (not DOB), provided they haven't set it to private (Hide Age + DOB, Display Only Day and Month of Birth)? I spent quite a while trying to figure it out, with no joy.
• How would I do the feature that is in ADMIN CP > Forums & Moderators > Show All Moderators, whereby it displays the last online in different colours, based on their last activity? I managed to find the code in forum/admincp/moderator.php;

PHP Code:

if ($supergroup['lastactivity'] >= $unixtoday)
{
$onlinecolor = 'modtoday';
}
else if ($supergroup['lastactivity'] >= ($unixtoday - 86400))
{
$onlinecolor = 'modyesterday';
}
else if ($supergroup['lastactivity'] >= ($unixtoday - 864000))
{
$onlinecolor = 'modlasttendays';
}
else if ($supergroup['lastactivity'] >= ($unixtoday - 2592000))
{
$onlinecolor = 'modsincetendays';
}
else
{
$onlinecolor = 'modsincethirtydays';
} 


Which I unsuccessfully tried to convert into;

PHP Code:

<if condition="$user['lastactivity'] >= $unixtoday">$user[lastonline]
<else />
<if condition="$user['lastactivity'] >= ($unixtoday - 86400)"><span style="color:green">$user[lastonline]</span>
<else />
<if condition="$user['lastactivity'] >= ($unixtoday - 864000)"><span style="color:blue">$user[lastonline]</span>
<else />
<if condition="$user['lastactivity'] >= ($unixtoday - 2592000)"><span style="color:orange">$user[lastonline]</span>
<else />
<span style="color:red">$user[lastonline]</span>
</if></if></if></if> 


What am I doing wrong?

Some Suggestions

• postbit_onlinestatus is uncached. Opening up showroster.php, and adding the following appears to fix this;
  
  

  // pre-cache templates used by all actions
  $globaltemplates = array(
  'SHOWROSTER',
  'showroster_header',
  'showroster_userbits',
  'postbit_onlinestatus'
  );

• Replace all instances of <br> (9) with <br /> for XHTML validation.
• Continuing with XHTML, still in showroster.php change the following line to include;
  
  

  $avatarimage='<img src="'.$avatarurl.'" border="0" alt="" />'; //Use $avatarimage in userbits to display avatars

• Also XHTML, in product-showroster.xml, find and edit;
  
  

  Originally Posted by (showroster_header template)

  <td class="thead">Avatars</td>
  </tr>
  $rosterbits
  </table>

• "Last Online" can be phrased using $vbphrase[last_online].

A Request

Rather than decide who appears/can view a roster via bitfields, would it be possible to do it via a ADMIN CP > vBulletin Options > Edit Settings Option (Similar to Cyb's mod I mentioned earlier)? I have quite a lot of usergroups, and I imagine most people who have clans/guilds use their forums do too, and it's a bit of a pain having to update each user group manually for those permissions, particularly if you use more than one roster. Those options would ideally include;

• "User groups to show in roster" and a input area, where by the user group ids entered would be shown on the roster, in the order entered.
• "User groups who can view roster" where you enter the user groups id that can view it, and where 0 means all groups can view it.

If doing it via that method is a lot of work/you think bit fields is a better way then no worries, I just thought I'd ask .



----------------------------

Originally Posted by michael5472

Done any chance ?

I don't know how to enable BB code in the field, and I can't view users profiles without signing up, so don't know what else you use the "Play Monitor" field for, but a possible idea that may you might find suitable is;

• Change your "Play Monitor" description to say "Enter the server IP you wish to track".
• Enter the IP in that field: eg; 217.163.28.224:28960
• In your showroster_userbits template, put this;

<if condition="$user[fieldX]"><img src="http://www.gametracker.com/server_info/$user[fieldX]/b_560x95.png" alt="$user[fieldX]" border="0" /><else />No Server Tracked</if>

If that's not of any use to you then I'm afraid you'll have to wait for someone else to reply regarding enabling BB code, as I can't help you.

[Sarcoth]

Originally Posted by michael5472

Done any chance ?

Not yet. I usually try to look over code while at work...don't tell please...but I can't get to your site from there. My evenings have been busy this whole week. I'll definitely get around to taking a look as soon as time permits; probably this weekend.