=== Kabook Daily Coupon Hunt ===
Contributors: saeidafshari
Tags: woocommerce, coupon, discount, gamification, coupon-hunt
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Gamify your WooCommerce store! Boost SEO, increase dwell time, and skyrocket sales by hiding daily dynamic coupons inside your posts and products.

== Description ==

**Turn your website into a daily treasure hunt!** **Kabook Daily Coupon Hunt** is not just another coupon plugin; it's a powerful marketing and SEO tool designed to dramatically increase user engagement. By automatically generating a daily coupon and hiding it within a random selection of your articles or products, you give your visitors a compelling reason to explore your website every single day.

**🔥 Why This Plugin is an SEO Game-Changer:**

When users hunt for today's hidden coupon, they naturally visit more pages and spend more time on your website. This helps increase user engagement while encouraging visitors to explore more of your content and products.

**🚀 Core Features & Marketing Power:**

* Automatically generates a unique WooCommerce coupon every day.
* Randomly hides the coupon inside selected posts or products.
* Supports configurable minimum and maximum discount percentages.
* Includes daily usage limits to create urgency.
* Supports WooCommerce Individual Use coupons.
* AJAX powered Status & Report dashboard.
* Manual Trigger button for instantly generating a new daily coupon.
* Three built in frontend styles: Default, Modern, and Luxury.
* Fully customizable frontend texts.
* Native support for both Gregorian and Jalali calendars.
* Optimized random selection using the WordPress Transients API.

**🧩 New in Version 1.1.0 – Shortcodes**

Version 1.1.0 introduces two powerful shortcodes that make it easier to promote your daily coupon campaign.

**Coupon Teaser Shortcode**

Display a teaser that encourages visitors to search for today's hidden coupon without revealing the coupon code.

`[kdch_coupon_teaser]`

Ideal for:

* Blog posts
* Landing pages
* Sidebar widgets
* Dedicated campaign pages

**Daily Coupon Shortcode**

Display today's active coupon directly on any page.

`[kdch_daily_coupon]`

Perfect for landing pages, promotional campaigns, newsletters, and special offers.

**🔎 Live Demo**

See the teaser shortcode in action:

https://www.kabook.ir/kabook-daily-coupon-hunt/

== Installation ==

1. Upload the `kabook-daily-coupon-hunt` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Make sure WooCommerce is installed and activated.
4. Open **Kabook Coupon** from the WordPress admin menu.
5. Configure the plugin settings and start your daily coupon hunt.

== Frequently Asked Questions ==

= Will random post selection slow down my website? =

No. The plugin calculates the random targets only once per day and stores the results using the WordPress Transients API, avoiding expensive random database queries on every page load.

= Can I manually generate a new coupon? =

Yes. The Manual Trigger button instantly generates a new coupon and assigns it to a new random selection of posts or products.

= What happens after the daily usage limit is reached? =

The coupon is no longer displayed and your configured failure message is shown instead.

= Do I need a Jalali calendar plugin? =

No. Kabook Daily Coupon Hunt includes built in Jalali calendar support.

= What shortcodes are available? =
* `[kdch_coupon_teaser]` - Displays a teaser that encourages visitors to search for today's hidden coupon.
* `[kdch_daily_coupon]` - Displays today's active coupon box anywhere on your website.

== Screenshots ==

1. Status & Report tab – the dedicated dashboard showing real-time coupon status, database stats, and a paginated list of today's target posts.
2. General settings – configure display chances, min/max discount ranges, usage limits, and the manual trigger button.
3. Style settings – customize the coupon box appearance with Default, Modern, and Luxury styles plus fully configurable gradients.
4. Frontend display – see how the coupon box is rendered inside a real post on your site.
5. Multiple frontend styles – preview different visual styles of the daily coupon box (Default, Modern, Luxury).

== Changelog ==

= 1.1.0 =

* New: Added `[kdch_coupon_teaser]` shortcode.
* New: Added `[kdch_daily_coupon]` shortcode.
* Tweak: Optimized frontend asset loading.
* Tweak: Removed redundant inline scripts and improved rendering performance.

= 1.0.0 =

* Initial release.

== Upgrade Notice ==

= 1.1.0 =

Adds two new shortcodes for teaser and landing pages, along with frontend performance improvements.