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]

Originally Posted by k10i

In it that and the problem - me is not necessary registration date in a roaster. It is necessary for me, that date of last visiting of a forum was in the field deduced

If try {vb:raw userinfo.datejoined} registration date is deduced normally.

I see what you were asking now. You want to have Last Visit displayed. Use the following:

{vb:raw userinfo.lastactive}

I have it in the next version already.

[Sarcoth]

Originally Posted by Front Range 4x4

Nice job Sarcoth! Installed, any tips on getting the users avatars to display?

I have the Profile Pics and Avatars now working, but there was a lot of code changes to the php file involved. Rather than give a walk through on how to do it all, I'd rather wait until the new version is released. There are still a lot of things I'd like to update, but I may release it tonight or tomorrow. If not, Friday will be the target release day. Why not Wed or Thurs? I have a couple tests those days and I will be busy studying and taking tests.

[Front Range 4x4]

I think everyone would rather wait until you're ready to release the update. Thanks for your effort.

[CoZmicShReddeR]

I think what your doing is totally awesome!

I tried this update for some reason nothing is working with the styles...

But then I might have goofed something... I do have profile fields that have the same numbers. Will look into it more later today...

[Sarcoth]

@ Cozmic - That's the first time I've heard of it not working. Let me know if you continue to have issues and let me know what you've done. Double check my instructions too.

[CoZmicShReddeR]

Template in the database from Show Roster 4.00 didn't uninstall had to use phpmyadmin and remove it...

There was other information that that didn't uninstall from 4.00 had to remove from database as well...

I think it was a glitch from the older version with the group permissions not being uninstalled...

Found a blank permissions row in user groups add group showroster in admincp
under it was the show roster permissions

After I wiped everything from the database I cleared the catche and reinstalled worked beautiful!

Great job on this your surely headed in a great direction!:up:

[k10i]

Originally Posted by Sarcoth

I see what you were asking now. You want to have Last Visit displayed. Use the following:

{vb:raw userinfo.lastactive}

I have it in the next version already.

thx, all work )

[Sarcoth]

Originally Posted by CoZmicShReddeR

Template in the database from Show Roster 4.00 didn't uninstall had to use phpmyadmin and remove it...

There was other information that that didn't uninstall from 4.00 had to remove from database as well...

I think it was a glitch from the older version with the group permissions not being uninstalled...

Found a blank permissions row in user groups add group showroster in admincp
under it was the show roster permissions

After I wiped everything from the database I cleared the catche and reinstalled worked beautiful!

Great job on this your surely headed in a great direction!:up:

Ahhh, did you try to revert the template (That's in Step 0)? That's the way to remove your edited templates without having to go into the DB. I'm glad you got it working though.

Originally Posted by k10i

thx, all work )

NP.

[Sarcoth]

4.0.2 has been released. Let me know if you encounter any problems upgrading.

If you are upgrading from 4.0.0, you need to uninstall everything first and revert your templates if you made changes. Remember to back everything up first (templates & php file). Upload the new files (php and bitfield.xml) and install the product.xml.

If you are upgrading from 4.0.1, you probably don't need to uninstall everything. Backup your templates if you made changes though. Upload the new php file; no changes to the bitfield file.

There are a lot of settings that you can change in the ShowRoster Settings so enjoy. Remember to adjust the Usergroup setting so the correct usergroups can view the roster. I forgot to add permissions for the Roster tab AGAIN so I'll try to add that next time. Basically, all usergroups can see the tab, but only the usergroups you add can see the page. I'm going to try to also give you more ability to control where the tab is displayed in the next version. Eventually, I also want to control the sorting from the mini menu where you see Default Sort, but I'm still not quite sure on how I'm going to do that yet.

I have a lot of things I'd like to do, so I'll continue upgrading this as time permits. I'll get back to work on upgrades Friday. I have a test tomorrow though so back to studying. Feel free to ask questions and I'll answer them the best I can.

Oh, and the PHP file is a little dirty. I haven't removed unneeded code this version because I want to make sure everything is working fine before I start removing things. I put // in front of those items so it won't hurt or slow down anything.

[Sarcoth]

I had a major breakthrough yesterday; the displaygroups option finally works which will allow you to avoid editing each usergroup. The install now allows you to make all setting adjustments from the ShowRoster Settings page.

Since it is only one update, I'm not going to release a package for it yet, but if you are interested, I'll attach a sneak preview of the two files here. If you use these, please remember to delete the bitfield_showroster.xml file in the includes/xml directory (it is no longer needed). You'll also have to do an uninstall this time around to remove the showrosteraddpermissions column in your usergroup table.

Please forgive the code mess in the php file. I usually don't clean up things until it is ready for full release.

Enjoy!

EDIT: xml removed and added back 2 posts down.