JUGNOON GAMIFY Solution For PHP Websites
Gamification is the concept of applying game mechanics and game design techniques to engage and motivate people to achieve their goals. Gamification taps into the basic desires and needs of the users impulses which revolve around the idea of Status and Achievement.
JUGNOON Gamify is a complete professional script with all basic and advance features that can allow you to build any level of gratification system within your website.
Script is written using angular js as front end and pure php as backened.
You can easily create gamification system like implemented by stackoverflow, freelancer.com, themeforest.com or any other big networks.
Features
Core features include
Badges
Rewards
Levels
Points
Credits
Packages
I: Badges:
Jugnoon Gamify allow site administrator to manage (add, update, delete) unlimited badges. Badges to be awarded when user achieve certain goal in website. Badges can be grouped into one or more categories.
Main attributes of badges include
Title: Badge Title
Description: Detail about badge.
Notification: Message to be sent or saved in user achivement table when user award this badge.
Category: Assign category for selected badge
Priority: For listing badges top to bottom based on priority
Is Hide: Whether to display this badge in main badge listings or will be hidden.
Is Multiple: Whether this badge to be awarded multiple times.
Icon: Badge thumb or use badge css with littlbe bit customization.
How to create badge?
Go to badge section
Click on add button
Fill form and submit add button.
In Next step choose icon for badge
Thats it, badge will appear in main badge listing.
How to award badge?
Badge can be awarded when user complete certain action in website. e.g completing public profile 100% will award ABC badge.
Steps to follow to write code for awarding ABC badge. lets support when you create ABC Badge, it’s generated with id e.g “45”
Go to badge section
Select badge ABC from listing
On right side click on “show code” link
Form will appear with instruction to copy, paste and usage.
Sample badge usage can be seen here
You can either award badge using auto generated code by example shown above or using direct core bll. Both examples shown below.
or via by using core bll
where 45 is id of badge.
II: Rewards:
Rewards are almost similar as badge but with additional attributes. Rewards can be used to unlock website features and services to selected user when unlocked. Rewards can be unlocked either by calling on certain function e.g user purchased premium membership or can be unlocked automatically by some other events e.g increase discount 1% when user reach to level 4.
Main attributes of rewards include
Title: Reward Title
Description: Detail about reward.
Notification: Message to be sent or saved in user achivement table when user award this reward.
Category: Assign category for selected reward
Priority: For listing reward top to bottom based on priority
Credits: Credits required to unlock reward. e.g buy reward by utilizing account credits.
Is Hide: Whether to display this reward in main badge listings or will be hidden.
Is Multiple: Whether this reward to be awarded multiple times.
Icon: Reward thumb or use reward css with littlbe bit customization.
How to create reward?
Go to reward section
Click on add button
Fill form and submit add button.
In Next step choose icon for badge
Thats it, reward will appear in main reward listing.
How to award reward?
Reward can be awarded when user complete certain action in website. e.g upgrade premium account will unlock ABC reward or reward can be awarded automatically e.g completing level 5 will award XYZ reward that can increase 4% discount for selected users .
Steps to follow to write code for awarding ABC badge. lets support when you create ABC Badge, it’s generated with id e.g “45”
Go to reward section
Select reward ABC from listing
On right side click on “show code” link
Form will appear with instruction to copy, paste and usage.
Sample badge usage can be seen here
You can either award badge using auto generated code by example shown above or using direct core bll. Both examples shown below.
or via by using core bll
where 45 is id of reward.
How to unlock website features by awarding reward?
When script award reward to specific user, it will call a custom function process($rewardid).. located in /include/events/process_reward_features.php
This function include cases for all rewards you generated.
Go to rewards section and on right side of Add button you will notice “Generate” button, click on it. You can see sample page here which is responsible for generating all cases for process function.
Sample code will look like this
Now you have to write custom code for each reward you want to execute when reward is awarded to user. in case case. Before adding, make sure its 100% working code and test process($rewardid, $userid) to make sure its working fine.
Levels:
Site administrator can create unlimited levels and associate unlimited rewards with each level using manage gamify application level section.
Levels can be completed when user reach to maximum points from initial points (reset after completion of level). Levels can be upgraded manually or automatically when user points exceeds maximum points required to unlock another level.
Main attributes of level include
Level: Current number of level e.g 1, 2, 3,... n (can’t be edited by site admin, its automatic)
Title: Level Title
Description: Detail about level.
Notification: Message to be sent or saved in user achievement table when user complete this level.
Category: Assign category for selected level
Priority: For listing rewards top to bottom based on priority
XP: Maximum points required to complete this level and unlock next level.
Is Hide: Whether to display this level in main level listings or will be hidden.
Icon: Level thumb or use css with little bit customization.
How to create reward?
Go to level section
Click on add button
Fill form and submit add button.
In Next step choose icon for level
That’s it, reward will appear in main reward listing.
How to associate rewards with this level?
You can associate unlimited no of rewards with each level. when level upgrade, script will automatically look for all association and unlock it by executing reward script.
When level created, go to level section
Click on associate reward link.
Click on checkbox you want to associate and click associate button.
How to complete level?
Level can be awarded manually by site administrator or automatically when user complete points.
Steps to follow to write code for completing level manually. lets suppose you want to complete level 5 with id “45”. Note when you complete user level, all level 4, 3, 2, etc will be automatically completed.
Go to level section
Select Level 5 from listing
On right side click on “show code” link
Form will appear with instruction to copy, paste and usage.
Sample level usage can be seen here
You can either complete level using auto generated code by example shown above or using direct core bll. Both examples shown below.
or via by using core bll
where 45 is the id of level.
Points:
Site administrator can create unlimited no of points event that can be trigger or call on certain events. e.g award 15 xp points when user upload video or deduct 5 xp points when user delete video.
Main attributes of points include
Title: Point Title
Description: Detail about points.
Notification: Message to be sent or saved in user achievement table when user award or deduct points associate with this event.
Category: Assign category for selected point
Priority: For listing point event top to bottom based on priority
Is Hide: Whether to display this point event in main point listings or will be hidden.
XP: XP points to be awarded to user when this point event trigger.
Is Deduct: When this point event will deduct or increment user points
Icon: Assign thumb or not required for such items
How to create point event?
Go to point section
Click on add button
Fill form and submit add button.
In Next step choose icon for badge, leave blank as its not required in points
Thats it, point event will appear in main badge listing.
How to trigger point event?
Point event can be trigger or call multiple times when certain event occurs in site. e.g you can call ABC point event to award 15 points when user upload video.
Steps to follow to write code for awarding ABC point event. lets suppose when you create ABC point event, it’s generated with id e.g “45”
Go to points section
Select points event ABC from listing
On right side click on “show code” link
Form will appear with instruction to copy, paste and usage.
Sample badge usage can be seen here
You can trigger point event using code generated by example link shown above or using direct core bll. Both examples shown below.
or via by using core bll
where 45 is id of point event.
Credits:
Credits is almost similar to xp points but instead of points in this case, user credits will be incremented or decrements on certain credit event calls. Points can be used to unlock levels whiles credits can be used to unlock rewards.
Rest is almost same
Packages:
Its optional feature which will allow site administrator to create unlimited no of packages for purchasing credits on real payment. Credits will be added to user account when user purchase specific package. Click here to check more about package information.
Events:
Its optional feature that allow site administrator to group multiple events (badge, reward, level, points, credits, package) that can be called for single event. e.g creating account and activation will award abc badge, reward xyz reward, complete level 1, reward 100 xp points, reward 50 credits. so via event management, you can create event and associate all items that should be called with this event.
When event created, go to show code, this will display code with usage instruction.
For more detail click here.
Simulate Events:
Jugnoon Gamify include additiona gamify simulation application that can provide detail of how badges awarded, reward unlocked, level completed, points rewarded or deducted, credits rewarded or deducted, buy packages etc.
For real time review check simulation demo here.
Dispaly Events:
Jugnoon Gamify include additiona gamify display events that can show you how user information, rewarded badges, rewards, credits, points, levels, packages to be displayed and user achivement history generated.
For real time review check demo here.
Technical Information:
Jugnoon Gamify application uses angular js for front end application and core php for backened processes. If you are using any php framework then make sure to adjust core bll and entity files according to framework infrastructure. e.g if you are using codeigniter, make sure you adjust /include/bll, include/entity and include/events classes in /application/services
The main backened operation involve just receiving and sending JSON data between angular js application and php.
PHP code is written very clean way here is example how it works.
Below code will add badge information in database.
Directory Structure:
Core directory includes
api : Core php handler files responsible for receiving and sending JSON data
app: Core angular js application
include: Core business layer, entity classes and event classes php script
contents: Save badges here
image: Site images here
plugin: plupload and other plugins here
css: core site css here
js: core site js here
Help & Assistance:
We build this application in a way that can be easily used in any type of php websites. Integration is easy if you are php developer still if you face problem you can send us query on our support mail or post your topic in Q&A or Forum section. We will try our best to give you response as soon as we can.