=== Gamilu Gamification ===
Contributors: okmultimedia
Tags: gamification, points, badges, rewards, levels
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Reward your users with points, badges and levels. Set up in a minute, lovely to look at.

== Description ==

**Make your site a little more fun.** Gamilu rewards your users with points when they sign up, come back, publish or comment. Points unlock badges and move them up levels, and a friendly otter pops up to celebrate each achievement.

No complicated setup: a three-step welcome wizard, twelve ready-made badges and four levels are waiting for you the moment you activate it.

= What you get =

* **Points** for signing up, visiting (once a day), publishing posts and writing comments. You choose how many, and set daily limits.
* **Twelve hand-drawn badges** ready to use, or upload your own pictures.
* **Levels** (Bronze, Silver, Gold and Diamond out of the box), fully editable.
* **Call your points whatever you like:** coins, stars, gems…
* **User card** with points, level, a progress bar and latest badges.
* **Badge gallery** showing what each user has earned and what is still to come.
* **Celebration notice** with the Gamilu otter and a little confetti when a user earns something. You can switch it off.
* **Blocks and shortcodes:** works with the block editor, page builders and classic themes.
* **Users screen** with each user's history and manual adjustments.
* **Privacy friendly:** works with the WordPress tools to export and erase personal data. No tracking, no external calls.

= Shortcodes =

* `[gamilu_card]` – points, level, progress and latest badges of the logged-in user.
* `[gamilu_badges]` – all badges, earned and still to earn.

== Installation ==

1. Install and activate Gamilu from Plugins > Add New.
2. Follow the three-step welcome wizard.
3. Add the "Gamilu: user card" block (or the `[gamilu_card]` shortcode) to any page.

== Frequently Asked Questions ==

= Do visitors who are not logged in earn points? =

No. Points belong to registered users. Visitors see a friendly invitation to log in.

= Can I take points away? =

Yes, from Gamilu > Users, with a reason that only you can see.

= What happens to the data if I delete the plugin? =

Nothing is deleted unless you tick "Delete all Gamilu data" in Gamilu > Settings first.

== Screenshots ==

1. The user card with points, level and progress.
2. The badge gallery.
3. The celebration notice.
4. The dashboard.

== Changelog ==

= 1.0.1 =
* New: meet Gamilu Celebration Popups. Level ups, new badges and finished courses become a full-screen party with trumpets, confetti and a fanfare.
* New: meet Gamilu Fair Play, a free add-on. Write your community rules and show yellow or red cards.
* New: meet Gamilu for BuddyPress, a free add-on. Your community earns points for posting, commenting, making friends and joining groups.
* New: the Add-ons screen lists all three, with their own artwork.
* New: add-ons can now ask whether a user takes part in the game, so blocked users stay out of rankings and prizes.
* Improved: Spanish translation updated.

= 1.0.0 =
* Gamilu Gamification 1.0 is here: the first stable version, ready for real sites.
* New: meet Gamilu for Tutor LMS. Your students earn points and badges for enrolling, finishing lessons, passing quizzes and completing courses, with a My rewards tab in their dashboard.
* New: the Add-ons screen now lists Gamilu for Tutor LMS, with its own artwork.
* Fixed: with Gamilu Bar 0.1.1, the bar no longer covers your site's header while scrolling.
* Improved: Spanish translation updated.

= 0.1.3 =
* New: meet Gamilu for Contact Form 7, a free add-on. Your users earn points for sending your forms, answering surveys or picking a specific answer.
* New: the Add-ons screen now lists it, with its own artwork.
* Improved: Spanish translation updated.

= 0.1.2 =
* New: a redesigned Add-ons screen. Every add-on now shows its own artwork, so you can tell them apart at a glance.
* New: Gamilu Christmas is out and listed, ready to dress up your whole site for the holidays.
* New: "Get the latest version" link at the end of the Gamilu menu, straight to the download page.
* Improved: the add-on catalogue and its pictures still ship inside the plugin. No remote calls, no tracking, nothing loaded from outside.
* Improved: Spanish translation completed, add-on descriptions included.

= 0.1.1 =
* Improvements.
* New menu icon: Gamilu's coin with its star.
* Ready for Gamilu Christmas: new filters gamilu_badge_met and gamilu_badges.

= 0.1.0 =
* First version: points, levels, badges, rules for earning points, on-screen notices, blocks and shortcodes.
* Ready for Gamilu Leaderboards.
* Ready for Gamilu for WooCommerce: new hooks gamilu_actions and gamilu_badge_icons.
* Ready for Gamilu Wheel, Gamilu Bar and Gamilu for Elementor.
