Customizable Roster

[Sarcoth]

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. See the optional.txt file included in the installation for additional changes that you can make at your discretion. The most popular option is the ability to add sorting; check it out!


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 both of the colspan variables 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 files)


Updates:

Version 1.2.0 - May 24, 2008

Release of this hack for vBulletin version 3.7.x.
This version works on all vBulletin versions from 3.6.0 and up.
This version works with vBadvanced CMPS version 3.0.1.


Version 1.2.1 - June 11, 2008

Updated code for XHTML validation.
Added a Date Joined column with code to support.
Added a Last Online column with code to support; also changes color.
Added a Birthday column with code to support; will be blank for users wishing to hide their birthday.
Added a ProfilePic column with code to support.


FUTURE VERSIONS

This version will no longer be supported or upgraded.


Click Here For A Preview (http://www.sacredhaven.org/forumsh/showroster.php)

PLEASE CLICK INSTALLED (https://vborg.vbsupport.ru/vborg_miscactions.php?do=installhack&threadid=180432).

Support will no longer be given for anything below vB4.x.

Go to Customizable Roster 4.0 for the newer supported mod. (https://vborg.vbsupport.ru/showthread.php?t=235326)

[Sarcoth]

Reserved for FAQ and Optional changes.


Can the column's be sorted? Yes, the code is already in the showroster.php. Check the optional.txt file on how to set it up.

[Mookie]

Sarcoth excellent Mod any way we could have it setup for mulitiple rosters. On our gamming site we plays mulitiple games Age of Conan, WoW, EQ2, and so on. We were wondering if there is a way to display each roster seperately? Could this be added into a new version or is it not possible?

[Sarcoth]

Sarcoth excellent Mod any way we could have it setup for mulitiple rosters. On our gamming site we plays mulitiple games Age of Conan, WoW, EQ2, and so on. We were wondering if there is a way to display each roster seperately? Could this be added into a new version or is it not possible?
Almost anything is possible. :) It really depends on your end goal. Do you want each game displayed on the same roster, and then via rank, then name? Or do you want each game displayed on its own roster page? In the latter, it is as easy as creating a separate showroster page for each game with just a few configuration/permission changes.

Post a list of the fields you are using. One of those fields will need the name of each game.

[stwilson]

Nice MOD. Thanks for sharing. I will use this as a version of the Member List, showing only Supporting Members. Since I will have quite a few names on my roster I would like to make two suggestions for future versions:

1. Allow for a header footer field that shows above or below the Roster/Memberlist
2. The ability to sort by specific columns by clicking on the header in that column

Excellent MOD for sure. I was looking for something like this. Thank you again.

[stwilson]

I just now noticed you had the code for sorting in the Optional file. THANKS.

[Skyrider]

Any screenies?

[stwilson]

I have a question. I am trying to include a member's Join Date in a column but the number that shows up is a ten digit number. How do I convert it back to the standard VB date format?

[stwilson]

Any screenies?


There is a PREVIEW link in the original post. :D

[ssslippy]

Added a usergroup with almost 400 members and the script fails to run, gives a white page.

I get no emails reporting errors.

[GlitchersCorner]

Nice Mod!

By any chance can you make an add-on for this or an option for users to create their own rosters? That would be extremely cool. I'd pay for that option!

[iogames]

Nice Mod!

By any chance can you make an add-on for this or an option for users to create their own rosters? That would be extremely cool. I'd pay for that option!

I chip-in!

[michael5472]

I have installed but can i make it show BBCODE in the profile field ?

doesn't work for me
http://www.theoldbreed.com/showroster.php

[Sarcoth]

Allow for a header footer field that shows above or below the Roster/Memberlist?
I don't think that would be very difficult to add, but what do you want to put there? The roster should already be using the forums header/footer.

I have a question. I am trying to include a member's Join Date in a column but the number that shows up is a ten digit number. How do I convert it back to the standard VB date format?
I recall something similiar to that, I'll look into it this week.

Added a usergroup with almost 400 members and the script fails to run, gives a white page. I get no emails reporting errors.
We had a problem with large usergroups back in vBulletin 3.6.x as well. I just tested it out on my roster with a usergroup that has 289 users in it; it worked successfully. I'd be curious to know if others are having any problems? How many fields are you using? Did you also try a smaller usergroup; if you have one? I'm sure you did, just asking though.

By any chance can you make an add-on for this or an option for users to create their own rosters? That would be extremely cool. I'd pay for that option!
Maybe in the future...but I fear that would be a lot of work. I'll research it though and maybe it can be done. No promises though.

I have installed but can i make it show BBCODE in the profile field ? doesn't work for me http://www.theoldbreed.com/showroster.php
You need to give unregistered users permissions to view it as well. I can't see it.

[michael5472]

You need to give unregistered users permissions to view it as well. I can't see it.

Done

[Sarcoth]

I have a question. I am trying to include a member's Join Date in a column but the number that shows up is a ten digit number. How do I convert it back to the standard VB date format?

Completed.

Open the showroster.php file.

Find:
fetch_musername($user);

After it add:
$user['datejoined'] = vbdate($vbulletin->options['dateformat'], $user['joindate'], true);

Your code in the showroster_userbits template should look similiar to this:
<td class="$bgclass" nowrap="nowrap">$user[datejoined]</td>


I'll be sure to add this in the next version for those that wish to use it.

[stwilson]

Worked like a charm. Thank you for the super mod!!!

[michael5472]

You need to give unregistered users permissions to view it as well. I can't see it.


Done any chance ?

[IR15H]

A few things...

Firstly, thanks for releasing this :).

Some Questions

How do I sort user groups in a custom order, say id 1, 4, 5, 3, 2 or name A, D, E, C, B? A similar thing is done for user groups in a legend by Cyberntec in his "Visitors in Last X Hours (https://vborg.vbsupport.ru/showthread.php?t=177965)" mod, but not being a coder I can't work it out myself.
How would I pull a user's age (not DOB), provided they haven't set it to private (Hide Age + DOB, Display Only Day and Month of Birth)? I spent quite a while trying to figure it out, with no joy.
How would I do the feature that is in ADMIN CP > Forums & Moderators > Show All Moderators, whereby it displays the last online in different colours, based on their last activity? I managed to find the code in forum/admincp/moderator.php;


if ($supergroup['lastactivity'] >= $unixtoday)
{
$onlinecolor = 'modtoday';
}
else if ($supergroup['lastactivity'] >= ($unixtoday - 86400))
{
$onlinecolor = 'modyesterday';
}
else if ($supergroup['lastactivity'] >= ($unixtoday - 864000))
{
$onlinecolor = 'modlasttendays';
}
else if ($supergroup['lastactivity'] >= ($unixtoday - 2592000))
{
$onlinecolor = 'modsincetendays';
}
else
{
$onlinecolor = 'modsincethirtydays';
}

Which I unsuccessfully tried to convert into;

<if condition="$user['lastactivity'] >= $unixtoday">$user[lastonline]
<else />
<if condition="$user['lastactivity'] >= ($unixtoday - 86400)"><span style="color:green">$user[lastonline]</span>
<else />
<if condition="$user['lastactivity'] >= ($unixtoday - 864000)"><span style="color:blue">$user[lastonline]</span>
<else />
<if condition="$user['lastactivity'] >= ($unixtoday - 2592000)"><span style="color:orange">$user[lastonline]</span>
<else />
<span style="color:red">$user[lastonline]</span>
</if></if></if></if>
What am I doing wrong?

Some Suggestions


postbit_onlinestatus is uncached. Opening up showroster.php, and adding the following appears to fix this;

// pre-cache templates used by all actions
$globaltemplates = array(
'SHOWROSTER',
'showroster_header',
'showroster_userbits',
'postbit_onlinestatus'
);
Replace all instances of <br> (9) with <br /> for XHTML validation.
Continuing with XHTML, still in showroster.php change the following line to include;

$avatarimage='<img src="'.$avatarurl.'" border="0" alt="" />'; //Use $avatarimage in userbits to display avatars
Also XHTML, in product-showroster.xml, find and edit;

<td class="thead">Avatars</td>
</tr>
$rosterbits
</table>
"Last Online" can be phrased using $vbphrase[last_online].


A Request

Rather than decide who appears/can view a roster via bitfields, would it be possible to do it via a ADMIN CP > vBulletin Options > Edit Settings Option (Similar to Cyb's mod I mentioned earlier)? I have quite a lot of usergroups, and I imagine most people who have clans/guilds use their forums do too, and it's a bit of a pain having to update each user group manually for those permissions, particularly if you use more than one roster. Those options would ideally include;

"User groups to show in roster" and a input area, where by the user group ids entered would be shown on the roster, in the order entered.
"User groups who can view roster" where you enter the user groups id that can view it, and where 0 means all groups can view it.


If doing it via that method is a lot of work/you think bit fields is a better way then no worries, I just thought I'd ask :).



----------------------------

Done any chance ?

I don't know how to enable BB code in the field, and I can't view users profiles without signing up, so don't know what else you use the "Play Monitor" field for, but a possible idea that may you might find suitable is;


Change your "Play Monitor" description to say "Enter the server IP you wish to track".
Enter the IP in that field: eg; 217.163.28.224:28960
In your showroster_userbits template, put this;

<if condition="$user[fieldX]"><img src="http://www.gametracker.com/server_info/$user[fieldX]/b_560x95.png" alt="$user[fieldX]" border="0" /><else />No Server Tracked</if>

If that's not of any use to you then I'm afraid you'll have to wait for someone else to reply regarding enabling BB code, as I can't help you.

[Sarcoth]

Done any chance ?

Not yet. I usually try to look over code while at work...don't tell please...but I can't get to your site from there. My evenings have been busy this whole week. I'll definitely get around to taking a look as soon as time permits; probably this weekend.

[Sarcoth]

Some Questions

1) My suggestion for custom order is to have all usergroups named with a number in front of it: 1-, 2-, etc. Then put something like the following within the .php file to change the $user['title'] names to what you want to appear.

switch($user['title']) {
case '1-A':
$Title = "A";
break;
case '2-D':
$Title = "D";
break;
}

Then you need to figure out how to get that into your template.

2 & 3) I'll look into that when time permits.


Some Suggestions

I'll definitely try out your suggestions and put those in my next version, thank you.


A Request
I originally tried to do that when I first started off making this mod but had some problems. I have a much better understanding of the code now though and will see about getting it changed for the next version. Again, thank you.

[michael5472]

I don't know how to enable BB code in the field, and I can't view users profiles without signing up, so don't know what else you use the "Play Monitor" field for, but a possible idea that may you might find suitable is;


Change your "Play Monitor" description to say "Enter the server IP you wish to track".
Enter the IP in that field: eg; 217.163.28.224:28960
In your showroster_userbits template, put this;



If that's not of any use to you then I'm afraid you'll have to wait for someone else to reply regarding enabling BB code, as I can't help you.

This worked with a bit of tweaking

I put this code in

<td class="$bgclass" nowrap="nowrap"><if condition="$user[field15]"><img src="http://www.gametracker.com/server_info/$user[field15]/b_560x95.png" alt="$user[field15]" border="0" /><else />No Server Tracked</if></td>

THANKS A LOT

[michael5472]

ok i just showed my members what i had been working on and one thinks it would be a good idea to have the profile pic on like the avatarl.

How would i work this in ?

[Code Monkey]

Is this limited to one clan only or can it be used by multiple clans that home at a forum? To show their own separate clan page.

[Dagothar]

Well, I apologize, but my newness to vBulletin has potentially screwed something here. Your instructions were very clear, and I've been looking forward to your roster.

But I see no difference to the configurable Members List nor to the Roster/Show Groups (View Forum Leaders' Page).
I've ensured I've added the 3 files to the correct place; I've followed all the Readme.txt instructions.
Why would it then not show? It should replace the Members List, correct?

[Sarcoth]

ok i just showed my members what i had been working on and one thinks it would be a good idea to have the profile pic on like the avatarl.

How would i work this in ?

I'll see what I can figure out on that.


Is this limited to one clan only or can it be used by multiple clans that home at a forum? To show their own separate clan page.

I'm sure it can be done with multiple clans. The easiest way would probably be to have separate showroster.php files for each clan. Just rename the showroster.php to the name of your clan like, clan1roster.php. Add a new field that has the players pick their clan. Somewhere near the top of the code, set up an <if> statement that only runs the code for those that happen to be in that particular clan.

I'm sure there's a way you could also do it with just the showroster.php file and by adding some more code, I just can't see it yet. As long as your fields are not too difficult, I could try to come up with something for you.


Well, I apologize, but my newness to vBulletin has potentially screwed something here. Your instructions were very clear, and I've been looking forward to your roster.

But I see no difference to the configurable Members List nor to the Roster/Show Groups (View Forum Leaders' Page).
I've ensured I've added the 3 files to the correct place; I've followed all the Readme.txt instructions.
Why would it then not show? It should replace the Members List, correct?

Did you go to the /forum/showroster.php? You'll need to type that in and make a link to it somewhere on your site. You could find where the Member List code is in the navbar template and change the link too.

[Dagothar]

...Did you go to the /forum/showroster.php? You'll need to type that in and make a link to it somewhere on your site. You could find where the Member List code is in the navbar template and change the link too.
:erm: :up: :D
No, I hadn't. But type that in, and Voil?, there it is!
Now to find that pesky navbar code...
Thanks!!

[Sarcoth]

<font color="Blue">UPDATE ALERT:

I've done a lot of updates on this mod over the last week. I am hoping to have the new version posted by the end of the week; Sunday maybe. The only thing I'm missing is the new permissions change that IR15H requested. I've always wanted to get switched over to that. I haven't looked at it yet, but I should have some time this week or weekend.

IR15H - I think I made all the changes you mentioned. I also have a working version with the color coded last activity you requested. I'll see about giving an optional addition for DOB for those that want it.

Michael - I added a profilepic part as well for those that want to use it.</font>

[Brian30fl]

are u adding the ability to have differant guilds to be used instead of just 1? or maybe seperate roster pages?

[Sarcoth]

are u adding the ability to have differant guilds to be used instead of just 1? or maybe seperate roster pages?

Brian, I'll try to dabble in that a little this week and see how far off I would be from implementing it. If I can't finish it by the end of this week though, I'll make that my top priority for the next version. I've been playing with some idea's lately though and I think I know how it can be done; no promises yet.

[Brian30fl]

it all good no rush m8

[IR15H]

This worked with a bit of tweaking

I put this code in

<td class="$bgclass" nowrap="nowrap"><if condition="$user[field15]"><img src="http://www.gametracker.com/server_info/$user[field15]/b_560x95.png" alt="$user[field15]" border="0" /><else />No Server Tracked</if></td>

THANKS A LOT

No problem, glad it was useful for you :).

UPDATE ALERT:

I've done a lot of updates on this mod over the last week. I am hoping to have the new version posted by the end of the week; Sunday maybe. The only thing I'm missing is the new permissions change that IR15H requested. I've always wanted to get switched over to that. I haven't looked at it yet, but I should have some time this week or weekend.

IR15H - I think I made all the changes you mentioned. I also have a working version with the color coded last activity you requested. I'll see about giving an optional addition for DOB for those that want it.

Michael - I added a profilepic part as well for those that want to use it.

Excellent! Thanks :D.

[Sarcoth]

<font color="Blue">I still can't get the permissions change thing to work. I tried to find a way to use what was suggested but I just don't see it. This hack uses a .php file, whereas the hack that I've been researching uses only templates and plugins. I still think it can be done, but it is just going to take me a lot longer.

I am going to take a look at getting the DOB added. Whether I get that working or not, I should have the new version released soon. The new version will be various fixes and minor additions that have been requested.</font>

[Replicators]

One thing i don't like about this mod is if a members has another usergroup, it shows them in that group in the list. Is there a way to not have them show up in their secondary usergroup in the roster?

[Sarcoth]

One thing i don't like about this mod is if a members has another usergroup, it shows them in that group in the list. Is there a way to not have them show up in their secondary usergroup in the roster?

This mod was mainly built for a guild roster where each member would only appear in one rank. Either they are the leader, officer, member, recruit or whatever. Not possible to be more than one. I will see if I can come up with some optional code to do this for you though. It just won't be part of the actual mod; you'll need to make the edit's to get it to work.

[theparentpack]

Does this replace my existing member list, or can I use it to create an additional roster for my various social groups and usergroups?

[Deyth]

Sarcoth, would you be willing to expand this mod for some money? I lead a multi-gaming guild and this roster, although nice, is single-game with no historical info. What I need is to define games, game servers, and their characteristics (races, classes, sub-classes, levels, etc.), let every board user enter their historical character data for every game and server I've defined, and then show a roster for the usergroups I select with the ability to narrow down by game and/or server. If you do this, it'll be THE definitive mod for gaming guilds.

[Dagothar]

I want to thank Sarcoth, who filled a major hole for us with this great mod. His upcoming update, to allow multiple versions, will also greatly help.

Does this replace my existing member list, or can I use it to create an additional roster for my various social groups and usergroups? No, and Yes.

Personally, I use this for my main Members' roster, for my Age of Conan guild. It's so nicely customizable, and sortable. I put it right up front on the menubar, and limit access to members who've successfully undergone our trial process.

I use the native showgroups.php for the leaders only, and crank it down to show just the leaders with the Admin CP Usergroups CP.

I use the native memberlist.php for all the registered users. That's buried in Quick Links.

http://the-sentinels.net/forum/

[ProtoPC]

Yes this will be a great addition! I am waiting for the multiple roster version.

[Brian30fl]

same i need the multiable roster edtion for my 10 guild alliance

[Sarcoth]

<font color="Blue">I'd like some feedback from those of you interested in a multiple roster. I've thought up a few ways that I can go with this but I'd really only be willing to go one route.

How are you handling permissions on your forum? Is everyone in the same usergroup and you are using profile fields to distinguish the guild/game they are in? Or do you have a different usergroup for each guild/game?

I've thought about going with the usergroup route, but I fear it may limit adjustments and can really get complicated. The better way to go would be creating a new profilefield (I recommend multiselection checkbox) that gives either just you (private) or the members (open) the choice to pick what guilds/games they are a part of.

After that, I should be able to set up a way that you will get to each individual roster by adding a little extra string at the end of your showroster.php command; like showroster.php?goto=guild/game.

Either way, I can forsee quite a few coding changes from your side to get it to work. Easy enough if you can follow directions though. Mainly would just need to add coding to the showroster.php to identify each individual guild/game.

Something to think about. I will probably get started on the code tonight but my time right now is light so it may take awhile for me to get it working. I'll post an update when able.</font>

[Brian30fl]

well with my forum i have each guild with there own usergroup for exsample lets say take my guild named Protect your package or PyP for short i would go with 3 user groups PyP Leader Pyp Officer PyP member have ever this would be the same system for the other 9 guilds how ever instead of sperate guild roster pages perhaps haveing 1 roster where it would say alliance roster and having the ability to have a guiolds name then the user groups then guild 2 and so forth

[ProtoPC]

I would keep it simple as you suggested. I would like to add it to a new site I am putting together... here (http://www.cywire.com). Seems like it would be a good fit. Thanks again for your time and I will look forward to your update before I install.

[Brax]

[COLOR="Blue"]Is everyone in the same usergroup and you are using profile fields to distinguish the guild/game they are in?

I prefer this way.

[Brian30fl]

I would keep it simple as you suggested. I would like to add it to a new site I am putting together... here (http://www.cywire.com). Seems like it would be a good fit. Thanks again for your time and I will look forward to your update before I install.
what u useing for your nice navbar?

[ProtoPC]

what u useing for your nice navbar?

Joomla

[Brian30fl]

wow looked* like vbadvanced.......

[IR15H]

I'd like some feedback from those of you interested in a multiple roster. I've thought up a few ways that I can go with this but I'd really only be willing to go one route.

How are you handling permissions on your forum? Is everyone in the same usergroup and you are using profile fields to distinguish the guild/game they are in? Or do you have a different usergroup for each guild/game?

I've thought about going with the usergroup route, but I fear it may limit adjustments and can really get complicated. The better way to go would be creating a new profilefield (I recommend multiselection checkbox) that gives either just you (private) or the members (open) the choice to pick what guilds/games they are a part of.

After that, I should be able to set up a way that you will get to each individual roster by adding a little extra string at the end of your showroster.php command; like showroster.php?goto=guild/game.

Either way, I can forsee quite a few coding changes from your side to get it to work. Easy enough if you can follow directions though. Mainly would just need to add coding to the showroster.php to identify each individual guild/game.

Something to think about. I will probably get started on the code tonight but my time right now is light so it may take awhile for me to get it working. I'll post an update when able.

Whilst I have no particular need for an inbuilt multi-roster system, I have to say I don't think a profile field option would be the best route. As far as I'm aware, profile fields aren't linked to permissions, such as view certain forums, or have certain moderating powers - which is probably quite important to many multi clan/guild communities.

[CodyMuir]

hey, i have a question!

I downloaded this, and i love it.



clandwd.com/showroster.php have to be registered because its not set up yet.
Anyways, for my clan ranks, i have custom titles for everything that is admin written.
I want each category to be based off their custom title, But, i want to be able to chose the order so Recruits are at the bottom etc.

Is this possible??

Because i included the usertitle in the postbit and it shows up, but i had a general category of..
"High Council"
And it showed, Me, Leader, Commander And Generals on it, but in random order.
Is there a way where i can sort that so it maybe goes by avatar id? or.. i don't even know.
But i want it to be organized. I made a ton of usergroups ex:
Leader
Commander
General and put people in them 1 by 1, which was very time consuming, thank god for mysql could easily copy / make new usergroups:)

Anyways, any suggestions? please

[Sarcoth]

Whilst I have no particular need for an inbuilt multi-roster system, I have to say I don't think a profile field option would be the best route. As far as I'm aware, profile fields aren't linked to permissions, such as view certain forums, or have certain moderating powers - which is probably quite important to many multi clan/guild communities.

Actually, I could set up an if statement that only shows the data for the particular guild/game they have placed in their profile field. But, since you can already assign which usergroups can view the roster, is it really neccesary to block one usergroup from viewing the other roster? IMO, if you are giving a usergroup permission to view one roster, you may as well give them permission to view them all. Otherwise, they may as well create another site for their guild.

[Sarcoth]

Anyways, for my clan ranks, i have custom titles for everything that is admin written.
I want each category to be based off their custom title, But, i want to be able to chose the order so Recruits are at the bottom etc.

Is this possible??

Because i included the usertitle in the postbit and it shows up, but i had a general category of..
"High Council"
And it showed, Me, Leader, Commander And Generals on it, but in random order.
Is there a way where i can sort that so it maybe goes by avatar id? or.. i don't even know.
But i want it to be organized. I made a ton of usergroups ex:
Leader
Commander
General and put people in them 1 by 1, which was very time consuming, thank god for mysql could easily copy / make new usergroups:)

Anyways, any suggestions? please

You can switch the sorting around any way you like. Check out my optional.txt file included in the zip package. There are various ways you can go to get it sorted, just experiment.

[IR15H]

Actually, I could set up an if statement that only shows the data for the particular guild/game they have placed in their profile field. But, since you can already assign which usergroups can view the roster, is it really neccesary to block one usergroup from viewing the other roster? IMO, if you are giving a usergroup permission to view one roster, you may as well give them permission to view them all. Otherwise, they may as well create another site for their guild.

I'm not entirely sure I've correctly understood what you're saying, but I'll just clarify what I mean anyhow;

Say you have two clans on your forum, Clan A, and Clan B. You want to give those clans access to different private forums, "Clan A's Forum" - viewable only to Clan A members, and "Clan B's Forum" - viewable only to Clan B members. You also want the leaders of each clan to have extra permissions, such as increased PMs, max upload sizes etc. In addition to this, each clan has a different "tag", or user name mark-up. To do this you set up four user groups, Clan A Leaders, Clan A Members, Clan B Leaders, Clan B Members.

Now, as far as I'm aware, the only way to achieve such a result is by using different user groups. If that is correct, then most multi-clan/guild forums will require, and already have, pre-defined user groups they want to appear on the roster(s), but they won't be utilised if permissions are done via a profile field. To get it to work via a profile field, an admin would also have to set up a profile field for the options of all clan/guilds and ranks and manually (if profile field is private) set all users to their correct clan/rank?

Like I said, I'm not sure that's what your suggesting, but if it is then that's my concern with profile fields.

[Sarcoth]

I'm not entirely sure I've correctly understood what you're saying, but I'll just clarify what I mean anyhow;

Say you have two clans on your forum, Clan A, and Clan B. You want to give those clans access to different private forums, "Clan A's Forum" - viewable only to Clan A members, and "Clan B's Forum" - viewable only to Clan B members. You also want the leaders of each clan to have extra permissions, such as increased PMs, max upload sizes etc. In addition to this, each clan has a different "tag", or user name mark-up. To do this you set up four user groups, Clan A Leaders, Clan A Members, Clan B Leaders, Clan B Members.

Now, as far as I'm aware, the only way to achieve such a result is by using different user groups. If that is correct, then most multi-clan/guild forums will require, and already have, pre-defined user groups they want to appear on the roster(s), but they won't be utilised if permissions are done via a profile field. To get it to work via a profile field, an admin would also have to set up a profile field for the options of all clan/guilds and ranks and manually (if profile field is private) set all users to their correct clan/rank?

Like I said, I'm not sure that's what your suggesting, but if it is then that's my concern with profile fields.

I agree. I was working on the code for a couple hours yesterday and it actually came out that just using usergroups was definitely an easier way to go. Why add a profile to distinguish the games/guilds when almost all sites will have it defined already via usergroups.

Although, I could still get it to work using profile fields though. :) Just looks like it would be more work and more coding.

Anyhow, I also noticed a problem with my lastonline color thing that I added in my last update. It isn't changing colors! I'm surprised you didn't tell me IRISH, since you were the one that original requested it. :p I know I had it working during my testing phase so somewhere between then and my release it stopped. I'm stuck on why it doesn't work now. I'm going to try and fix that before going on with my new plans.

[IR15H]

I agree. I was working on the code for a couple hours yesterday and it actually came out that just using usergroups was definitely an easier way to go. Why add a profile to distinguish the games/guilds when almost all sites will have it defined already via usergroups.

Although, I could still get it to work using profile fields though. :) Just looks like it would be more work and more coding.

Anyhow, I also noticed a problem with my lastonline color thing that I added in my last update. It isn't changing colors! I'm surprised you didn't tell me IRISH, since you were the one that original requested it. :p I know I had it working during my testing phase so somewhere between then and my release it stopped. I'm stuck on why it doesn't work now. I'm going to try and fix that before going on with my new plans.

Good news!

As for the on-line colour thing, I haven't updated since the first version as I recently downloaded the map maker for COD4, which is consuming quite a lot of my time :erm:. I was planning to wait for another update here before committing myself to those few seconds it takes to upgrade! You're efforts aren't in vain though, as I'll definitely use it when I update ;).

[CodyMuir]

Heyy, Well, when i edited the way u told me, it gave me an error, but i got creative and named the ranks like.
a) Leader
b) ...
etc.
But now, i have 2 clan divisions going for 2 different games.
I want my starcraft ranks, to display ONLY starcraft members etc.

But, i have remade the roster to guildwars
edited the files, got the ranks to look like what i want it to etc, made roster_header1..
Everything is set up, but the only problem is, that it still displays the starcraft members on my guildwars tab.
Is there a way, where i can make it show ONLY certain udergroup ids. Like Leader, Member, Officer ONLY, no other ranks like all the sc ranks we have.

[Unshra]

Is there anyway to have the roster sort by 'usergroupid' but have the 'title' displayed? When I follow the optional install for sorting by usergroupid it sorts correctly but the group titles are replaced by the groupid number on the roster or is there something I am doing wrong?

[Brian30fl]

hmmm he must be busy no replys :(

[masonox]

Looks like a great mod, I run a multi gaming guild so I can't wait for these parts to be implemented. Keep up the great work! Glad to see something that is game related but not specifically WoW related.

/bows

FUTURE VERSIONS
Researching a way to move the permissions to the vBulletin Options area.
Researching a way to have multiple rosters from a single installation.

[Spank]

This might be just what I'm looking for. I'll fiddle with it during the week *tags*

[fitaholic]

I run a fitness site and would really love for this to show:

Fitaholic Trainers - (user group=admins)

Runners - (profile field=fieldX)
Cyclists - (profile field=fieldX)
Weight Lifters - (profile field=fieldX)
Swimmers - (profile field=fieldX)
Exerciser - (profile field=fieldX)

*So the (user group=member) would chose from a dropdown menu which activity defines them best and they would show up in the Member List under that title!

Can this be done and if so how...... THIS COULD BE and excellent MOD.

[Spank]

Hi I've just installed and need a little help. I need to not sort by usergroup, just to group all of the members together. also I have a calculation setup to work out the value of field6 'divided by' 7 'multiply by' 100 which I have as $percentage. How do I get this to display in the roster? I've tried just typing in $percentage but nothing is being displayed.

Once I can get those things sorted it will work exactly how I want.

[Warion]

How would I go about setting this mod up for people who wish to add their alt characters to the roster?

Any help would be appreciated.

[Dagothar]

How would I go about setting this mod up for people who wish to add their alt characters to the roster?

Any help would be appreciated.

Easy. We do that. Merely create a User Profile Field in your ACP for each alt you wish to show on the Showroster, and set showroster to show that field.

Enjoy!

[Warion]

yea if I only wanted the names of the alts, but I want it to be a way for a person can click on a button named "Add Alt" this would allow a person to add anywhere from 1 to 10 alternate characters. For each alt to show all the fields that are in the roster

[Dagothar]

yea if I only wanted the names of the alts, but I want it to be a way for a person can click on a button named "Add Alt" this would allow a person to add anywhere from 1 to 10 alternate characters. For each alt to show all the fields that are in the roster

Aha. Well, that's definitely more complicated, and also definitely not in my expertise. GL!:)

[Sarcoth]

I've been working on a few things lately and looking over this mod when I get the time. I'm not as awesome a coder as some of the other Coder/Designers around here, but I do try to give my mod some attention when able. :)

Anyhow, I will try to answer some questions. Please make sure you click installed if you want assistance. If I don't see installed, I will assume you are no longer using this mod and skip your question.

yea if I only wanted the names of the alts, but I want it to be a way for a person can click on a button named "Add Alt" this would allow a person to add anywhere from 1 to 10 alternate characters. For each alt to show all the fields that are in the roster

That is going to be rather complicated. This mod has been designed around one entry per user. I suppose a new table could be added that links to the userid and then have everything feed off of that, but we are talking about a lot of work there. I still want to make the multi-roster work before I consider looking into something like this. I'll let you know.


Hi I've just installed and need a little help. I need to not sort by usergroup, just to group all of the members together. also I have a calculation setup to work out the value of field6 'divided by' 7 'multiply by' 100 which I have as $percentage. How do I get this to display in the roster? I've tried just typing in $percentage but nothing is being displayed.

Once I can get those things sorted it will work exactly how I want.

That should be easy enough to figure out. Can you give me a link to your roster page? Make sure guests can view it please. I most likely will need you to PM me copies of your showroster.php and any templates you have made changes to.


Is there anyway to have the roster sort by 'usergroupid' but have the 'title' displayed? When I follow the optional install for sorting by usergroupid it sorts correctly but the group titles are replaced by the groupid number on the roster or is there something I am doing wrong?

Do you still need help with this? The answer is yes. You need to set up a case or if statement that applies a value to something depending on the usergroupid. I'll go into more detail if you post a reply here. :)

[Spank]

My roster is at http://www.empyron.com/forums/showroster.php

I'll pm you the files if you need them

The calculation I have is a plugin at postbit_display_start, if that means anything =D

[Warion]

Any help would be appreciated. I know I am asking alot, but I think this would be something not only I woudl use but others as well. I am also interested in mulit-guild roster too. One question I have on the multi-guild roster would be would each guild have its own primary roster or would it be listed all on one.

[gundrik]

Just installed it and I'm loving it so far. I am having a problem though when adding new user profile fields. Whenever I submit the new information in the "Edit Details" page I get an error that says, "You have entered an invalid birthday."

I sent you a PM with more details. Thanks for all the hard work Sarcoth. =)

SOLVED - I had to put in my year of birth in user cp for the error to go away.

[Arjan]

Great looking mod.
Are you planning to add some features to make it more like a clan management system or will you keep it to a roster only?
A system to enable people to signup would be nice for example.

[Pauleh]

I like this roster Im in the process of installing it to my site, im wondering though is it possible to add a option to add characters that belong to members (since in most guilds almost everyone has a alt) so to display the alt level etc would be a nice feature to add.

[Warion]

Any help would be appreciated. I know I am asking alot, but I think this would be something not only I woudl use but others as well. I am also interested in mulit-guild roster too. One question I have on the multi-guild roster would be would each guild have its own primary roster or would it be listed all on one.

Also would like the ability to allow users to add alts to roster. I run a site with 4 games. I need to be able to run a roster for each game. Some user have characters in a couple of the games so users would be allowed to add alts in any of thier choice. This would be an awsome mod if someone would help here.

[fatal1980]

Great mod.

I have some ideas to improve on this mod, I don't know if they have been brought up before as I haven't read the all the responses to this mod. But I'm just going to give you my ideas, take them or leave them I just want to share them.

The one way I see this working out as a great mod is by centering everything around creating rosters. You could create as many rosters as you like.

The options when creating the roster would be, name of roster, variable to call roster in template system, template to display roster (this would allow you to add all the fields you wanted and any html so you could make the roster look the way you wanted it to look) and of course sorting or manual sorting.

Once the roster is created. You can then add roster items. These items would either be an entire usergroup, specific users, or users based on a user field they have set or created as a hidden field by the administrator. The user field or specific users could be used to list administrators of specific game server. You could create usergroups instead, however who wants 5 usergroups just for a mod, it wouldn't be clean.

Furthermore, you may want user field roster items to be generated one creation and saved in the db. Calling a SELECT * on the user db for a specific field everytime someone loads the roster page would be time consuming on big boards. New users with new field items, well you could create a cron to do a daily update, or provide a link to re-generate the lists.

The last options would be sorting of the items within the roster, depending you may want founders first, then a specific group..etc. This is something that is huge.

I may be doing this for a site that I run at the moment, would it be possible for me to build on your mod? Or at least use bits and pieces giving you full credit for your work?

Cheers, and thanks again for a great mod.

[Warion]

That is an awsome idea. Do you think you would be able to do this yourself with the mod in hand. I have attempted to contact the coders here several times. Actually I'm a member of the vangaurds forums but yet to get a response from them. It is like the coders gave up on this mod. It has great potential.

[Kurgan]

Is there anyway to have the roster sort by 'usergroupid' but have the 'title' displayed? When I follow the optional install for sorting by usergroupid it sorts correctly but the group titles are replaced by the groupid number on the roster or is there something I am doing wrong?

Easy fix for this:

Change this line of code in showroster.php

if ($groupsort == '') { $groupsort = 'title'; }

to

if ($groupsort == '') { $groupsort = 'usergroupid'; }

as described in optional.txt

Then, edit the showroster_header template, and find this text:

<if condition="($groupsort == 'username')"><td class="tcat" colspan="12">Usernames &nbsp; ($usercount)</td>
<else /><td class="tcat" colspan="12">$user[$groupsort] &nbsp; ($usercount)</td></if>

and replace it with:

<if condition="($groupsort == 'username')">
<td class="tcat" colspan="12">Usernames &nbsp; ($usercount)</td>
</if>
<if condition="($groupsort == 'usergroupid')">
<td class="tcat" colspan="12">$user[title] &nbsp; ($usercount)</td>
<else />
<td class="tcat" colspan="12">$user[$groupsort] &nbsp; ($usercount)</td>
</if>

[Warion]

1. Has anyone figured out how to set this up to allow users to add multiple characters to the roster.

2. I am also interested in using this for multi game rosters all on same database.

I have searched and waited so long, i grow dim with hope. Someone has to know how to do this. I have attempted to contact mod creator but they arent respondinf to emails, IM's. Heck, I bough Vanguard just so I could talk to the coder but they havent been in game for awhile according to the people on their website and in game.

Anyone, anywhere, someone, somewhere.... help.

[Trek]

1. Has anyone figured out how to set this up to allow users to add multiple characters to the roster.

2. I am also interested in using this for multi game rosters all on same database.

This is pretty much what I'm looking for as well, multiple toons per user and multiple rosters.

[Sarcoth]

Hey everyone. I'm sorry I've been away so long. I started going back to school this semester and then on top of it all, my wife and I found a baby to adopt. All our time has been put towards the adoption and I haven't really had much of a chance at anything else. We are hoping to bring our baby girl home in the next couple weeks though. After that, I'll still be busy for awhile. But, as soon as things settle down I'll try to get back to work on updating this mod.

I'll try to reply to some of your questions over the next couple weeks. Please bare with me.

[IR15H]

Hey everyone. I'm sorry I've been away so long. I started going back to school this semester and then on top of it all, my wife and I found a baby to adopt. All our time has been put towards the adoption and I haven't really had much of a chance at anything else. We are hoping to bring our baby girl home in the next couple weeks though. After that, I'll still be busy for awhile. But, as soon as things settle down I'll try to get back to work on updating this mod.

I'll try to reply to some of your questions over the next couple weeks. Please bare with me.

No worries. Thanks for the info and good luck with things!

[stalkertj]

I love this mod... just what I needed... couple of questions.

I have a couple different "styles (color schemes)" on my forum, the showroster mod is using the default one, but I of course don't want it to use that one. How do I make it use a different style?

Second, I'd like to make a clickable X-fire image link in one of the columns, that when you click it, it will interact with X-fire and automatically add the user. (Using the xfire:add_user... )

Any help, or any direction you can give I'd appreciate it. Thanks!

[IR15H]

I love this mod... just what I needed... couple of questions.

I have a couple different "styles (color schemes)" on my forum, the showroster mod is using the default one, but I of course don't want it to use that one. How do I make it use a different style?

Second, I'd like to make a clickable X-fire image link in one of the columns, that when you click it, it will interact with X-fire and automatically add the user. (Using the xfire:add_user... )

Any help, or any direction you can give I'd appreciate it. Thanks!

The roster should display in whatever style you are viewing the forum in.

In regards to the x-fire thing, assuming you already have a profile field for users to enter their x-fire and a column to place it on the roster, the code you want is;

<a href="xfire:add_friend?user=$user[fieldX]"><img src="http://miniprofile.xfire.com/bg/sh/type/3/$user[fieldX].png" border="0" alt="$user[fieldX]" /></a>

Replace "X" with the profiled field you are using, which will make it look like this (http://www.gamingperfection.com/forum/showroster.php). You can change the x-fire image, if you wish, by using the relevant code found on xfire's miniprofile page (http://www.xfire.com/miniprofile/).

[stalkertj]

The xfire thing worked great, thanks!

However, I just finished up editing the navbar to show my Roster page instead of the Memberslist on the top... when I click that through the style I want it on, it goes back to the default style instead of the gaming style I have. Is there a way to force it? Or something else I can try?

[IR15H]

The xfire thing worked great, thanks!

However, I just finished up editing the navbar to show my Roster page instead of the Memberslist on the top... when I click that through the style I want it on, it goes back to the default style instead of the gaming style I have. Is there a way to force it? Or something else I can try?

Are you able to change style once the roster has already loaded? Check to see if you've accidentally put styling information in the link to the roster; /blahblah/showroster.php?styleid=XX. If you have, then that'll be why it reverts to a different style to the one you're using. You can either remove that style info (so it displays in the same style the user is browsing in), or you can change the id to your gaming style, to force all users to view it in that style. If you haven't put style information in the link then I'd suggest reverting your showroster templates and seeing if that works, as there's nothing inherent in the mod to make it force to one style.

[stalkertj]

No, nothing is telling it to use a style, and yes I can switch styles once I'm on that page.

I'll force it to use the style I want by using that styleid in the link...

Thanks!

[bluesoul]

Hey everyone. I'm sorry I've been away so long. I started going back to school this semester and then on top of it all, my wife and I found a baby to adopt. All our time has been put towards the adoption and I haven't really had much of a chance at anything else. We are hoping to bring our baby girl home in the next couple weeks though. After that, I'll still be busy for awhile. But, as soon as things settle down I'll try to get back to work on updating this mod.

I'll try to reply to some of your questions over the next couple weeks. Please bare with me.

I assume that in the meantime there's absolutely no problem with using multiple php files for multiple communities, correct? While something that uses a query string might be a bit more elegant I can grin and bear it without too much trouble.

This looks like a really nice addon, I look forward to giving it a try.

[Murex]

So there is no one that posted a way to only add certain groups in a certain order yet?

IE: groupid 10,6,20,18,14,21

[stalkertj]

Not sure about that, but I just created new groups and then applied that group to the users I wanted... of course did the groups in what order I wanted them to appear.

[ddwgoose]

ok i have installed this mod but i cant seem to find it and have it appear on my website not sure what i missed.

[stalkertj]

Can you find it by going to the www.yoursite.com/forum/showroster.php ??


For me there was a lot of customization to do by hand, but once it was done the result is awesome.

[bryanb]

Is this working on 3.8? Please let me know - thanks!

[stalkertj]

Is this working on 3.8? Please let me know - thanks!

Yes it is.

[Gleedo]

Should a link to this roster page get added to the navbar automaticaly? I just installed on my test site, and no link was added?

EDIT: I have set my usergroup to Access and Viewable yes before anyone asks lol

Also found another issue i think. Some of our members had avatar style images for the profilepic field. I have gone through changing those profilepic images to their actual photos as we want those showing on the showroster.php page. Upon refreshing showroster.php, the old avatar style images are still showing.

If i view their profiles, the photo images I changed them to, show correctly? So I dont know why showroster.php does not show the updated profilepic images.....

Member profiles that had NO profilepic before I updated them, are showing correctly in showroster.php.

Any help appreciated :)

[XFSImperial]

Just installed this mod and was curious if I could have an option to sort the roster by Last Online date?

Edit: Nevermind, found the line of code in the file & edited it.

[Dagothar]

Greetings!

I have xfsimperial's question, but haven't found the correct line, evidently. :erm:

I need to sort by the Last Online, and followed the instructions in your optional.txt.

All fields sort fine except lastonline. I tried to sort by fieldname groupsort=lastonline (and groupsort=last_online), but I get a strict a alphabetic sort of username.

My SHOWROSTER is attached... what'm I doin' wrong?? :confused:

Thanks! :D

[betts02]

ok we have this installed on our site but the lad who installs eveything on our site asked to to say :
"Checking the roster out I have noticed that the "On Trial" section is not being controlled by the set default sizes I have put on the <td> tags in the showroster_header & showroster_userbits <td> in terms of content it works fine, but size constraints I have edited into the td tags it hasnt picked up on the code and refuses to budge."

any ides what to do would be greatfull.cheers

[WavMixer]

Thank you for making this mod available to us. I have installed it and it is working as it is supposed to. Is there a way to add paid subscription information? I would like to display when they paid and when their subscription expires.

[yotsume]

Can you please post screen shots and a demo please.

THANKS!

[cbiweb]

This is a great mod. :D But when I add the following code to the showroster_userbits template, it doesn't work.
<if condition="$show['imicons'] AND exec_switch_bg()"><td class="$bgclass">$userinfo[icqicon] $userinfo[aimicon] $userinfo[msnicon] $userinfo[yahooicon] $userinfo[skypeicon]</td></if>
Any suggestions?

[grey_goose]

So this will only do one character per user unless you do seperate rosters?

[CypherSTL]

So there is no one that posted a way to only add certain groups in a certain order yet?

IE: groupid 10,6,20,18,14,21
I am also trying to figure this out. Anyone have any luck?

[Dragonsys]

Any plans on updating this for VB4?

Currently with VB4 I get this:


Warning: fetch_template() calls should be replaced by the vB_Template class in [path]/includes/functions.php on line 3895

Parse error: syntax error, unexpected T_STRING in showroster.php(229) : eval()'d code on line 1

[Sarcoth]

I've been migrating my forum to VB4 for the last week. I'm saving the Roster mod for last because it is mostly just an addon. As soon as my site is fully functionable, I'll work on the Roster mod. Give me a few weeks though. Thanks. :)

[Sarcoth]

So this will only do one character per user unless you do seperate rosters?

Sorry to say, but that is correct. I spent a lot of time trying to find a way to do more, but failed.

So there is no one that posted a way to only add certain groups in a certain order yet?

IE: groupid 10,6,20,18,14,21

I am also trying to figure this out. Anyone have any luck?

There isn't an easy way to do it. But, there are alternatives. For instance, I renamed my usergroups to stuff like Guild Leader, Guild Officer, h-Class Leader, i-Enlistment Officer, j-Guardian, and Recruit. That is only the usergroup name though. I then worked out some code to look at the usergroup name for alphabetical order, but later in the code it uses the title of the usergroup instead of the name. Only the admins have to see the name.

P.S. I need to get back into the habit of only replying to those that clicked installed.

[paratek]

I too am patiently waiting for a VB4 upgrade in this product.

[Sarcoth]

I too am patiently waiting for a VB4 upgrade in this product.

Funny you mention that. I am hoping to have it released this or next week. I have the code working, but I want to adjust a few more things.

[Sarcoth]

Upgrade for vB4.0 is posted here. Sorry, but I no longer support the older versions.

https://vborg.vbsupport.ru/showthread.php?t=235326

[drainpan]

is it just me orwhat?

I can't for the life of me figure out how to be able to fill out the info that the thing wants to display. There is nothing in my usercp that shows where to fill out the character name, race etc.... anyone can help me?

Thank you in advance

[silverfox_uw]

I'm using this mod and am finding it very usefull. One thing though, I'm wondering if its possible to incorperate members Xbox Live Avatars into it, so when they register and in put their Gamertags, their Avatar will automatically show up on the roster when they are changed into the corresponding usergroup. Any ideas?

[SpeedyHire]

nice work fella:)
We are using it for our BC2 clan roster, it works well with a fee minor changes.

thank you for the hard work

[nando99]

i know this isn't really supported but I have no idea what to do. the mod it self works fine. i have it sorted by groupid but when i have it sorted by groupid the group headers are the actual groupids (numbers) and not the group names/titles... i want it sorted by groups but still have the group names as headers... is that possible? anyone know how i can do that?

[rowedf]

Does anyone know how to create a printer friendly version of this page? We use it for a contacts page and it would be nice to print out.

[mIRCenery]

Is there any way to modify this to only display members in a group that are also marked as "active" by the vbulletin settings?

[Abizaga]

Edit: Nevermind, I fixed it. Nice work! :D

[haggles]

Has anyone worked out how to get Multiple fields working in this mod?

I have a User Profile Field created using Multiple-Selection Checkbox and it outputs the info as a number. The number shown is the addition of each lines value with the value of line one being 1 and doubling for each line after that ( ie 1,2,4,8,16,32)

So if i have selected Line 1,2,5 the output is 35.

Any help getting it to show the actual text i have put in for each line would be appreciated.

[killah360z]

<a href="http://2d-gaming.com/showroster.php" target="_blank">http://2d-gaming.com/showroster.php</a>

i cant get anyone on my roster :/