=== Magic Coupon for WooCommerce ===
Contributors: webdados
Tags: woocommerce, coupons, promotions, marketing
Author URI: https://www.webdados.pt
Plugin URI: 
Requires at least: 4.7
Tested up to: 5.5
Stable tag: 1.2

Pass a WooCommerce coupon code via URL and display the product prices as if the coupon has been applied to them. Coupon is automatically added to the cart alongside the products.

== Description ==

With this plugin, you can pass a coupon code via an URL parameter (`mcoupon` by default) and it will be stored in a cookie for a configurable amount of time.

While the cookie is valid:

* All the eligible products will have their display price reflect the coupon discount;
* A personalized HTML message can be shown on the product page, under the product price (or anywhere else, if you know your way around hooks);
* When the client adds the product to the cart, the coupon is automatically applied also;

Please note that the coupon can still be applied manually by the user at any time. This will not lock the coupon regular usage.

== Installation ==

* Use the included automatic install feature on your WordPress admin panel and search for “Magic Coupon WooCommerce”;
* On each coupon you want to activate this plugin features, you must go to the “Magic Coupon” tab and check “Enable”;

== Frequently Asked Questions ==

= Can I change the URL parameter name from `mcoupon` to something else? =

Yes. Use the `magic_coupon_url_parameter` filter.

= Can I show the HTML message somewhere else on the product page? =

Sure you can. Use the `magic_coupon_html_message_action_hook` filter to change the hook and the `magic_coupon_html_message_action_priority` filter to change the priority.

If you don’t know what we’re talking about, you should probably stop now and [hire us](https://www.webdados.pt/contactos/) to do it for you :-)

You can also show it directly on the product description by using the `[magic_coupon_html_message]` shortcode.

= Is it possible to add dynamic information to the HTML message? =

You bet! Use one of the following placeholders on your message:

* `{product_id}` will be replaced by the Product ID;
* `{coupon}` will be replaced by the coupon code;
* `{cookie_expire_timestamp}` will be replaced by the cookie expiration Unix timestamp;
* `{cookie_validity_minutes}` will be replaced by the cookie validity in minutes;
* `{cookie_validity_hours_minutes}` will be replaced by the cookie validity in hours or minutes (in the `x hours` or `x minutes` format), depending on the validity being more or less than one hour;

You can also add you own placeholders with the `magic_coupon_html_message_replace_tags` filter. See an example [here](https://gist.github.com/webdados/c6094429e1e53306d767ee0b7255f4ea).

And because you can also use shortcodes on the HTML message field, you can feed the product id, coupon, the cookie expire timestamp or validity, or any other variable you set via your own placeholders as a shortcode argument, you can do whatever you want with your custom message. [Go crazy](https://gist.github.com/webdados/57682c9f7e4dad416f1ab0ec4b7476d5), or [hire us](https://www.webdados.pt/contactos/) to develop a custom solution for you.

= Can this plugin have issues with caching plugins? =

Yes. The page output has to be changed to set the discounted product prices based on the user cookie. That’s incompatible with a server-side caching system.

We set the following constants to prevent caching by some plugins, on the moment the customer reaches the page with a coupon code:

* `DONOTCACHEPAGE`
* `DONOTCACHEOBJECT`
* `DONOTCACHEDB`

This will ensure the page with the discounted price is not cached on that moment (and no other users will see a version of the page with the discount), but will not disable the cache that might already exist.

Anyway, we've experimented a bit with the [WP-Optimize](https://wordpress.org/plugins/wp-optimize/) "Cookies which, if present, will prevent caching" setting, by entering the name of our cookie (`mcoupon` by default), and we had good results. Regular users see the cached page and the ones with the coupon set on the cookie see non-cached pages.

== Screenshots ==

1. Magic coupon settings

== Changelog ==

= 1.2 =
* New `{cookie_validity_hours_minutes}` placeholder on the HTML message that will show the cookie validity time in hours or minutes; 
* Some fixes on the way the coupon is added to the cart to ensure it only happens after the product is already there
* Avoid duplicating the discount on the cart and checkout pages (Oops...)

= 1.1.1 =
* Small bugfix

= 1.1 =
* New `[magic_coupon_html_message]` shortcode to show the HTML message on the product description if the theme is custom and does not call the `woocommerce_single_product_summary` action
* Bugfix on the moment the coupon is checked from the cookie to avoid errors on some configurations
* Clarification of operation in conjunction with cache plugins
* Tested with WordPress 5.5-alpha-47748 and WooCommerce 4.1.0-rc.2

= 1.0.2 =
* Tested with WordPress 5.2.5-alpha and WooCommerce 3.8.0

= 1.0.1 =
* Small readme.txt fixes

= 1.0 =
* First released version (sponsored by: [muchogrowth.com](http://muchogrowth.com))