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.

[Niak_Judge]

Great idea, thank you for sharing this !

*DownLoaded + installed *

[brown12321]

Nice Idea. Is there a way NOT to add it to the navbar?

[Sarcoth]

Originally Posted by brown12321

Nice Idea. Is there a way NOT to add it to the navbar?

You know, I thought that was an option, but now since you mention it I'll have to check it out. Has to wait a couple weeks though. Semester is still winding down and I have a lot of things that need to be done; including a lot of studying.

In the meantime, you could turn off the plugin that is creating the tab on the navbar. That should do the trick, but it would still create the tab when you go to the roster.

[brown12321]

Originally Posted by Sarcoth

You know, I thought that was an option, but now since you mention it I'll have to check it out. Has to wait a couple weeks though. Semester is still winding down and I have a lot of things that need to be done; including a lot of studying.

In the meantime, you could turn off the plugin that is creating the tab on the navbar. That should do the trick, but it would still create the tab when you go to the roster.

Ok, that worked but it still comes up when you go to the roster. Is there a way to call the tab what you want. I want to change it so it does not say roster?

[Sarcoth]

Originally Posted by brown12321

Ok, that worked but it still comes up when you go to the roster. Is there a way to call the tab what you want. I want to change it so it does not say roster?

Yea, I mentioned that it would still show up when on the roster. There is some code you could remove at the bottom of the php file, but I can't look at it now. That would remove it from the roster as well. You can change the name of it with some edits to the code, but again, I'd need to look at the code. Just look for something like 'Roster' in the php file. I will be adding it to the options in the next version though.

[brown12321]

Originally Posted by Sarcoth

Yea, I mentioned that it would still show up when on the roster. There is some code you could remove at the bottom of the php file, but I can't look at it now. That would remove it from the roster as well. You can change the name of it with some edits to the code, but again, I'd need to look at the code. Just look for something like 'Roster' in the php file. I will be adding it to the options in the next version though.

I just removed the following from the showroster.php and the tab is now gone:

PHP Code:

// ###SPECIAL NAVBAR############################################################
$accessgroups = explode(',', $vbulletin->options['showroster_access_groups']);
$navbarloc = $vbulletin->options['showroster_navbar_loc'];

switch ($navbarloc) {
    case '1':
        $nbloc = 'navtab_start'; break;
    case '2':
        $nbloc = 'navtab_middle'; break;
    case '3':
        $nbloc = 'navtab_end'; break;
}

if (THIS_SCRIPT == 'showroster') {
    $vbulletin->options['selectednavtab'] = 'showroster'; 
}

$templater = vB_Template::create('showroster_navbar');
    $templater->register('sorturl', $sorturl);
    $templater->register('accessgroups', $accessgroups);
    $templater->register('columns', $columns);
    $templater->register('sortgroupfield', $sortgroupfield);
    $templater->register('oppositesort', $oppositesort);
$template_hook[$nbloc] .= $templater->render();
// ###SPECIAL NAVBAR############################################################ 


[Sarcoth]

I'm brilliant! Apparently I did put markers in the code. Please click install and enjoy!

[drainpan]

I have a problem with this. I am using 4.0.2

MySQL Error : Unknown column 'showrosteraccesspermissions' in 'field list'
Error Number : 1054
Request Date : Sunday, April 18th 2010 @ 11:17:02 AM
Error Date : Sunday, April 18th 2010 @ 11:17:02 AM
Script : http://www.+++++nipples.com/forum/ad....php?do=update
Referrer : http://www.+++++nipples.com/forum/ad...&usergroupid=6

As you can see by the attached screenie... in the usergroup manager there is this category that has no title and no choices and when submitting any changes it throws the above error.

Any ideas?

[SuperTaz]

Originally Posted by Sarcoth

Yep. Copy/paste your showroster_userbits here and I'll edit it for you. showrosterbits is the template call to that template in the php file. I sometimes forget to distinguish them.

BTW, I don't know why I said colspan last night, I meant width. Funny that I was thinking width but typed the other. My macroeconomics class is frying my brain.

Here you go:

<vb:if condition="$showbits == 1">
<tr>
	<td>
        <table cellspacing="0" cellpadding="0" width="100%">
          <tr>
            <vb:if condition="$show[onlinestatuscol]"><td>{vb:raw userinfo.onlinestatus}</td></vb:if>
            <td width="80%">
		<vb:if condition="!$show[onlinestatuscol]">&nbsp;</vb:if><a href="member.php?{vb:raw session.sessionurl}u={vb:raw userinfo.userid}-{vb:raw userinfo.username}">{vb:raw userinfo.musername}</a>
            </td>
          </tr>
        </table>
	</td>
	<vb:if condition="$show[field1st]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column1]}}</td></vb:if>
	<vb:if condition="$show[field2nd]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column2]}}</td></vb:if>
	<vb:if condition="$show[field3rd]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column3]}}</td></vb:if>
	<vb:if condition="$show[field4th]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column4]}}</td></vb:if>
	<vb:if condition="$show[field5th]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column5]}}</td></vb:if>
	<vb:if condition="$show[field6th]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column6]}}</td></vb:if>
	<vb:if condition="$show[field7th]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column7]}}</td></vb:if>
	<vb:if condition="$show[field8th]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column8]}}</td></vb:if>
	<vb:if condition="$show[datejoinedcol]"><td nowrap="nowrap" align="center">{vb:raw userinfo.datejoined}</td></vb:if>
	<vb:if condition="$show[lastactivecol]"><td nowrap="nowrap" align="center">{vb:raw userinfo.lastactive}</td></vb:if>
	<vb:if condition="$show[avatarcol]"><td nowrap="nowrap" align="center""><vb:if condition="$show[avatar]"><img class="avatar" src="{vb:raw avatarurl}" border="0" {vb:raw avwidth} {vb:raw avheight} alt="{vb:rawphrase xs_avatar, {vb:raw userinfo.username}}" hspace="4" vspace="4" /><vb:else />&nbsp;</vb:if></td></vb:if>
	<vb:if condition="$show[profilepiccol]"><td nowrap="nowrap" align="center">{vb:raw userinfo.profilepic}</td></vb:if>
</tr>
</vb:if>

[drainpan]

Originally Posted by Warden-B-

Here you go:

<vb:if condition="$showbits == 1">
<tr>
	<td>
        <table cellspacing="0" cellpadding="0" width="100%">
          <tr>
            <vb:if condition="$show[onlinestatuscol]"><td>{vb:raw userinfo.onlinestatus}</td></vb:if>
            <td width="80%">
		<vb:if condition="!$show[onlinestatuscol]">&nbsp;</vb:if><a href="member.php?{vb:raw session.sessionurl}u={vb:raw userinfo.userid}-{vb:raw userinfo.username}">{vb:raw userinfo.musername}</a>
            </td>
          </tr>
        </table>
	</td>
	<vb:if condition="$show[field1st]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column1]}}</td></vb:if>
	<vb:if condition="$show[field2nd]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column2]}}</td></vb:if>
	<vb:if condition="$show[field3rd]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column3]}}</td></vb:if>
	<vb:if condition="$show[field4th]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column4]}}</td></vb:if>
	<vb:if condition="$show[field5th]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column5]}}</td></vb:if>
	<vb:if condition="$show[field6th]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column6]}}</td></vb:if>
	<vb:if condition="$show[field7th]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column7]}}</td></vb:if>
	<vb:if condition="$show[field8th]"><td nowrap="nowrap" align="center">{vb:var userinfo.{vb:var columns[column8]}}</td></vb:if>
	<vb:if condition="$show[datejoinedcol]"><td nowrap="nowrap" align="center">{vb:raw userinfo.datejoined}</td></vb:if>
	<vb:if condition="$show[lastactivecol]"><td nowrap="nowrap" align="center">{vb:raw userinfo.lastactive}</td></vb:if>
	<vb:if condition="$show[avatarcol]"><td nowrap="nowrap" align="center""><vb:if condition="$show[avatar]"><img class="avatar" src="{vb:raw avatarurl}" border="0" {vb:raw avwidth} {vb:raw avheight} alt="{vb:rawphrase xs_avatar, {vb:raw userinfo.username}}" hspace="4" vspace="4" /><vb:else />&nbsp;</vb:if></td></vb:if>
	<vb:if condition="$show[profilepiccol]"><td nowrap="nowrap" align="center">{vb:raw userinfo.profilepic}</td></vb:if>
</tr>
</vb:if>

It is actually done in the showroster_header