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]

Yea, I keep meaning to make that part of the instructions. Thanks Anti.

@ Anti - I am planning to go down the list of requests tonight.

BTW, I just tried the online status option on my forum and it is working. I turned it on and a bunch of them lite up for the users online. If you have edited the _userbits template, you may want to copy it (backup) and revert it back to the original.

The column width is easy though. Open the _userbits template, after you revert it back, and change all the <td> to <td width="10%"> or whatever percentage you want.

[Antidepresiv]

I don't have that width anywhere.. :/ Here is my userbits template :

<vb:if condition="$showbits == 1">
	<tr>
		<td>
			<vb:if condition="$show[avatarcol]">
				<vb:if condition="$show['avatar']">
					<img class="avatar" src="{vb:raw avatarurl}" alt="{vb:rawphrase xs_avatar, {vb:raw userinfo.username}}" />
				<vb:else />
					<img class="avatar" src="images/misc/avatar.png" alt="{vb:rawphrase no_avatar_specified}" />
				</vb:if>
			</vb:if>
			<a href="member.php?{vb:raw session.sessionurl}u={vb:raw userinfo.userid}-{vb:raw userinfo.username}">{vb:raw userinfo.musername}</a>
			<vb:if condition="$show[onlinestatuscol]">{vb:raw userinfo.onlinestatus}</vb:if>
		</td>
		<vb:if condition="$show[field1st] AND exec_switch_bg()"><td>{vb:var userinfo.{vb:var columns[column1]}}</td></vb:if>
		<vb:if condition="$show[field2nd] AND exec_switch_bg()"><td>{vb:var userinfo.{vb:var columns[column2]}}</td></vb:if>
		<vb:if condition="$show[field3rd] AND exec_switch_bg()"><td>{vb:var userinfo.{vb:var columns[column3]}}</td></vb:if>
		<vb:if condition="$show[field4th] AND exec_switch_bg()"><td>{vb:var userinfo.{vb:var columns[column4]}}</td></vb:if>
		<vb:if condition="$show[field5th] AND exec_switch_bg()"><td>{vb:var userinfo.{vb:var columns[column5]}}</td></vb:if>
		<vb:if condition="$show[field6th] AND exec_switch_bg()"><td>{vb:var userinfo.{vb:var columns[column6]}}</td></vb:if>
		<vb:if condition="$show[field7th] AND exec_switch_bg()"><td>{vb:var userinfo.{vb:var columns[column7]}}</td></vb:if>
		<vb:if condition="$show[field8th] AND exec_switch_bg()"><td>{vb:var userinfo.{vb:var columns[column8]}}</td></vb:if>
		<vb:if condition="$show[datejoinedcol] AND exec_switch_bg()"><td>{vb:raw userinfo.datejoined}</td></vb:if>
		<vb:if condition="$show[lastactivecol] AND exec_switch_bg()"><td>{vb:raw userinfo.lastactive}</td></vb:if>
		<vb:if condition="$show[profilepiccol] AND exec_switch_bg()"><td>{vb:raw userinfo.profilepic}</td></vb:if>

	</tr>
</vb:if>

Thanks again..

Best Regards,
Antidepresiv

[Sarcoth]

@ Anti - Yea, that looks like the default one. I don't see anything wrong with it in regards to the online status. Mine works perfectly. To get the width set, you need to change all the <td> to <td width="10%"> and you'll have them all the same width.

[Sarcoth]

Originally Posted by Barteh

Bit like this:

          CoD4 CoD5 CoD7 BFBC2 etc etc
Member  1  ?    ?    ?     ?
Member  2  ?    ?    ?     ?
Member  3  ?    ?    ?     ?
...
Member 40  ?    ?    ?     ?

User input field per category (i.e. game) would be a pulldown menu or a set of radio buttons, either simply with the same colour codes or descriptive texts like this:

Are you active in this game?

Yes
Occasionally
Rarely
Don't own it

I'm not entirely sure how to properly do the conversion bit from text values to images. Maybe the last value should be simply 'no' so the options can simply be variables translating to image names (occasionally.jpg -> dark green pip for example). But at my first attempts I mostly just broke the script

Alright, I got this working. Here is how to set it up.

Go to the AdminCP -> User Profile Fields -> Add New User Profile Field
Select Single-Selection Menu
Put whatever you want in most of the fields, but you'll need to use the following for Options:

Yes
Occasionally
Rarely
Not Owned

You can change the Options to other words, but you will need to update the template code (listed below). Also, do not use special characters (like single or double quotes).

Next, edit the showroster_userbits template by adjusting one of the field column's. My example will be using the column8 one.

Look for:

<vb:if condition="$show[field8th] AND exec_switch_bg()"><td>{vb:var userinfo.{vb:var columns[column8]}}</td></vb:if>

Replace with:

<vb:if condition="$show[field8th] AND exec_switch_bg()">
	<td>
		<vb:if condition="$userinfo['field42'] == 'Yes'"><img class="avatar" src="images/misc/active1.png" alt="Yes" /></vb:if>
		<vb:if condition="$userinfo['field42'] == 'Occasionally'"><img class="avatar" src="images/misc/active2.png" alt="Occasionally" /></vb:if>
		<vb:if condition="$userinfo['field42'] == 'Rarely'"><img class="avatar" src="images/misc/active3.png" alt="Rarely" /></vb:if>
		<vb:if condition="$userinfo['field42'] == 'Not Owned'"><img class="avatar" src="images/misc/active4.png" alt="Not Owned" /></vb:if>
	</td>
</vb:if>

Obviously, you can change the active#.png files with any any image files you want to use.

Good luck!

[Sarcoth]

Hey folks. My school starts up again on Monday so I'm planning to head back into hiatus. I've also decided to stop taking requests for modifications, sorry. Guess I'm just tired of doing things for free. I may come back now and then to release updates, but no promises. I will gladly fix things if found broken, but I'm very happy with where this mod is at now.

If you have helped me with code in the past or have made a donation or I use one of your mods on my site, just send me a PM if you need anything. To the rest, just post your questions here, I will come back to answer them occasionally. There also may be others willing to help with code updates.

Finally, I am planning to release another mod very soon. I think it will be a great add-on for this mod and can also be used solo. I'll make another post here once it is released.

Take care!

[Trek]

Originally Posted by Sarcoth

Finally, I am planning to release another mod very soon. I think it will be a great add-on for this mod and can also be used solo. I'll make another post here once it is released.
Take care!

If this has anything to do with game/member management... you know you can count me in! Let me know if you need some testing done!

[Barteh]

Originally Posted by Sarcoth

Alright, I got this working. Here is how to set it up.

I'm still poking at the layout and settings on my test forum (specifically where in the user settings to let these custom fields show up, I also have a computer specs mod and I want to visually separate these fields), but images work exactly as advertised, thanks

I've also swapped the column titles for icons. Edit the showroster_header template, find:

<vb:if condition="$show[field1st]"><th class="showroster_columnhead">{vb:var columns.title1}</th></vb:if>
<vb:if condition="$show[field2nd]"><th class="showroster_columnhead">{vb:var columns.title2}</th></vb:if>

(etc)

Replace with:

<vb:if condition="$show[field1st]"><th class="showroster_columnhead"><img src="images/misc/showroster/{vb:var columns.title1}.png" ALT="{vb:var columns.title1}"></th></vb:if>
<vb:if condition="$show[field2nd]"><th class="showroster_columnhead"><img src="images/misc/showroster/{vb:var columns.title2}.png" ALT="{vb:var columns.title2}"></th></vb:if>

As for column titles, the filesystem restrictions apply (no : " etc, also no '), example below. Images are placeholders, hence a couple missing.

[ShawnV]

Originally Posted by Sarcoth

Hey folks. My school starts up again on Monday so I'm planning to head back into hiatus.

Thanks Sarcoth, roster is working fine. I noticed you guys are also doing RIFT, what server and faction?

[Sarcoth]

Originally Posted by ShawnV

Thanks Sarcoth, roster is working fine. I noticed you guys are also doing RIFT, what server and faction?

Yea, we are going to be moving over to that fully. The beta has been a blast. Right now we are on Wolfsbane and going Guardians. That has been the voted upon faction for release, but nothing is definite till we start.

BTW, I am going to do some extra code for setting up my guild in RIFT. The new roster I am going to have will have columns for Class and Role. Class will be Cleric, Mage, Rogue, and Warrior. Role will be: Control, DPS, Healer, and Tank. The extra code will be for using the Statistic addon for the roster (it shows how many of each group are there). Basically, I will have each class separated on the Stats and then down by their row and the count. Check my roster for what I mean. If you look at my roster, you'll see that it does not do the stats correctly because all the counts are going to the first column. I'll eventually fix that. Since everyone can have 3 souls, it is kind of pointless going that route.

If you are interested in it when I'm done, send me a PM.

[Sarcoth]

@ Barteh - Were you actually asking a question there? I'm sorry if you were. Otherwise, I am glad it is working.