Back to vBulletin 3.5 Add-ons

Yet Another Awards System 3.5 v2.1.2
Mod Version: 2.1.2, by mtha

This modification is in the archives.
vB Version: 3.5.1 Rating: (14 votes - 5.00 average) Installs: 583
Released: 22 Aug 2005 Last Update: 12 May 2006 Downloads: 2842
Not Supported DB Changes Uses Plugins Template Edits Additional Files  

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: Yet Another Awards System 3.5 v2.1.2

For vBulletin 3.0.x, please check the other version:
Yet Another Awards System [1.2.1]

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','awards_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) (

Spoiler (click to open)


The new files are working properly. Thanks, mtha!

Also, I have edited the Award Request template quite a bit and thought I'd share it with everyone who wants it:

Code:
$stylevar[htmldoctype]
<html id="form" dir="$stylevar[textdirection]" lang="$stylevar[languagecode]">
<head>
<title>$vboptions[bbtitle] - $formtitle</title>
$headinclude
</head>
<body>
$header
$navbar
<form enctype="multipart/form-data" method="post" action="$phpfilename">
<input type="hidden" value="$userid" name="userid">
<input type="hidden" value="submit" name="action">
<input type="hidden" value="$award[award_id]" name="award_id">
<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
<tr>
	<td class="tcat" colspan="3">
		Request for $award[award_name] (id: $award[award_id])
	</td>
</tr>
<tr>
	<td class="panelsurround" align="center">
	<div class="panel">
		<div style="width:$stylevar[formwidth_usercp]" align="$stylevar[left]">
			<fieldset class="fieldset" style="margin:0px">
				<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0">
				<tr>
					<td>$formpurpose</td>
				</tr>
				</table>
			</fieldset>
			<br><div align="center"><img src="$award[award_img_url]"></div><br>
			<fieldset class="fieldset">
				<legend>Description</legend>
				<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0" width="100%">
				<tr>
					<td>$award[award_desc]</td>
				</tr>
				</table>
			</fieldset>
		</div>
	</div>
	</td>
</tr>
</table>
<br>
<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
<tr>
	<td class="tcat" colspan="3">
		$formtitle
	</td>
</tr>
<tr>
	<td class="panelsurround" align="center">
	<div class="panel">
		<div style="width:$stylevar[formwidth_usercp]" align="$stylevar[left]">
			<fieldset class="fieldset">
				<legend>Username</legend>
				<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0" width="100%">
				<tr>
					<td><b>$bbuserinfo[username]</b></td>
				</tr>
				</table>
			</fieldset>
			<fieldset class="fieldset">
				<legend>$question1</legend>
				<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0" width="100%">
				<tr>
					<td></td>
				</tr>
				<tr>
					<td><input type="text" class="bginput" size="30" name="answer1"></td>
				</tr>
				</table>
			</fieldset>
			<fieldset class="fieldset">
				<legend>$question2</legend>
				<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0" width="100%">
				<tr>
					<td><input type="text" class="bginput" size="30" name="answer2"></td>
				</tr>
				</table>
			</fieldset>
			<fieldset class="fieldset">
				<legend>$longquestion1</legend>
				<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0" width="100%">
				<tr>
					<td>$longexplain1</td>
				</tr>
				<tr>
					<td><textarea rows="5" cols="50" name="longanswer1"></textarea></td>
				</tr>
				</table>
			</fieldset>
		</div>
	</div>
	</td>
</tr>
<tr>
	<td class="panelsurround" align="center">
	<div style="margin-top:$stylevar[cellpadding]px">
		<input type="submit" name="submit" class="button" value="Submit Request" accesskey="s" />
		<input type="reset" name="reset" class="button" value="$vbphrase[reset_fields]" accesskey="r" />
	</div>
	</td>
</tr>
</table>
</td>
</tr>
</table>
</form>
$footer
</body>
</html>
NOTE: The attachment is in my unique style, but it was edited based on the UserCP templates, so it should look like that in any template. Let me know if this is any use to anyone.

EDIT: Where would I go to change the title of the thread, e-mail or PM that is created when a request is submitted?

EDIT 2: Nevemind the first EDIT as I figured out where in the file to change some things to make the title of the thread different.
Attached Images
File Type: jpg Image8.jpg (87.6 KB, 94 views)

Close
)
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

Spoiler (click to open)


I recently converted a phpBB forum to vBulletin and at the same time migrated members' medals from phpBB's http://www.phpbb.com/phpBB/viewtopic.php?t=148362 to YAAS v2.0.5. As the SQL table schemas for both award mods are very similar, this was fairly painless and can be accomplished through executing a few simple SQL statements. What follows is a quick how-to which hopefully will be useful for others looking to avoid manually importing the medals

First off, it is presupposed that you've imported your phpBB forum's data to vB using Jelsoft's ImpEx, that the import session is still active (that is, the importuserid field needs to exist in vB's user table) and that you've installed YAAS. Additionally, the queries are written for a situation where phpBB and vB share the same database, phpBB with the table prefix phpbb_ and vB without a table prefix; adjust to your specific setup where necessary.

The SQL queries can be executed from vB's admin panel (if you have the permissions), phpMyAdmin or the MySQL command-line client. (Needless to say, if you don't know understand what the SQL statements do, or are unable to adapt them to your specific situation, don't execute them!)

To begin, the following SQL statement will convert all medals from phpBB to YAAS, preserving the same row identifiers (which means you may get clashes unless you first delete the included example award in YAAS):

INSERT INTO award SELECT medal_id AS award_id, -1 AS award_cat_id, medal_name AS award_name, medal_description AS award_desc, medal_image AS award_icon_url, medal_image AS award_img_url, 1 AS award_icon_url FROM phpbb_medal;
Note that the awards are imported as un-categorized; you will need to manually assign them to an award category in YAAS's admin panel before they'll show up in vB's front end.

Next, you need to copy all the medal/award images from phpBB's medals/ directory to the images/medals/ directory under your vB installation. The image paths also need to be corrected in the database, which can be done with the following two SQL statements (replace the URL http://www.yourforumsite.com/forum/ with your vB forum's base URL):

UPDATE award SET award_icon_url = CONCAT('http://www.yourforumsite.com/forum/images/', award_icon_url);
UPDATE award SET award_img_url = CONCAT('http://www.yourforumsite.com/forum/images/', award_img_url);
Finally, the following SQL statement will import all issued awards to YAAS, mapping from the phpBB user to the correct vB member through the aforementioned importuserid field:

INSERT INTO award_user SELECT m.issue_id, m.medal_id AS award_id, u.userid AS userid, m.issue_reason, m.issue_time FROM phpbb_medal_user m LEFT JOIN user u ON m.user_id = u.importuserid;
That's all, folks Though I migrated from the Medal System Mod v2.1.0, the instructions will likely work for newer versions as well (and could be enhanced to import award categories as well, which were introduced in the Medal System Mod v2.2.0).

Close


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 http://index.php?t=61108, which I write new code based on his.
- Mac ycl6 for http://www.phpbb.com/phpBB/viewtopic.php?t=148362 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:

Spoiler (click to open)


Hack Version: 2.0.0.050822
Compatible vB version: 3.5.0
Support: Yet Another Awards System 3.5 v2.1.2

Installation:

Step 1: Unzip the files to a directory on your computer.

Step 2: Upload the files to your forums directory.
Directory structure:
{ROOT}/awards.php
{ROOT}/award_request.php

{ROOT}/admincp/award.php
{ROOT}/admincp/award_cat.php

{ROOT}/includes/settings.request_award.php
{ROOT}/includes/xml/cpnav_awards.xml

{ROOT}/images/medals/*

Step 3: Import the YAAS Product into your plugin system
- Go to AdminCP/Plugin System/Manage Products/[Add/Import Product]
- Select the file: product-yet_another_award_system.xml
- Click Import

The installer will create new tables for awards, add new phrases, and templates to your database.

Step 4. Edit templates. Read instruction in /docs/awards_install_template.html

Step 5 (optional): If you use Award Request function, configure
{ROOT}/includes/settings.request_award.php and re-upload the file. Read the file for detail instruction.

Step 6: Enjoy your new hack, give me feedback, and click install.
Attached Images
File Type: jpg ACP_award_menu.jpg (7.0 KB, 736 views)
File Type: jpg ACP_award_cat_manager.jpg (38.1 KB, 977 views)
File Type: jpg ACP_award_cat_edit.jpg (17.9 KB, 597 views)
File Type: jpg ACP_award_settings.jpg (52.3 KB, 1081 views)
File Type: jpg ACP_award_manager.jpg (93.8 KB, 1682 views)
File Type: jpg ACP_award_edit.jpg (23.9 KB, 794 views)
File Type: jpg ACP_manage_award.jpg (44.2 KB, 1467 views)
File Type: jpg FP_award_list.jpg (68.4 KB, 1519 views)
File Type: jpg FP_award_profile.jpg (64.3 KB, 1467 views)
File Type: jpg FP_award_request_form.jpg (56.9 KB, 1402 views)

Close


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/showthread.php?p=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.
https://www.paypal.com/xclick/business=mtha%40ou.edu&no_shipping=1&cn=vBulletin.org+Username&tax=0&currency_code=USD&item_name=YetAnotherAwardsSystem%20Donation

SERVICE:
Installation service is available upon request

Download

This modification is archived and cannot be downloaded.

Addons

Screenshots

   

Similar Mods

Major Additions Yet Another Awards System 2.1.4 vBulletin 3.6 Add-ons

vblts.ru supports vBulletin®, 2022-2024