Jump to
Directorist - GamiPress adds gamification to your directory site to engage your members and make your directory more captivating and interactive. This extension automatically connects GamiPress with Directorist adding new activity events based on which points can be earned.
GamiPress is a free plugin that lets you gamify your WordPress website. Award your users with points, achievements, and ranks as they interact with the eCommerce, e-learning, social and other elements of your website. And using this extension you can now gamify your Directorist powered directory website too…
System requirements:
- WordPress: at least version 5.1 or latest
- PHP: at least version 7.0 or latest
- Directorist: at least version 7.2.0 or latest
- GamiPress: at least version 2.0 or latest
Directorist Events for GamiPress:
“GamiPress events are the conditional actions that a user needs to perform in order to complete anything inside GamiPress. The events system is based on listeners and triggers (as any events system).” - GamiPress
There are 11 events when you can award or deduct points from directorist and those events are the following:
- Publish a new listing
- Delete a listing
- Listing expires
- The user reports a listing
- Owner gets report on a listing
- User reviews a listing
- The owner gets a review on a listing
- User favorites a listing
- Owners listing get favorites
- Listing becomes popular
- Purchase a plan
Creating Point Type
First, go through the following documentation to get the steps and ideas on creating the point type.
Link to the official GamiPress doc: https://gamipress.com/docs/tutorials/creating-a-points-type/
- Creating point types for Directorist Events: For creating a point type kindly navigate to GamiPress→ Points Types→ Add New
The very first step for creating a point type is giving the point types a name which includes Singular name, Plural name, and Slug. Singular is for singular points achieved and the plural is for plural points achieved. Slug is used for internal references, as some shortcode attributes, to completely differentiate this points type from any other (leave blank to automatically generate one).
The names will be available as point types in the User Dashboard. To check that navigate to User Dashboard→ Points
Automatic Points Award: After successfully configuring the point type data, you have to configure the Automatic point Awards. The Automatic Points Award is responsible for adding the points automatically each time the event is triggered. To configure, click Add New points award for creating an automatic point award. There will be 7 fields you need to configure here to make that function. At first set the event of when you want the automatic points awards to be added. As previously mentions there are 11 Events available for directorist here. Choose one from there.
Then set the times for that events. This will be responsible for a number of times the event will trigger. For example, if the time(s) value is set to 3 for Publish a new Listing event, then after submitting 3 listings the event will trigger.
Then set the “limited to” field. You can set the limit for the time to trigger the event. For example, if the value of limited to is set to “per hour”. Then after submitting “A” times per hour the event will trigger.
Then set the points to be earned in that event. The value that is set in the Earn field will be added as points after the event is triggered. For example, each time the Publish a new Listing event is triggered 5 points will be added.
Then set the maximum number to which the trigger will work. For example, if the value is set to 2, then this event will trigger 2 times. For the 3rd time, it will not work which means no points will be added for the 3rd time.
Then set the label of the Point Award. Use the "Label" field to optionally customize the titles of each one.
Example/Use Case: Let the event be Owner gets a review on a listing. You want to set the event in a way where the owner will receive 5 points for 3 stars or greater. Then you have to set greater Than, 3 ratings. The configuration will be like the screenshot,
With the above configuration, the owners will receive 5 points each time he/she gets ratings. You will see the owner receiving 5 points in the dashboard.
Automatic points Deduct: Unlike the Automatic Points Award, the Automatic Points Deducts is responsible for deducting the points automatically each time the event is triggered. The configuration is exactly the same as the Automatic Points Awards. Hence, follow the configuration of Automatic Points Award. The only difference here is that each time the points will be deducted.
Example/User Case: Like the Automatic Points Award, let the event be Owner gets a review on a listing. You want to set the event in a way where 4 points will be deducted from the owner’s points if he/she gets a review of fewer than 2 stars. Then you have to set Less than, 2 ratings. The configuration will be in this way,
You will see owner’s points will be deducted in the dashboard.
Creating Achievement Type
First, go through the following documentation to get the steps and ideas on creating the Achievement type.
Link to the official GamiPress doc: https://gamipress.com/docs/tutorials/creating-an-achievement-type/
For creating the achievement types, navigate to Gamipress→ Achievement Types→ Add New
The very first step for creating a Achievement type is giving the achievement type a name which includes Singular name, Plural name and Slug. Singular is for singular points achieved from the achievement type and plural is for plural points achieved the achievement type. Slug is used for internal references, as some shortcode attributes, to completely differentiate this points type from any other (leave blank to automatically generate one). For each achievements, users will receive the points according to the configuration.
After adding the name a field will be added to that name inside the Achievement taxonomy.
Then click the Add new button to configure that field.
Then give the Achievement a name.
After that give an Awarder Points. In this field, you have to set the points that will be added as achievements and set the point type in which the points will be added. For example, 25 points will be added to the reviews point types for this achievement.
The next field to be configured is Earned By. There are options that will be available in this field. Each is described briefly below
Completing Steps: In this option, the achievement will be achieved by completing the steps. For that, you have to determine the steps that are needed to fulfill to achieve that achievement. Steps have to be determined in the Required Steps section which is located right at the bottom of the page.
Minimum Number of Points: In this option, the achievement will be achieved by the minimum number of points of a specific point type. For that, you have to set the Minimum Points Required. You have to set the Minimum Points and Choose the point types that are required to achieve the achievement. For example, 7 points are required in the “Listings” Point type to achieve the achievement.
Reach a rank: In this option, the achievement will be achieved by reaching a rank. To use this option you have to configure the Rank type first. When you have successfully created the Rank type and the Ranks, then you have to assign the Required Rank Type and Required Rank by which the achievement will be unlocked.
Users can check their achievements in the user dashboard,
Creating Rank Type
Go through the following documentation to get the steps and ideas on creating the Rank type. Follow the GamiPress documentation to create the rank types
Link to official GamiPress doc: https://gamipress.com/docs/tutorials/creating-a-rank-type/
Users can check their achievements in the dashboard,
Last Updated: April 10th, 2022