1. Documentation
  2. Getting Started
  3. Events

Events

Events are the conditional action that a user needs to perform in order to complete an achievement step, a points award or deductions or a rank requirement.

Check the following image to get a more direct idea of where you can find them:

Built-in Events

GamiPress was designed to be extensible, for that, the default built-in events are focused on the default WordPress events that could be performed on a basic install. GamiPress comes bundled with the next events:

WordPress Events

Register to website: When a new user gets registered to your WordPress.
Log in to website: When user logs in your WordPress.
Comment on a post: When user comments on any post or page.
Comment on a specific post: When user comments on a specific post or page.
Get a comment on a post: When user gets a comment on a post or page.
Get a comment on a specific post: When user gets a comment on a specific post or page.
Get a comment marked as spam: When user gets a comment marked as spam.
Get a comment of a specific post marked as spam: When user gets a comment of a specific post or page marked as spam.
Publish a new post: When user publishes a new post.
Publish a new page: When user publishes a new page.
Delete a post: When user deletes a post.
Delete a page: When user deletes a page.
Get added to any role: When user gets added to any role.
Get added to specific role: When user gets added to a specific role.
Get assigned to any role: When user gets assigned to any role.
Get assigned to specific role: When user gets assigned to a specific role.
Get removed from any role: When user gets removed from any role.
Get removed from a specific role: When user gets removed from a specific role.

Important: The log in to website event is based on how WordPress log in the user and the event just will be triggered when session gets expired and user is force to log in (or auto-log in) again (that is when WordPress triggers it). So, sometimes when you log in, WordPress is not really log in you, is just rescuing your session from a cookie. More information.

Site Interactions

Daily visit the website: When user visits your WordPress.
Daily visit a specific post: When user visits a post or page.
Get visits on any post: When user gets visits on a post or page.
Get visits on a specific post: When user gets visits on a specific post or page.

GamiPress Events

Unlock a specific achievement: When user unlocks a specific achievement.
Unlock any achievement of type: When user unlocks any achievement of a specific achievement type. (more info about achievement types)
Unlock all achievements of type: When user unlocks all achievements of a specific achievement type.
Earn an amount of points: When user earns a desired amount of points. (more info about points types)
Reach a points balance: When user reaches a desired total balance of points.
Expend an amount of points: When user expends a desired amount of points. (more info about expending points)
Reach a rank: When user reaches a specific rank of a specific rank type. (more info about rank types)

Integrations

Thanks to the GamiPress integrations you are able to extend GamiPress and add new events based on the integration you are looking for.

Installing the WooCommerce integration on your WordPress you will be able to setup requirements based on, for example, product purchases.

Also, installing the Contact Form 7 integration on your WordPress you will be able to setup requirements based on contact form submissions.

How can we help?