Profile Enhancements - Customizable Roster (Member List)

Customizable Roster (Member List)
[How to] get a working Guild/Clan Roster

Note: This modification is now discontinued - this means that while it will remain available for download and use, support will no longer be provided as the thread is no longer monitored. Please see the 3.7 release of this modification for future updates here.

Introduction:

This Mod started off as a [How to] template modification. I have since added in permission control and an installer. Those that install this Mod will need to make adjustments to two templates and one phrase depending on what you want displayed. I'll include instructions for each step as well as optional changes you can make at your decretion.

Click the following link for a Guild Roster preview: http://vanguard.sacredhaven.org/forums/showroster.php

You'll notice that I use the "Extra Profile Fields Page" by Wired1. It isn't needed for the Roster, but I think it makes the field updates look nicer for the users.


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 the colspan 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.

Enjoy!!!


Versions:

v1.1.3 - April 22, 2007

• Added 'Who's Online' plugin to the installer (Thanks m002.p).
• Made an update to the optional.txt file for changing the default sort.

v1.1.2 - April 20, 2007

• Added sorting to the roster. This is optional and will work without adding the sorting features.

v1.1.1 - April 19, 2007

• Small update. Just added total member count.

v1.1 - April 5, 2007 (Mod Revamp)

• Revamped everything. There is now an installer to do most of the work for you.
• The installer adds two new fields to your usergroup table. This allows you to set permissions for the showroster rather than using the showgroups permissions.
• Removed a few options from the optional.txt file since they are now a part of the mod.

v1.03 - April 2, 2007

• Added some code back to the showroster.php so join date, last activity, and usernames HTML markups could be used.
• Changed $user[username] to $user[musername] in the showroster_userbits template. This will allow HTML markups to the usernames again.
• Added instructions on how to change which usergroups appear on the Roster.
• Added optional.txt to the zip for optional changes.

v1.01 - March 27, 2007

• Changed a few variable names.
• Changed template names.
• Removed a lot of unneeded code from the showroster.php.
• Added the ability to include user avatars.
• Added a counter to keep track of how many users in each usergroup.

v1.01 - March 9, 2007

• Removed a lot of unneeded code from the SHOWROSTER template.
• Fixed a couple code problems.

v1.0 - March 6, 2007 (Initial Release)

[Shana]

Awesome; installing.

Edit: // Well it seems like it works but it only shows groups that are in the 'Forum Leaders' list. Anyway to make it show only those that appear on Members List? Everything else works smoothly

[Sarcoth]

Shana - Sorry, but right now I have it using the same list as the Forum Leaders. Thanks for pointing that out to me though, I updated Step #5 above. I originally had Memberlist there, but I should have had Forum Leaders.

This may not be ideal for your site, but for mine I changed 'Viewable on Show Groups' to No for all usergroups except for the ones I wanted to appear on the Roster.

[Sarcoth]

I removed some unneeded code from the showroster.php file. Redownloading the file is optional. Just copy it over your old showroster.php file.

[Shana]

Yeah, I did the 'Viewable on Show Group's thing. I don't mind that- just wondering if there's anyway to make it not only show those on Forum Leaders. Like, show those that are on Viewable on Show Groups only.

[turnipofdoom]

Hmmm, removal of those two snippets of code, or one of them, results in just a blank white page for me as opposed to the vBulletin error. I'm going to dig a bit more to see if I can't come up with the reason for the errors I'm getting.

[Sarcoth]

I updated the SHOWROSTER template; removed some extra unneeded code there. It may cause an error if you aren't using the newest showroster.php file that I uploaded yesterday.

I'll have some new updates next week.

1) A counter will be added for each group.
2) Vanguard guilds will have a lot more additional code. The code should be easily adaptable for EQ1 and EQ2 guilds as well, but it will be left up to you to figure it out.

Check out the link to my guilds roster if you want to see where I have it right now.

http://vanguard.sacredhaven.org/forums/showroster.php

[oglsmm]

Very nice mod. I used to to create one for FFXI.

My only question: How do I make it so that only the Members of the Linkshell can view the List?

I can't find anywhere to restrict who can see the forum leaders section.

[Sarcoth]

Sadly this isn't an option for UserGroup management, but there are a few ways you can accomplish this. Rather than upload a whole new showroster.php file, I'll give you the best and quickest way I can think of.

Open your SHOWROSTER template and replace it with the following code.

$stylevar[htmldoctype]
<html dir="$stylevar[textdirection]" lang="$stylevar[languagecode]">
<head>
$headinclude
<title>$vboptions[bbtitle] - $vbphrase[show_roster]</title>
</head>
<body>
$header
$navbar

<if condition="(is_member_of($bbuserinfo, 5, 6, 9, 10))">$usergroups<else /><center>You do not have permission to view this page! Turn back now or you will be beheaded!</center></if>

$footer
</body>
</html>

Update the numbers in ($bbuserinfo, 5, 6, 9, 10) to whatever usergroups you want to have access to that area. You can also upgrade the warning message to whatever you prefer.

I hope this helps.

Thanks for clicking install.

[oglsmm]

That worked great. Thanks a lot. This really is a great MOD for Guild sites. I've been looking for one forever, and finally there is one

One last question, is it possible to make the list sortable by the custom fields?

[dbirosel]

What if i want to add them manually to the list? I don't want them to edit there member profile and get automatically to a usergroup. Is it possible for me to add them manually and of course easier?