=== Gamilu ===
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.2
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.

= Add-ons =

Gamilu is complete and free on its own. If you want more, optional add-ons are separate plugins: some are free and some are premium. You will find them in Gamilu > Add-ons. Nothing in Gamilu is locked or limited without them.

= 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 Plugin.
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.2 =
* Add-ons screen: Gamilu Fair Play, Gamilu for BuddyPress and Gamilu Celebration Popups.
* New filter `gamilu_user_can_play`, so add-ons can leave a user out of rankings and prizes.

= 1.0.0 =
* First release on WordPress.org.
* Points for signing up, daily visits, publishing posts and writing comments, with daily limits.
* Twelve ready-made badges and four editable levels.
* Three-step welcome wizard.
* User card and badge gallery, as blocks and shortcodes.
* Celebration notice with the Gamilu otter.
* Users screen with history and manual adjustments.
* Works with the WordPress tools to export and erase personal data.
