Yet Another Awards System 3.5 v2.1.2

Yet Another Award System 2.1.2 ? by HacNho
Copyright (C) 2005 by HacNho, All rights reserved.

Hack Version: 2.1.2.051128
Compatible vB version: 3.5.x
Support: https://vborg.vbsupport.ru/showthread.php?t=94836

For vBulletin 3.0.x, please check the other version:
https://vborg.vbsupport.ru/showthread.php?t=78934

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 ACP
- 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
- [1.2] Options to set number of awards displayed in postbit
- [1.2] Options to turn on/off showing award icon, images, award requests in awards list, awards icons in memberlist
- [2.1.0] Options to re-order awards in postbit and member's profile
>Order by issued time (newest first)
>Order by issued time (oldest first)
>Order by Award Order (ASC)
>Order by Award Order (DESC)
- [2.1.0] Option to set award in-active. Inactive awards will not be listed in award list. However, it will still be displayed in user's profile, if member has the award.
- [2.1.0] Option to set "Request Award" option for each award. (Need "Show request award column" option ON to see the request link)
- [2.1.0] Set custom usergroup permission, to set which group can request award (access request award page)
- [2.1.0] Option to limit maximum number of users for each award displayed in awards list
- [2.1.0] Change award_request options, all options are set in AdminCP, template and phrase based. Totally cumsomizable
- [2.1.0] Option to send PM to use when he receives an award.

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)
[1.2] Display limit awards in postbit, with total awards, and a link to awards showcase in member profiles.
[1.2] Award request, link to a form sending to email/PM/new thead or post (based on Dr Erwin Loh's Form hack)
[1.2] Display award on Memberlist page (by trulylowcarb)
[2.1.0] Display individual award with name of members who receive the award
[2.1.2] Collapse award categories and awards showcase

CHANGES/MODIFICATION:
(to do)
- Files to add: 6 (/awards.php, /award_request.php, /admincp/award.php, /admincp/award_cat.php, /includes/xml/postbbit_awards.xml, /includes/xml/cpnav_awards.xml)
- Templates to edit: 5 (MEMBERINFO, postbit, postbit_legacy, memberlist, memberlist_resultsbit)
(automatic)
- Tables to add: 3 (award, award_user, award_cat)
- Templates to add: 9 ('AWARDS', 'awards_awardbit','awards_awardusers_bit','awards_ bit','awards_userawards_bit','awards_category','aw ards_categorybit', 'awards_request_form', 'awards_request_formanswers')
- Phrases to add: xxx
DIFFICULTY:
Easy
Time: about 2 minutes
Installer is included (1 product XML)

HISTORY:
2005.11.28: 2.1.1 - Add check for errors before sending PMs
2005.11.27: 2.1.0 - Add functions, Change award request options
2005.11.12: 2.0.6 - remove $this->post['userid'] check in showthread
2005.11.02: 2.0.5 - fix error when display non-user's single post
2005.10.16: 2.0.4 - fix display award after quickreply
2005.10.11: 2.0.3 - fix Display award in PM and announcement, change award request template (thanks y2krazy) (https://vborg.vbsupport.ru/showpost....9&postcount=69)
2005.10.07: Allow edit issued award
2005.09.05: Version 2.0.1 bug fix
2005.08.22: Version 2.0.0 for vBulletin 3.5.0
2005.08.18: Version 1.2.12005.04.14: Version 1.2.02005.04.03: Version 1.1
2005.03.29: Version 1.0.1b
2005.03.28: Version 1.0.1
2005.03.28: Initial release

FUTURE PLAN:
- Allow comments on user's award (by Arial)
- Allow voting on user's award (by Arial)
- Allow members to resort awards themselves <trackpad/TosaInu>

<done>
x. PM (/Email) user when he/she get an award. <2.1.0>
x. Allow awards to be resorted <trackpads> <2.1.0>
x. Allow admin to choose which awards have the 'request awards' link <trackpads> <2.1.0>
x. Allow/disallow certain awards for certain usergroups <trackpads> <2.1.0>


ADD ONs
How-to for importing from phpBB's Medal System Mod
https://vborg.vbsupport.ru/showpost....&postcount=171

CREDIT:
Idea has been carried on by many people, here are some:
- Lesane for original Award hack for vB2, eventhough I've never use his hack
- AnimeWebby for Awards/ Medals/ Cards Hack [vB3], which I write new code based on his.
- Mac ycl6 for phpBB Medal System for phpBB forum
- Dr Erwin Loh for FORM TO THREAD/ FORUM/ PM/ EMAIL hack
- and all others for supports and ideas


IMPORTANT:
- BACKUP modified files and templates before making changes.
- Backup database is recommended.
- This hack is NOT compatible with AnimeWebby's Awards/Medals/CardsHack [vB3], you need to UNINSTALL his hack, before installing this one.

INSTALLATION:
Read INSTALL.txt

UPGRADE:
Reimport XML product
Upload files if neccessary (keep the configuration)

upgrade 2.1.1: Reupload files + Reimport XML product
upgrade 2.1.2: Reupload files + Reimport XML product + reEdit templates (MEMBERINFO, postbit/postbit_legacy, memberlist_resultsbit)


UNINSTALL:
Click Uninstall in Product Manager, and undo the template changes

MANUAL:
Included in zip file

SCREENSHOT:
https://vborg.vbsupport.ru/showpost....25&postcount=2

DEMO:
vB 3.5.x
<removed on owners request>

vB 3.0.x
http://www.global-army.com/forum/awards.php
http://www.global-army.com/forum/sho...=9253#post9253
http://www.global-army.com/forum/member.php?u=22#award

DONATIONS:
YAAS is free, but a donation of any amount is much appreciated.


SERVICE:
Installation service is available upon request

[mtha]

Hack Version: 2.1.0.051127

- [2.1.0] Options to re-order awards in postbit and member's profile
>Order by issued time (newest first)
>Order by issued time (oldest first)
>Order by Award Order (ASC)
>Order by Award Order (DESC)
- [2.1.0] Option to set award in-active. Inactive awards will not be listed in award list. However, it will still be displayed in user's profile, if member has the award.
- [2.1.0] Option to set "Request Award" option for each award. (Need "Show request award column" option ON to see the request link)
- [2.1.0] Set custom usergroup permission, to set which group can request award (access request award page)
- [2.1.0] Option to limit maximum number of users for each award displayed in awards list
- [2.1.0] Change award_request options, all options are set in AdminCP, template and phrase based. Totally cumsomizable
- [2.1.0] Option to send PM to use when he receives an award.

[2.1.0] Display individual award with name of members who receive the award

UPGRADE:

- Upload all files in UPLOAD folder
- Delete /includes/setting.request_award.php
- Reconfig "Award System Settings" if you need to, especially if you use Award Request feature.
- Import/Overwrite YAAS Product

[trackpads]

Originally Posted by mtha

Hack Version: 2.1.0.051127


- [2.1.0] Options to re-order awards in postbit and member's profile
>Order by issued time (newest first)
>Order by issued time (oldest first)
>Order by Award Order (ASC)
>Order by Award Order (DESC)
- [2.1.0] Option to set award in-active. Inactive awards will not be listed in award list. However, it will still be displayed in user's profile, if member has the award.
- [2.1.0] Option to set "Request Award" option for each award. (Need "Show request award column" option ON to see the request link)
- [2.1.0] Set custom usergroup permission, to set which group can request award (access request award page)
- [2.1.0] Option to limit maximum number of users for each award displayed in awards list
- [2.1.0] Change award_request options, all options are set in AdminCP, template and phrase based. Totally cumsomizable
- [2.1.0] Option to send PM to use when he receives an award.



[2.1.0] Display individual award with name of members who receive the award


UPGRADE:

- Upload all files in UPLOAD folder
- Delete /includes/setting.request_award.php
- Reconfig "Award System Settings" if you need to, especially if you use Award Request feature.
- Import/Overwrite YAAS Product

Excellent!!!!

[Oap JTRipper]

i get this error when setting the permissions to usergroups

[mtha]

Originally Posted by Oap JTRipper

i get this error when setting the permissions to usergroups

hmm, I dont get the error on my forums.

do you have error in other hack?

Try this:

Remove bitfield_awards.xml from your includes/xml folder, then go back to your usergroup permission, change some other setting, and see if you still get the error.

add the file back, rebuild bitfields, and try again with different group.




Can anyone confirm this error?

[trackpads]

Originally Posted by mtha

hmm, I dont get the error on my forums.

do you have error in other hack?

Try this:

Remove bitfield_awards.xml from your includes/xml folder, then go back to your usergroup permission, change some other setting, and see if you still get the error.

add the file back, rebuild bitfields, and try again with different group.




Can anyone confirm this error?

I got it but had to rebuild the bitfields, I had removed a different hack and it was 'lingering'. Rebuild the bitfields and you will be fine.

-Jason

[EasyTarget]

great hack thank you.

I was wondering if for future versions you could make it so you could also choose to award a usergroup a medal so that each member in that group could receive it instead of having to do it one by one? or maybe even the ability to award a medal to a usergroup instead of a user.

also combining this hack with the post award hack:
https://vborg.vbsupport.ru/showthread.php?t=92677

where you could give an award to a specific post or thread.

thanks again.

[mtha]

Version 2.1.1 - Add some checkng for errors before sending PMs (in issue awards and request award)

If you had 2.1.0 installed, you just need to replace
request_award.php and admincp/award.php
with the new files.
AND reimport XML product.

[mtha]

Originally Posted by trackpads

I got it but had to rebuild the bitfields, I had removed a different hack and it was 'lingering'. Rebuild the bitfields and you will be fine.

-Jason

with vB 3.5.1, it rebuilds bitfield automatically. If you use vB 3.5.0, please rebuild bitfield.

great hack thank you.

I was wondering if for future versions you could make it so you could also choose to award a usergroup a medal so that each member in that group could receive it instead of having to do it one by one? or maybe even the ability to award a medal to a usergroup instead of a user.

thanks again.

Interesting idea. i will think about it.

[EasyTarget]

sorry edited my post above with:

"also combining this hack with the post award hack:
https://vborg.vbsupport.ru/showthread.php?t=92677

where you could give an award to a specific post or thread.

thanks again"

and just wanted to let you know you did a nice job on the readme as well.

[mtha]

Originally Posted by EasyTarget

sorry edited my post above with:

"also combining this hack with the post award hack:
https://vborg.vbsupport.ru/showthread.php?t=92677

where you could give an award to a specific post or thread.

thanks again"

and just wanted to let you know you did a nice job on the readme as well.

the scheme is different, so it'd be easier to leave them two seperate award hack, especially when someone else already release one.