1. Documentation
  2. Expirations
  3. How applied expirations work

How applied expirations work

Every time a user earns anything, Expirations add-on will check this element configuration to meet if there is any expiration to apply and will assign it to the user earning entry.

There are some situations where some items expiration could get cancelled automatically. Those situations are:

  • If user unlocks an achievement, all steps with an expiration will get cancelled.
  • If user unlocks a rank, all rank requirements with an expiration will get cancelled.
  • If user unlocks a new rank, previous ranks with an expiration will get cancelled.

This workflow opens the door to create time limited challenges. There are a few examples:

Limited time points:

Setting up expiration to your points awards will force your users to expend their points in something before lose them.
For example, you can create the points type “Credits” and setup a points award of “100 points for complete a course” and configure this to expire in 1 day.
This will force the user to expend this points (for example, as a discount on WooCommerce or Easy Digital Downloads) in a time frame limit of 1 day.

Limited time achievement steps:

Setting up expiration to some achievements steps will force your users to complete their steps in the time you wish.
For example, you can create the achievement “Badge A” with 2 steps and configure those steps to expire in 1 hour later.
This will force you users to complete both steps in less than 1 hour to be able to unlock this achievement, if they take more than 1 hour to complete the steps, then those steps will expire and they will have to repeat them.

Limited time ranks:

You can configure an expiration to all or some ranks of the same type, forcing your users to reach a new rank in the time frame you setup.
For example, you can create the rank type “Level”, with the ranks “Level 1”, “Level 2”, “Level 3”, etc and configure each rank to expire in 1 month.
This setup will force your users to move forward to every new rank in less than 1 month in order to keep their rank and do not lose it.

Ranks with the recalculate option enabled:

For ranks, you can find in the “Expiration” box the “Recalculate” option.

Checking this option will make that, at the moment a rank expires or get revoked, the expiration date for the next rank the user gets moved will get recalculated.

For example, if a rank should expire in 1 day, Expirations add-on commonly calculates it at the moment the user unlocks the rank. The recalculate option, makes that the rank expiration date will be calculated again at the moment its next rank gets expired or revoked.

To better understand this setting, let to show a simple example. Imagine that we have the Rank 3 and Rank 2, both configured to expire in 5 days. Here are the different workflows available depending if recalculate is enabled or not for Rank 2:

Example without the recalculate option:

  • Jan 1st: User unlocks Rank 2 – Expiration date for Rank 2 is set to Jan 6th (5 days after).
  • Jan 2nd: User unlocks Rank 3 – Expiration date for Rank 3 is set to Jan 7th.
  • Jan 7th: User Rank 3 expires – The Rank 3 gets revoked and user gets moved to Rank 2.
  • Since Rank 2 expires in Jan 6th, it also gets revoked since the recalculate option is not marked and user gets moved to Rank 1.

Example with the recalculate option:

  • Jan 1st: User unlocks Rank 2 – Expiration date for Rank 2 is set to Jan 6th.
  • Jan 2nd: User unlocks Rank 3 – Expiration date for Rank 3 is set to Jan 7th.
  • Jan 7th: User Rank 3 expires – The Rank 3 gets revoked and user gets moved to Rank 2.
  • Rank 2 expiration date gets recalculated and now expires on Jan 12th
  • Jan 12th: User Rank 2 expires – The Rank 2 gets revoked and user gets moved to Rank 1.

How can we help?