Major Additions - Yet Another Awards System

*** CREATE A BACKUP OF YOUR FORUM AND DATABASE BEFORE INSTALLING ***

DESCRIPTION:
This is a Medals/Awards system. Admin can give members awards, and award icons will be displayed in member's profile, posts, as well as in a award list.

FEATURES:
In AdminCP
- Can Create/Edit/Delete/Reorder categories/sub-categories in ACP (with category name and description)
- Can Create/Edit/Delete awards in ACP (with Award Name, Description, Icon URL, Image URL)
- Can Move one (or all) award(s) from one category to another
- Can set some awards un-classified (not displayed for public)
- Can re-order awards in awards showcase
- Issue awards to members, based on username or userid, with Issue Reason
- Remove awards from members
+ Writes granting/removing awards to the log

In ModCP
- Issue awards to members, based on username or userid, with Issue Reason
- Remove awards from members
+ Writes granting/removing award to the log

Front page
- Display awards list in with: Award Name, Description, Icon, Image, and Members who get each award.
- Display awards showcase in profile, with Award information, Issue time and reason
- Display award icons in postbit (showthread, showpost, announcement, private)

New Features/Additions since 3.8
- Points System
- Separate Award Request/Recommendation Forms
- CSS Customizable

Current Release Version 4.0.9

• Added - Handling of user merges
• Added - Handling of user deletes
• Added - Manage awards on per user basis
• Added - Extra info to the logs for mass removal and editing of issued awards
• Added - Ability to collapse categories on awards.php
• Added - Checksum file for checking for suspect file versions
• Added - Various missing phrases
• Fixed - Memberlist not showing awards when option is active
• Fixed - Navtab not being selected (vb version < 4.2)
• Fixed - Category title not being displayed on awards.php
• Fixed - Logging not working in modcp
• Fixed - A few other minor bugs

[Bouncer222]

CypherSTL or Xanlamin could you guys please answer this question I have....

This site is running 4.0.3 and I don't know if they are using YOUR awards system or some other one. http://www.feverclan.com/forums/awards.php

My question is, how did they get that type of layout on their awards page?
It got a REALLY NICE layout of names of who got which award and etc...

If it's not yours... could you make it possible to make yours look like that?
I would love it then!

Thanks.

Edit:

Can you also add the option to give awards based on how many people a user has referred to the site AND they signed up?

[Xanlamin]

If it is ours it is highly modified. And no we will not make ours look that way, personally I do not like it. You can get a hold of them and ask them if they would help you get the layout or do it yourself, but once you do your stuck with that version unless you keep doing it to each new one.

[Bouncer222]

alright,

btw what is

Criteria
Only use numbers.
Use ID for Usergroups

?

[Xanlamin]

Don't use the names, use the ID numbers instead. Pretty self explanatory.

[Bouncer222]

I'm still confused, if I am doing it for post count... what do I enter for

Criteria
Only use numbers.
Use ID for Usergroups

Is this field used for EVERYTHING or only on specific automations?

I'm guessing it's used only when giving award for usergroup change? So should I only use that field for putting in the usergroup id of the usergroup that the member gets promoted to, so when he gets promoted to that usergroup he gets the medal? Is it only on that occasion?

Sorry but its confusing.

P.S. I have an inactivity mod on my forums , if people don't check site for 7 days, they get moved to "inactive" usergroup and once they load the site, they get moved back to their original one, so does that mean the award system will give it to them again? Because that wouldn't be good....

[Xanlamin]

Enter in the number of post for postcount that you want the person to reach in order to get the award.

Thats all that needs to be entered into that field.

No the automation will not give it to someone twice, it first checks to see if they have it, if they dont then they get it, if they do then nothing.

[Bouncer222]

And if you give out medals manually it will also check if they already have it?

Thanks.

EDIT: The automation is working and I appear under the user list for each medal after promoting myself, but the PMS aren't being sent to the user.

[Xanlamin]

There are no PM's sent to the users from the automation system, only if you do the awards manually and select send pm to user.

[Bouncer222]

Could you possibly add the feature to send pm with automation please?
Otherwise users don't know they got an award.

[Sarteck]

Hey bouncer, if you wanna try your hand at adding it yourself, I often put that into my own mods (unreleased in their entirety since I'm too lazy to make it portable with other vB forums, kekeke).

Here's the code I use:

PHP Code:

    require_once(DIR . '/includes/class_dm.php');
    $pmdm =& datamanager_init('PM', $vbulletin, ERRTYPE_ARRAY);
    $pmdm->set_info('savecopy', false);
    $pmdm->set_info('receipt', false);
    $pmdm->set_info('cantrackpm', false);
    $pmdm->set_info('parentpmid', false);
    $pmdm->set_info('forward', false);
    $pmdm->set_info('bccrecipients', 0);
    $pmdm->overridequota = true;
    $pmdm->set('fromuserid', $someuserid);
    $pmdm->set('fromusername', $someusername);
    $pmdm->set('title', $title);
    $pmdm->set_recipients($recipients, $permissions, 'cc');
    $pmdm->setr('message', $message);
    $pmdm->setr('iconid', $icon);
    $pmdm->set('dateline', TIMENOW);
    $pmdm->set('showsignature', false);
    $pmdm->set('allowsmilie', 0);
    $pmid = $pmdm->save(); 


The "savecopy" and "receipt" and all that, of course, you can modify to "true" if you need to.
The "overridequota" is great because even if they have a full inbox, they'll still get the PM. :3
Setting stuff like fromuserid should be a no-brainer.
$recipients is... hrm, I think it was a semi-colon-separated list of usernames. But if you're only PMing one person, of course there would be only one name. X3

In Xan and Cyph have included a nearby hook in their script, you can just use that info in a plugin somewhere. If not, I guess you could manually edit your awards.php file. Either way, just change stuff to your liking and make sure you goot values for every variable mentioned there except for $vbulletin, $permissions, $pmdm, and $pmid. Also, if you use this inside of a function, be sure to put a global declaration for $vbulletin and $permissions. :3