Skip to content

The most flexible and powerful gamification system for WordPress

License

Notifications You must be signed in to change notification settings

josemdwt/GamiPress

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GamiPress

The most flexible and powerful gamification system for WordPress.

Description

GamiPress is the easiest way to gamify your WordPress website in just a few minutes, letting you award your users with digital rewards for interacting with your site.

Easily define the achievements, organize requirements, and choose from a range of assessment options to determine whether each task or requirement has been successfully achieved.

GamiPress is extremely powerful and infinitely extensible. Check out some of the built in features:

3 powerful ways to award your users

GamiPress combines three of the most powerful award systems you could add to your site:

  • Points to automatically award your users for interacting with your site.
  • Achievements to award users for completing all the requirements, sequentially or otherwise.
  • Ranks to let your users climb through the ranks by completing all the rank requirements.

Many ways to define how to award the different points, achievements and ranks

  • Site activity (triggers based on publishing posts and pages, commenting, daily visits or logging in to your site).
  • Completing specific other achievements, once or a specified number of times.
  • Completing one or all achievements of a specified type.
  • Points thresholds.
  • Admin awarded achievements.
  • Reaching a specific rank.

Unlimited Points Types

  • Create as many types of points as you like (Credits, Gems, Coins, etc).
  • Easily define how automatically your users will earn points using the 'Points Awards' tool.
  • Management of each user points wallet.

Unlimited Achievements Types

  • Create as many types of achievement as you like (Quests, Badges, etc).
  • Easily define how they relate to one another using the 'Required Steps' tool.
  • Set default images for each achievement type or select unique images for every achievement item.

Unlimited Rank Types

  • Create as many types of rank as you like (Level, Grade, etc).
  • Easily define how they relate to one another using the 'Rank Requirements' tool.
  • Set default images for each rank type or select unique images for every rank item.

Drag and drop controls

  • Simple yet powerful admin interface for defining the "Required Steps" for any achievement.
  • Easily link together one or more triggers, steps or actions into the conditions needed to earn an achievement.
  • Limit by period of time in which the user can complete a requirement (daily, weekly, monthly or yearly).

Reward user progress

  • Issue digital rewards for any combination of achievements.
  • Award points for commenting, logging in, visiting or completing any combination of tasks.
  • Display a congratulatory message, customizable per achievement, on each achievement page.

Widgets, Shortcodes and Shortcode Embedder

  • Multiple options and parameters for each widget or shortcode for greater flexibility.
  • Live shortcode embedder appears in the toolbar of all WordPress content editor areas, allowing you to transform any page or post into part of your gamification system without referencing any of the shortcodes.
  • Shortcode to integrate specific available achievements into any post or page of your site.
  • Integrated shortcode documentation within the plugin menu.
  • Just activate GamiPress and place simple shortcodes on any page or post, and you've got a gamification system running on your WordPress site!

Email notifications

  • Notify to your users about their progression through emails.
  • Easily define the template to be used for each email type.
  • Enable or disable any email type as you like.

Powerful tools

  • Built in tools to recount old activities, migrate plugin configuration or clean testing data.

Log everything

  • Flexible log system with support for public and private logs.
  • Display the latest logs anywhere on your site for all users or a specific one.

Theme Agnostic

  • GamiPress works with just about any standard WordPress theme.
  • No special hooks or theme updates are needed.
  • Overwritable templates system to allow you customize everything you want through your GamiPress theme folder.
  • Turn any page or post into a way to display available achievements, earned points or latest logs and for users to track their progress.

Integrated with your favorites WordPress plugins

Powerful add-ons to extend GamiPress

WordPress.org is home to some amazing extensions for GamiPress, including:

If you’re looking for something endorsed and maintained by the developers who built GamiPress, there are a plethora of premium add-ons, the most popular of which include:

Helpful Links

Installation

From WordPress backend

  1. Navigate to Plugins -> Add new.
  2. Click the button "Upload Plugin" next to "Add plugins" title.
  3. Upload the downloaded zip file and activate it.

Direct upload

  1. Upload the downloaded zip file into your wp-content/plugins/ folder.
  2. Unzip the uploaded zip file.
  3. Navigate to Plugins menu on your WordPress admin area.
  4. Activate this plugin.

Screenshots

Frontend shortcodes and widgets demo Frontend shortcodes and widgets demo

Requirements edit screen Requirements edit screen

Live shortcode embedder Live shortcode embedder

Builtin widgets Builtin widgets

Configurable email templates Configurable email templates

Logs edit screen Logs edit screen

Frequently Asked Questions

Where can I find documentation about GamiPress?

Check the Getting Started docs where you can start getting familiarized with GamiPress.

Also, we have the tutorials sections where you can find step-by-step guides to accomplish some common task to start working with GamiPress.

Which shortcodes come bundled with GamiPress?

GamiPress comes with the following shortcodes:

In your WordPress admin area, navigate to the GamiPress Help/Support menu where you can find the full list of available shortcodes, including descriptions of all parameters each shortcode supports.

Which widgets come bundled with GamiPress?

GamiPress comes with the following widgets:

  • Achievement: to display a desired achievement.
  • Achievements: to display a list of achievements.
  • Logs: to display a list of logs.
  • Points Types: to display a list of points types with their points awards.
  • User Points: to display current or specific user points balance.
  • Rank: to display a desired rank.
  • Ranks: to display a list of ranks.

Changelog

1.3.6

  • Added the parameter title to [gamipress_achievement] and [gamipress_achievements] shortcodes to hide the achievement title.
  • Added the field "Show Title" to GamiPress: Achievement and GamiPress: Achievements widgets to hide the achievement title.
  • Added the parameter title to [gamipress_rank] and [gamipress_ranks] shortcodes to hide the rank title.
  • Added the field "Show Title" to GamiPress: Rank and GamiPress: Ranks widgets to hide the rank title.
  • Added logs patterns for points deducted/revoked.
  • Added ajax pagination to user earnings table on user profile screen.
  • Fixed issue on actions when saving logs.
  • Fixed limit of ranks listed at edit user profile screen.
  • Fixed default ranks (lowest priority) are not look as earned at frontend.
  • Added extra check to prevent award multiple times the same rank.
  • Added the delete permanently action to logs.

1.3.5

  • Fixed listener form add new comment when comments needs approval.
  • Improvements on user profile earnings table.
  • Added hook to register activity triggers excluded form activity limits (like earn points or ranks).
  • Added database table check to avoid any warning.
  • Added more parameters to ajax functions.
  • Improve messages queries on custom tables (logs and user earnings).
  • Improvements on admin area styles.

1.3.4

  • Fixed [gamipress_achievements] load more visibility.
  • Updated plugin headers to support WordPress provided translations (translate.wordpress.org).
  • Improvements on admin area styles.
  • Improvements on shortcode embedder fields parser.
  • Improvements on assets enqueueing.
  • Improvements on emails tags functions.
  • Added hooks on emails functions to allow access to external functions.

1.3.3

  • Added the parameter load_more to the [gamipress_achievements] shortcode to disable pagination.
  • Added the field "Show the Load More button" to the GamiPress: Achievements widget to disable pagination.
  • Added automatic check of flush permalinks to avoid issues with not found pages.
  • Recovered the logs edit ability.
  • Fixed bug where widgets are not showing correctly the stored value of checkboxes.
  • Fixed typo on rank notice.
  • Improvements on tabs workflow.

1.3.2.1

  • Fixed wrong key check on rules engine.

1.3.2

  • Added gamipress_get_shortcode_attributes trigger on shortcode embedder to allow third party extensions customize the shortcode attributes.
  • Fixed issue where ranks are not correctly awarded.
  • Fixed issue with earn points and reach rank activity triggers.
  • Fixed emails send when step/rank requirement is the unique or the last one, because user will receive another email about the achievement/rank unlock.
  • Fixed typo on emails default texts.
  • Removed limit fields on ranks and points earn activity triggers to avoid confusions (always is limited to 1).
  • Improvements on shortcodes embedder styles.
  • Improvements on requirements UI functionality.

1.3.1

  • New Feature "Rank Types": Added the ability to define unlimited user rank types, for example: rank, level, grade, etc.
  • Added user ranks section on user profile.
  • Added rank image size setting.
  • Added rank earned/awarded logs patterns on settings.
  • Added rank reached and rank requirement completion emails.
  • New Feature: Allow achievements to be earned by reach a rank of specific type.
  • New activity trigger: Reach a specific rank of a specific type.
  • Added [gamipress_rank] and [gamipress_ranks] shortcodes.
  • Added GamiPress: Rank and GamiPress: Ranks widgets.
  • New activity trigger: Earn an amount of points.
  • Added the new parameter columns on [gamipress_points] and [gamipress_points_types].
  • Added the new field Columns on GamiPress: User points balance and GamiPress: Points Types widgets.
  • Added rank types, ranks and rank requirements options on reset data tool.
  • Added contextual help on rank type and rank edit screen.
  • Fixed issue with selected points types on achievements.
  • Fixed issue with plugins that outputs user profile fields at frontend (like bbPress).
  • Fixed wrong hook parameters on points types template.
  • Improvements on admin area styles.
  • Improvements on achievements completion detection.
  • Improvements on emails templates settings.
  • Performance improvements on logs SQL queries.
  • Performance improvements on rules engine checks.

1.3.0.1

  • Fixed issue with email tags parser.

1.3.0

  • New feature: Emails.
  • Added email on achievement earned.
  • Added email on step completed.
  • Added email on points award completed.
  • Added the parameter current_user to [gamipress_achievements], [gamipress_points] and [gamipress_logs] shortcodes.
  • Added the field "Current User" to GamiPress: Achievements, GamiPress: Points and GamiPress: Logs widgets.
  • Improvements on points awards/steps achievement unlock labels.
  • Improvements on admin area styles.
  • Reset public changelog (moved old changelog to changelog.txt file).
  • Set GamiPress 1.3.0 as new stable release! :)

About

The most flexible and powerful gamification system for WordPress

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 80.2%
  • CSS 12.7%
  • JavaScript 6.6%
  • Other 0.5%