Question2Answer Badges (Extended version)
-----------
5.2.2
- Swapped JS algorithm to group badges by type, to a PHP solution.
(To reduce Javascript implementation.)
- JS code improvements.
Structural Work.
-----------
5.2
- New widget design
- Added id tags to Badges Page to serve as link anchors.
For example, now if you click in a widget badge, you get redirected and scrolled to that Badge's location in the Badges Page.
Some other Tweaks
-----------
5.0
- Badges Page: Badges source/Users who received, now is displayed in a Pop up, instead of a SlideDown toggle below the respective badge.
- Profile Page: Now Badge title show the number of Badges you've earned for each type of badge. (Ex: Bronze 33, Silver 9, Gold 3)
- Other fixes/arrangements
Screenshots.
-----------
4.9.2
Badges counter added next to titles on profile pages. Example: Bronze(6), Silver(1), Gold(3)
-----------
4.9.1
Send badge awarded events through the event system - by pvginkel.
-----------
4.9
- Badges styles fully redesigned.
- Mobile ready styles.
- Added algorithm to group Badges by "topics" on Badges page.
- Added supported styles for Right-To-Left Themes.
Fixed badges not appearing next to the User on question lists and next to the Loggedin text on the navigation bar.
-----------
Screenshots
-----------
- (New) Badge source, Pop up: Screenshot-1
- (New) Who received Badge list, Pop up: Screenshot-2
- (New) How many Badges earned per type: Screenshot-3
- Badges page: Screenshot-4
- Badges on profile page: Screenshot-5
- Badges on profile page (Right-To-Left): Screenshot-6
Badges on profile page (Mobile) : Screenshot-7
-----------
Description
-----------
This is a plugin for Question2Answer that provides basic badge functionality.
--------
Features
--------
- currently 57 badges implemented (see Badge List below)
- badges are categorized into types (e.g. gold, silver, bronze)
- badge notification system triggers jquery notice when awardee accesses the site
- option to notify users of badge awarding by email (fully customizable)
- public badge page displays awardable badges
- awarded badges may be shown in individual profile pages, with links to source (if available)
- awarded badge may be shown as medals in individual posts and on global users lists
- badge names and requirements are modifiable via admin page
- badge system may be deactivated via admin page
- badges may be individually deactivated via admin page
- logs badge awarding if event logging is enabled (integrates with history plugin)
- recent badges widget (requires event logging to database)
- full translation table available (see Translation below)
- all css fully customizable
ability to add custom badges via plugin (see Custom Badges below)
------------
Installation
#. Install Question2Answer
Get the source code for this plugin from github, either using git, or downloading directly:
To download using git, install git and then type
git clone git://github.com/NoahY/q2a-badges.git badges
at the command prompt (on Linux, Windows is a bit different)
To download directly, go to the project page and click Download
Go to Admin -> Plugins on your q2a install and select the 'Activate badges' option, then 'Save Changes'.
-----------
Translation
The translation file is qa-lang-badges.php. Copy this file to the qa-lang/<your-language>/ directory. Edit the right-hand side strings in this file with notepad2, notepad++, etc. (don't ever use Window's Notepad. For anything. Ever.), for example, changing:
'good_question'=>'Good Question',
to
'good_question'=>'Swali nzuri',
for Swahili. Don't edit the string on the left-hand side or bad things will happen.
Once you've completed the translation, don't forget to set the site language in the admin control panel... to Swahili.
-------------
Custom Badges
Custom badges may be implemented in any plugin module in a similar way as option_default. Steps are as follows:
1. create a function in your module class called custom_badges(). It should return an array of badges with the badge slugs as indexes for nested arrays with var (default requirement) and type (bronze=0,silver=1,gold=2) indexes. Here is an example from the comment-voting plugin:
::
function custom_badges() {
return array(
'nice_comment' => array('var'=>2, 'type'=>0),
'good_comment' => array('var'=>5, 'type'=>1),
'great_comment' => array('var'=>10, 'type'=>2)
);
}
2. create a function in your module class called custom_badges_rebuild() that will award badges when rebuilding via admin/plugins and return the number of badges awarded. Here is an example from the comment-voting plugin:
::
function custom_badges_rebuild() {
$awarded = 0;
$posts = qa_db_query_sub(
'SELECT userid, postid, netvotes FROM ^posts WHERE type=$ AND netvotes>0',
'C'
);
while ( ($post=qa_db_read_one_assoc($posts,true)) !== null ) {
$badges = array('nice_comment','good_comment','excellent_comment');
$awarded += count(qa_badge_award_check($badges,(int)$post['netvotes'],$post['userid'],$post['postid'],2));
}
return $awarded;
}
3. implement qa_register_plugin_phrases() via your qa-plugin.php, including two entries for each badge: badge_<slug> and badge_<slug>_desc. Here is an example from the comment-voting plugin:
::
return array(
'permit_vote_c' => 'Vote on comments',
'badge_nice_comment' => 'Nice Comment',
'badge_good_comment' => 'Good Comment',
'badge_great_comment' => 'Great Comment',
'badge_nice_comment_desc' => 'Comment received +# upvote',
'badge_good_comment_desc' => 'Comment received +# upvote',
'badge_great_comment_desc' => 'Comment received +# upvote',
);
Create your own mechanism for awarding badges - see some examples in the badges plugin code, or the bookmark plugin. Make sure to test for both qa_opt('badge_active'), which makes sure the badge plugin is active, and qa_opt('badge_custom_badges') to make sure the badge plugin version supports custom badges. Use the function qa_badge_award_check() to check for badges, where $badges is an array of badge slugs, $var is the number to test against the badges, $oid is the postid (if any), $notify = 0 for no notification, 1 for email and popup, 2 for just popup. You should probably check if this function exists as well, in case the badge plugin has been deleted while active.
----------
Disclaimer
----------
This is beta code. It is probably okay for production environments, but may not work exactly as expected. Refunds will not be given. If it breaks, you get to keep both parts.
-------
Release
-------
All code herein is Copylefted.
---------
About q2A
---------
Question2Answer is a free and open source platform for Q&A sites. For more information, visit:
http://www.question2answer.org/
----------
Badge List
Level1 Title Description
========== ================= ========================================
1 Verified Human Successfully verified email address
1 Autobiographer Filled out all profile fields
1 Photogenic Uploaded an avatar image
1 Nice Question Question received +# upvote
2 Good Question Question received +# upvote
3 Great Question Question received +# upvote
1 Notable Question Asked question received # views
2 Popular Question Asked question received # views
3 Famous Question Asked question received # views
1 Nice Answer Answer received +# upvote
2 Good Answer Answer received +# upvote
3 Great Answer Answer received +# upvote
1 Renewal Received "Nice Answer" badge in response to a question more than # days old
2 Revival Received "Good Answer" badge in response to a question more than # days old
3 Ressurection Received "Great Answer" badge in response to a question more than # days old
1 Gifted # answers selected as best answer
2 Wise # answers selected as best answer
3 Enlightened # answers selected as best answer
1 Grateful Selected # answers as best answer
2 Respectful Selected # answers as best answer
3 Reverential Selected # answers as best answer
1 Liked Received # total upvotes
2 Loved Received # total upvotes
3 Revered Received # total upvotes
1 Asker Asked # questions
2 Questioner Asked # questions
3 Inquisitor Asked # questions
1 Answerer Posted # answers
2 Lecturer Posted # answers
3 Preacher Posted # answers
1 Commenter Posted # comments
2 Commentator Posted # comments
3 Annotator Posted # comments
1 Voter Voted # times
2 Avid Voter Voted # times
3 Devoted Voter Voted # times
1 Editor Performed total of # edits
2 Copy Editor Performed total of # edits
3 Senior Editor Performed total of # edits
1 Watchdog Flagged # posts as inappropriate
2 Bloodhound Flagged # posts as inappropriate
3 Pitbull Flagged # posts as inappropriate
1 Reader Read total of # questions
2 Avid Reader Read total of # questions
3 Devoted Reader Read total of # questions
1 Dedicated Visited every day for # consecutive days
2 Devoted Visited every day for # consecutive days
3 Zealous Visited every day for # consecutive days
1 Visitor Visited site on total of # days
2 Trouper Visited site on total of # days
3 Veteran Visited site on total of # days
1 Regular First visited more than # days ago
2 Old Timer First visited more than # days ago
3 ancestor First visited more than # days ago
1 100 Club Received total of # points
2 1,000 Club Received total of # points
3 10,000 Club Received total of # points
1 Medalist Received total of # badges
2 Champion Received total of # badges
3 Olympian Received total of # badges

---

1. Level refers to difficulty level (e.g. gold, silver, bronze).↩