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]

Wow, a full day spent on the navbar stuff. I thought I had it done yesterday, but I had to redo it again because I could not get the order setting to work. I removed the navbar code (mostly) from the php file and now it is completely done via the plugin. I renamed the template to navtab and created a new template called subnavtab to do the sorting. I had many problems getting it to work, but in the end, the subnavtab template will only show when on the showroster page (exactly what I wanted). Even if you disable the tab, you will still have access to the subnavtab sorting options. And, the order of the navtab has been completely removed from the settings and you will have to use the plugin execution order to change its order. You can still adjust the location in the ShowRoster settings though.

The subnavtab is rendered by the showroster.php file. The only problem I am having, not really sure it is a problem, but the subnavtab is rendered via a template_hook. Personally, I think it should be rendered another way, but everything I try does not work. I have no idea when the template_hook works especially since the code right after it does not do anything. It works this way though, so I guess I cannot complain; I have a headache.

I have all the above options completed except for the border (#7) and dropdown menu (#6). I think the dropdown will be easier now since I have the navtab code better designed, but I will have to put it off. No one has really asked for it anyhow and I ended up going another route with setting up my own personal navtab's for my site. If anyone is interested in the code I am using for dropdowns at my site (sacredhaven.org), let me know and I'll post my code here.

Anyhow, if I can complete the border code by tomorrow night I hope to have the update posted soon after or the following day. Barteh, I'll send you a PM soon on being the guinea pig since you volunteered.

[Sarcoth]

Alright, so I finished it sooner than I thought I would. Please let me know if you find any problems. I will start working on the small requests tomorrow.

[Mobo]

Originally Posted by Mobo

2. Is it possible to have members added to a roster based on usergroup and custom user profile field?

Originally Posted by Sarcoth

@Mobo
1) If you mean to have them sorted by a custom field, then yes and I thought that was in the setup instructions that came with the mod. Check it out and let me know if not.
2) I'm not sure what you mean on that one. Let me know what you want to do with the roster and I'll tell you if it can be done or not.

Hi Sarcoth, thanks for getting back to me. On #2, I mean is it possible to have a conditional such as AND. So, if member is in usergroup X AND has profile field Y, then add them to the roster as type Z.

Does that make it easier to understand?

[Sarcoth]

@ Mobo - Since you are asking about two things the mod already has, I am guessing you know about them. The only way they work in conjunction is by affecting all usergroups. Sadly, there is no way in the code to affect just one usergroup and the missing profilefield.

Yet, there may be a way to do it. Give me a link to your site and show me exactly what you want to do. If it takes me less than 15 minutes to think up, I'll let you know what you can do. That is the timeframe I set aside for whether it is an easy fix. Easy ones I'm willing to do.

[Mobo]

My site is Wings of War Aerodrome, not sure if it will help you much though.

Basically I have two custom profile fields that members enter their location in. I'd like to use these two fields to determine which roster the member should be added to, and then use the usergroup ID to determine where on the roster they should be added (Commander, Leadership, or normal user for example).

[Sarcoth]

Originally Posted by Mobo

Basically I have two custom profile fields that members enter their location in. I'd like to use these two fields to determine which roster the member should be added to,

It sounds like you want to put members into certain usergroups based off of what they put in their profilefields. That part lies outside the ability of the showroster mod. You'll probably need to find another mod that can do that.

Originally Posted by Mobo

and then use the usergroup ID to determine where on the roster they should be added (Commander, Leadership, or normal user for example).

This mod strictly works around usergroups and profilefields. The usergroups are what divide the users into the different groupings and the profilefields are the columns. You can prevent users from showing on the roster if they did not fill in a single profilefield, but that's the extent of it.

I may be wrong, I just woke up, but that is how it sounds to me. It definitely looks like a medium to large project though. I think I could do it, but I am only doing small fixes from now on. Sorry.

[Mobo]

No worries man, thank you for looking into it.

[Antidepresiv]

Hey Sarcoth, do you have time now to sort out that fixed width of columns ? Also, i have tried everything, but that "Show Online Status" does not work.. :/ Thank you Anti..

[tlwwolfseye]

What am I doing wrong here ?

I installed the mod, just like the instructions say. I set up the usergroups allowed to see, those to be shown and all that stuff. I added some profile fields for test to some members on the usergroup in question and filled them with infos.

Now I go to the Roster and its empty, and stays empty. What did I miss here ?

The board Version is 4.10 btw.

[Antidepresiv]

You are missing this https://vborg.vbsupport.ru/showpost....87&postcount=3