These are a documentation and answers of frequently asked questions about Gamification Platform. You will find information about configuration and the ways of using the platform.
Download and Install
I guess, you have already installed Joomla! and now you have to download Gamification Platform package.
Go to "Extension Manager" and install the package.
If you are installing the extension for the first time, you will see a list of installed libraries, plugins and modules. You will also see a list of minimum requirements. If the system displays red indicators for unfulfilled requirement, it will be good to find a way to fix it.
You must download and install ITPrism Library, because the extension needs it to work properly.
The minimum requirements to run the extension properly are:
- Joomla! v3.1.5
- PHP 5.3
- MySQL 5.1
- MooTools 1.2.x
- jQuery 1.8.x
- cURL, fopen
- Magic Quotes disabled
It is a time to configure Gamification Platform. Go to "Dashboard" and click on the button "Options." Review the settings and save them.
Now, I am going to describe you the most important options of the extension.
Those options are used for managing the images, which you will upload - badges, trophies, rewards,...
There are views that display a list with gamification things like notifications, rewards,...
You should create a menu item that will point to these things.
- Select a menu and click on the button "New"
- Select a "Menu Item Type"
- Enter "Menu Title," alias and some of the advanced options if you want.
The groups are elements, which are used for grouping the game mechanics. To describe them better, I will give you some example.
Group 1 "Levels and Ranks"
I would like to gamify user behavior. I will use points, levels and ranks.
I will give points to the user, every time, when he buys an item from my store. He will get levels and will reach ranks whenever reach the required points.
I will give specified discount to the users with higher levels and ranks.
Group 2 "Virtual Currency"
I want to give other kind of points to the users, which share the items from my store to theirs friends. The users will be able exchange this points for discounts.
The points are main game mechanic and it is one of the most-used things for controlling user behaviors. They are used to keep score and establish status or accumulated to purchase virtual or real goods.
Creating points, you have to give a name and abbreviation.
Badges (also known as achievement badges) provide recognition and feedback. They are an indicator of accomplishment or mastery of a skill is especially meaningful within a community that understands its value. Often used to identify skills and expertise within a group.
You should provide an image of a badge.
The badges can be given for reaching a certain number of points. To do that, you should enter the number of points and select points type.
The gamification platform comes with plugins, which calculate and give badges automatically. You will learn about them later in the article.
The rank of a player shows his status. Players are often motivated by trying to reach a higher rank or status.
It is a similar to badges. You should provide an image. The ranks can be gained when users reach a certain number of points.
Levels serve two important roles in gamification systems: They indicate progress and they convey status. In a gamified system, a level is effectively a rank that corresponds to the player. It’s earned through accomplishments and represents additional privileges or abilities. The change in level occurs when the user reaches a set point threshold.
There are several parameters, that you can use for the levels in your gamification strategy.
- Points - You can set number of points, which will be needed for reaching the levels.
- Value - this is a numerical value of the level, which you can display on your pages.
- Rank - you can select a rank for levels. For example: I have four ranks - Customer, Silver Customer, Gold Custom, Diamond Customer. I can create levels from 1 to 5 for everyone rank. So, the ranks will contain levels.
Notifications ( Feedback )
One game mechanic that helps to encourage engagement is feedback, or the broadcast of well-written, helpful, engaging on-screen messaging in the form of real-time notifications within the game system and/or via e-mail when users perform a desired behavior, level up, unlock a reward, or need to complete an additional behavior in order to earn their next reward.
This is another type of feedback intended for the community. This information will be displayed to the users, which are part of the user community circle - friends, followers,...That will notify them about the things, which the user has been done.
A dynamic in which success is granularly displayed and measured through the process of completing itemized tasks.
You can display the progress using the module "Gamification Profile."
The purpose of a leaderboard is to show players where they rank. Those at the top enjoy the notoriety it brings; as for everyone else, the leaderboard shows them where they stand relative to their peers. Often, the very presence of a leaderboard can elicit the desire to play. The simple goal of rising up the rankings serve as a powerful motivator to continue.
The gamification library is a collection of classes, which can be used for gamifying Joomla! extensions. The classes are part of the Gamification Platform and they work only on the platform.
Here you are examples and detailed information about the Gamification API.
The modules are Joomla! extensions that display blocks with content. They can be placed on predefined position included in the template. They are assigned per menu items.
There are some modules, which are parts of the gamification platform. They display information about the badges, levels and ranks. They also show notifications messages and progress bar.
This is a module that shows information about user points, level, rank, progress and badges.
This module displays a list with latest users activities.
This is a module that visually displays where a user stands in regard to other users.
This module displays a list with notifications.
Plug-ins add additional features on the website. Gamification Platform comes with several plugins and you can find them on the "Plug-in Manager". Enable those that you would like to use.
User - Gamification
That plug-in creates a user profile to the platform and gives units (points) to users after registration.
System - Gamification
This plug-in monitors the current status of the user. If the user has reached a certain number of points, the plugin will increase his level or rank. It will also give him a badge.
How to translate Gamification Platform?
You can translate this extension in your language using Transifex. Go to the system and sign in. Find Gamification Platform translation project and start translating. If you need more information, read the article "How to translate ITPrism extensions in your language?"
You can also use ITP Transifex to create language packages.
How to get FREE support?
You can report issues on Gamification Platform GitHub repository.
If you have any questions, you can send them to me, using the contact form. Please, send me a message with only one question. When I answer you, you will be able to send me your next one.
How to upgrade the extension?
The better way to upgrade the extensions is:
- Make a backup of your site ( database and files ) ( optional but highly recommended );
- Install the new version over the old one ( all previous data will be saved );
- Check the extension settings and menu items for changes;
- Check for a new version of ITPrism Library. If there is a new version, install it.
- You should also upgrade all other modules and plugins, which work with Gamification Platform.
How to get support?
You can post issues on Gamification Platform GitHub repository. If you have any questions, you can send me a mail from the contact form. If you need premium support you are able to subscribe for my premium services on ITPrism members site.