1. Documentation
  2. Tutorials
  3. How the awards engine works

How the awards engine works

Let’s to see how to configure some real world achievement steps, points awards or deductions and rank requirements and how the GamiPress awards engine will interpret them.

Important: Requirements UI and events documentation pages are a must-read articles before start this tutorial.

Playing with the requirement limits

One of the most complex but useful features of the requirements is the ability to time limit their completion.

Inside the requirements UI, time limits inputs are placed before the required times input:

The requirement limits works in concordance with the required times what gives them endless possibilities.

Let’s to see an example requirement to meet much better how it works and how the awards engine will work when time limits has been configured:

Comment on any post 3 times limited to 1 per day

When you set a requirement with a configuration like this one you are setting that the user needs to comment on any post 3 times but the times that will take in count are limited to 1 per day.

Let’s to see the workflow of that in the GamiPress awards engine:

Day 1: User comments on 2 posts
The awards engine will take them in count just 1 for this requirement (since is limited to 1 per day).
User needs 2 comments to achieve the requirement.

Day 2: User comments on 1 post
The awards engine will take them in count.
User needs 1 comment to achieve the requirement.

Day 3: User comments on 1 post
The awards engine will take it in count.
User will achieve the requirement and a subsequence of process will happen like, if this requirement is the last step to unlock an achievement, then the user will unlock the achievement.

Requirement limits and points automations

The points awards and deductions are an excellent example of how to setup automatic ways to award or deduct points limited by time.

Let’s to see 3 examples of points awards to get a graphical example of how the points automation and the requirements time limits can offer different.

The example points awards will be (pay attention to the time limits):

  • 5 credits for comment on any post 3 times limited to unlimited
  • 5 credits for comment on any post 3 times limited to 1 per day
  • 5 credits for comment on any post 3 times limited to 9 per day

Let’s to see how each points award will work:

5 credits for comment on any post 3 times limited to unlimited

Users will be able to get the credits every 3 times he comments on a post, without limit.

The awards engine will interpret it:
Day 1: User comments on 15 posts
The awards engine will take them in count and user will get the amount of credits 5 times (5 credits x 5 = 25 credits in total).

Day 2: User comments on 6 post
The awards engine will take them in count and user will get the amount of credits 2 times (5 credits x 2 = 10 credits in total).

Day 3: User comments on 1 post
The awards engine will take it in count, without award to the user because points award requires 3.

The final user credits balance will be 35 credits.

5 credits for comment on any post 3 times limited to 1 per day

With the limitation of “1 per day” we are limiting the points award to be awarded just the 3rd day that user makes a comment.

The awards engine will interpret it:
Day 1: User comments on 15 posts
The awards engine will take them in count just 1.
User needs 2 comments to achieve the points awards.

Day 2: User comments on 6 post
The awards engine will take them in count just 1.
User needs 1 comment to achieve the points awards.

Day 3: User comments on 1 post
The awards engine will take them in count and user will get the amount of credits 1 time (5 credits).

The final user credits balance will be 5 credits.

5 credits for comment on any post 3 times limited to 9 per day
There is a really different points award, first the points awards requires that the action (comment on any post) needs to be executed 3 times to earn 5 credits, but defining a limit of “9 per day”, will limit to the user to be awarded a maximum of 3 times per day (3 x 3 = 9).

The awards engine will interpret it:
Day 1: User comments on 15 posts
The awards engine will take them in count and user will get the amount of credits 3 times (5 credits x 3 = 15 credits in total).
Without the limitation of “9 per day”, user could be earned 25 credits like the first points award.

Day 2: User comments on 6 post
The awards engine will take them in count and user will get the amount of credits 2 times (5 credits x 2 = 10 credits in total).

Day 3: User comments on 1 post
The awards engine will take it in count, without award to the user because points award requires 3.

Was this article helpful to you? Yes No

How can we help?