=== Gamilu for Contact Form 7 ===
Contributors: okmultimedia
Tags: gamification, contact form 7, points, survey, rewards
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: gamilu, contact-form-7
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Your users earn Gamilu points when they send a Contact Form 7 form: any form, a specific one or a specific answer.

== Description ==

A free add-on for Gamilu Gamification. It needs Gamilu and Contact Form 7, both active.

* **Points for sending any form**, or only a specific one.
* **Points for a specific answer:** reward a "Yes", a survey choice or any value in a field. Works with text fields, radio buttons, checkboxes and drop-downs.
* **Fair limits:** times a day for each rule, or "only once", ideal for surveys.
* **Works out of the box:** no settings to change in Contact Form 7, and visitors can still send your forms. Only users who are logged in earn points.
* **Instant celebration:** the Gamilu otter pops up with the points the moment the form is sent, no page reload needed.
* **Gamilu style for your forms:** radio buttons and checkboxes with bold outlines, a soft shadow and your accent colour. Switch it off anytime.
* Points only for forms sent successfully. Forms stopped by validation or spam filters give nothing.
* Every rule shows up in the user history and can be used in badge rules.

Settings: Gamilu > Contact Form 7.

Gamilu for Contact Form 7 is an independent add-on. Contact Form 7 is a plugin by Takayuki Miyoshi; this add-on is not affiliated with or endorsed by its author.

== Installation ==

1. Make sure Gamilu Gamification and Contact Form 7 are active.
2. Plugins > Add New > Upload Plugin, choose the zip file and activate it.
3. Go to Gamilu > Contact Form 7 and choose which forms give points.

== Frequently Asked Questions ==

= Do visitors earn points? =

No. Points belong to a user account, so only users who are logged in earn them. Visitors can still send your forms as usual.

= Do I need to turn on "subscribers only" in my forms? =

No. Each form shown to a logged-in user carries a small signed ticket that tells Gamilu who sent it. It cannot be forged and it expires after two days.

= I use a page cache. Will it work? =

Yes, as long as pages are not cached for logged-in users, which is how most cache plugins work by default.

= Does it send data anywhere? =

No. Everything stays on your site. The add-on makes no external calls and includes no tracking.

== Changelog ==

= 1.0.2 =
* New: Gamilu style for your forms. Radio buttons and checkboxes get bold outlines, a soft shadow and your accent colour, with a little bounce when ticked. On by default, one click to switch it off.

= 1.0.1 =
* New: instant celebration. The otter notice now pops up the moment a form is sent, no need to reload the page.

= 1.0.0 =
* First stable release: points for sending any form, a specific form or a specific answer, with daily limits and "only once".
