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]

@drainpan - It can be done in the header or the userbits, but because of some code I added, it is just easier to do it in the userbits to get away from the possibility his code doesn't user the header. Hard to explain.

Anyhow, one more question for you Warden, I didn't think of this beforehand, but which field columns were you using? I'm going to guess it is field1st and field2nd, since I know you are using the musername, join date and last activity one. I'll just add the width to each one and let you edit it from there. You will want to change the percentages around till you are happy.

<tr>
	<td width="20%">
        <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" width="20%">{vb:var userinfo.{vb:var columns[column1]}}</td></vb:if>
	<vb:if condition="$show[field2nd]"><td nowrap="nowrap" align="center" width="20%">{vb:var userinfo.{vb:var columns[column2]}}</td></vb:if>
	<vb:if condition="$show[field3rd]"><td nowrap="nowrap" align="center" width="20%">{vb:var userinfo.{vb:var columns[column3]}}</td></vb:if>
	<vb:if condition="$show[field4th]"><td nowrap="nowrap" align="center" width="20%">{vb:var userinfo.{vb:var columns[column4]}}</td></vb:if>
	<vb:if condition="$show[field5th]"><td nowrap="nowrap" align="center" width="20%">{vb:var userinfo.{vb:var columns[column5]}}</td></vb:if>
	<vb:if condition="$show[field6th]"><td nowrap="nowrap" align="center" width="20%">{vb:var userinfo.{vb:var columns[column6]}}</td></vb:if>
	<vb:if condition="$show[field7th]"><td nowrap="nowrap" align="center" width="20%">{vb:var userinfo.{vb:var columns[column7]}}</td></vb:if>
	<vb:if condition="$show[field8th]"><td nowrap="nowrap" align="center" width="20%">{vb:var userinfo.{vb:var columns[column8]}}</td></vb:if>
	<vb:if condition="$show[datejoinedcol]"><td nowrap="nowrap" align="center" width="20%">{vb:raw userinfo.datejoined}</td></vb:if>
	<vb:if condition="$show[lastactivecol]"><td nowrap="nowrap" align="center" width="20%">{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>

[Sarcoth]

Originally Posted by drainpan

I have a problem with this. I am using 4.0.2



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?

I think you are upgrading from an old version. You need to remove all the old files, check the install instructions. I don't recall the name of the file to remove, but it is in your includes/xml file.

[drainpan]

Originally Posted by Sarcoth

I think you are upgrading from an old version. You need to remove all the old files, check the install instructions. I don't recall the name of the file to remove, but it is in your includes/xml file.

This wasn't an upgrade.

I have vb4.0.2 and I installed the 4.0.2 version of this mod, of course it was before the 4.0.3 versions came out but never noticed this problem until the other day.

I am not sure the new version will work without having to upgrade my forum version as well which I am not going to do.... tired of the upgrades.

[Sarcoth]

@ drainpan - my 4.0.3 version works with vbulletin 4.0.2. Remove everything from the old version you installed and install the newer version. I improved a lot of things.

[drainpan]

now once upgraded... it refuses to show any data even though all fields are populated and submitted. Usergroups to be displayed are also set

[drainpan]

:crickets: any idea why this is happening?

I followed the instructions to a "T" and I cannot get any people to show up on the list.

[Sarcoth]

Sorry, I take a break from emails over the weekend. Family time.

Anyhow, I could take a look at your page and look into the problem for you if you like. I'm not very busy today. Send me a PM with a link to your roster page and please make sure that the page is open to unregistered users. Or, better yet, create me an account and PM those details to me. I may need admin privledges to look into your problem. No way for me to guess at your error when nothing is showing up.

[Trek]

Installed this finally. =)

Sarcoth, worked really good. A few suggestions

The borders are set by default, which looked really bad on my dark background. Easy enough to fix. Only suggestion here is, documentation telling those that might not know how to change them. I read the install doc, but I mean more specific on that exactly.

The navbar option should allow for not having a navbar option (I just disabled the plugin, but others might not know how). Also a section for including a link to it in quicklinks, etc.

[SuperTaz]

Thanks. Worked out fine.

[Sarcoth]

Originally Posted by Trek

Installed this finally. =)

Sarcoth, worked really good. A few suggestions

The borders are set by default, which looked really bad on my dark background. Easy enough to fix. Only suggestion here is, documentation telling those that might not know how to change them. I read the install doc, but I mean more specific on that exactly.

The navbar option should allow for not having a navbar option (I just disabled the plugin, but others might not know how). Also a section for including a link to it in quicklinks, etc.

Hey Trek. I'll look into the borders first thing when done with this semester. The navbar suggestion is already on the list. I'll have to look into the quicklinks thing. Thanks.