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)

[cerulean]

Originally Posted by Sarcoth

Cerulean - What file do you mean? This Mod has no connection to WoW or any other game, it should be useable for just about any site or for any reason. I use it for my Vanguard: Saga of Heroes guild. My Mod can work well with the Extra Profile Field hack if that is what you mean. I think using that hack will make it easier to use this Mod if you are using profile fields.

Main Settings
SQL Debug Output on off
Debug Mode on off
SQL Window on off
Min CP Version
Min GP version
Min PvPLog version
Roster Main Language deDE -enUS- esES frFR
Website Address
Roster URL
char.php Compatibility Mode on off
Interface Directory URL
Interface Image Extension -jpg- png gif
Alt Interface Image Extension jpg png -gif-
Roster Images Directory URL
Timezone
Time Offest -12 -11 -10 -9 -8 -7 -6 -5 -4 -3.5 -3 -2 -1 -0- +1 +2 +3 +3.5 +4 +4.5 +5 +5.5 +6 +6.5 +7 +8 +9 +9.5 +10 +11 +12 +13
Allow upload of PvPLog Data yes no
Addon Update Triggers on off

When I go into the Admin.php file and hit Guild config I get a block for

Guild Name
Server Name
Guild Description
Server Type -PvE- PvP RP RPPvP
Alt-Text Search
Alt-Search Field -Player Note- Officer Note Guild Rank Number Guild Title



And if I click on Roster tab I get - Could not find guild: 'The GuildFriends' for server ''
You need to load your guild first and make sure you finished configuration

Click here for installation instructions



Also when I click on update progile it is asking for CharacterProfile.Lua and PvPLog.Lua.

Where to some of these files exist or where do I add them.

If I have to add them what format do I need?

[Sarcoth]

@ lulanglo - I'm back in town and should have the sorting feature posted this week. I didn't change anything in my joined date time, it is probably still from a default setting. My guess is you may have changed something regarding display date in the settings.

@ cerulean - That isn't from my Mod. The only admin settings to change for my Mod are in the usergroups and the phrases.

[m002.p]

Hey Sarcoth im looking forward to your new version. Ill keep myself informed of the progress you make.

Looking forward to the total member count & also the sorting bit

Also a question; in the add-on (class stats) what could i use that for? Any ideas etc? Obviously my clan isnt based around the game you have so its a little tricky

Cheers & hope you had a good easter break from all this

Matt

[m002.p]

Ah i also had an addition to post regarding this mod which will need sarcoths approval before added to the mod as an option etc

Basically in order to have the feel of better intergration with the forums; the little touch of adding some info to the "whos online" page, rather than the current "Unknown Location" message may help you

This is what you very simply need to do:

1. On your web FTP server find this file located in the forum directory:

/includes/functions_online.php

2. Open it via a text editor and find:

case 'bugs.php': 
        $userinfo['activity'] = 'bugs'; 
        break;

3. Underneath add this code:

case 'showroster.php': 
        $userinfo['activity'] = 'showroster'; 
        break;

4. Now find this code:

case 'modcplogin':
			$userinfo['action'] = $vbphrase['moderator_control_panel_login'];
			break;

5. After this code add:

case 'showroster': 
            $userinfo['action'] = 'Viewing Clan Roster'; 
            break;

*Note: You can change the "Viewing Clan Roster" text to anything you desire but I would suggest using either "Viewing Clan Roster" OR "Viewing Guild Roster"

Hope it helps you add a final touch to this great mod

Matt

[Sarcoth]

Ahhh, yes. That "Who's Online" addition comes from one of my favorite articles, "How to create your own vBulletin-powered page!"; not sure if it was posted elsewhere. Thanks for pointing that out moo2.p. I'll definitely be sure to add that in my update.

I'm not really sure what you could use the class stats for. A possibility could be to show the number of people that play SWAT 4, SWAT 4: DSS, and BF2. The only problem is that some people can do more than one so it would be more difficult to code. You'd have to make a lot of changes to that field as well so personally it isn't worth going that route. Other than that, you could do it for countries, but you'd have to manually change it anytime someone joined from a new country. Too much work in my opinion. I don't think it is needed for your roster.

[lulanglo]

Originally Posted by Sarcoth

@ lulanglo - I'm back in town and should have the sorting feature posted this week. I didn't change anything in my joined date time, it is probably still from a default setting. My guess is you may have changed something regarding display date in the settings.

@ cerulean - That isn't from my Mod. The only admin settings to change for my Mod are in the usergroups and the phrases.

Hey Sarcoth,
really nice to hear the sorting feature will be available soon ! we really apreciate all the time you are puting in this growing project !
for the joined date, i just dont know what to put in my showroster_userbits...

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

Thank.

Luc

[m002.p]

To be honest it was a thread ive never seen. I knew that process due to coding I do on my own site and my knowledge of php code learnt at college. Nevermind, I will certainly follow up those threads.

Thanks for the info too Sarcoth, ill keep the add-on in my mind anyway

BTW... when is the new version of the mod expected?

Matt

[Mookie]

Sarcoth, I am loving the hack but a few admins on my gaming site and I are wondering, is it possible to have Multiple Rosters for each game that we play?


Thanks ahead of time.

EDIT: I am using 'Extra Profile Fields Page' for the guild roster profile input fields.

[m002.p]

Yes Mookie, I think it is.

You would need to rename the showroster.php each time along with any other uploads to something different.

Then for it to display correctly you would have to create secondary usergroups for each game and then mod which members appear on each roster. I think it maybe hard to do though and I wouldnt be inclined to try just incase :s

Maybe Sarcoth with know more.

However you could add an extra profile field called "games" then have a dropdown for the games your members play. Then add it to the roster with icons or just text.

Have a look www.sog-team.co.uk/forum/showroster.php

Good luck

Matt

[Mookie]

Let me see if i am understanding you. Each Guild Rank has to have its own Usergroup. Or is there a option where the user can select if he or she is a member of that game.

Also a few suggestions for a update would be:

• Make a Option for addition of multiple games.
• Option for user to select which games they would like to be display on.
• A feature where the Web Admin can select the users rank and if not they go to a predetermined Rank.
• Incorperate the 'Extra Profile Fields Page' into the hack to seperate the game input rosters.

And if you can do all this I will drop some money in that bank account