=== Mysterx - Mystery Boxes for WooCommerce ===
Contributors: wpgenie2, freemius
Donate link: https://wpgenie.org/
Tags: woocommerce, mystery box, loot box, prize box, marketing
Requires at least: 6.2
Tested up to: 6.9
Stable tag: 1.0.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Addon that implements custom product type "Mystery box" which enables you to offer and sell loot boxes containing high-value prizes.


== Description ==

Bring the excitement of loot boxes to your e-commerce site with this WooCommerce mystery box addon. Engage customers with high-value prizes revealed through an authentic, game-style spinner animation. This WooCommerce extension allows you to sell randomized prize bundles featuring a high-quality animated prize reveal.

= Features =

* Implements custom product type "Mystery box"
* Set available stock for items in the box
* Enable claim prize in popup (with optional link to a claim prize page)
* List only "Mystery box" product type on separate page for quick overview
* List of gift products in the box (in frontend) with settings
* User's My Account gets new Boxes sections with tabs "Boxes" and "Wins"
* "Open your Mystery Boxes" link on order thank you page which links My Account > Boxes tab
* New reward email notification for website admin
* New reward email notification for customer
* Shortcodes [mysterx], [featured_mysterx], [recent_mysterx], [my_won_mysterx], [my_mysterx] with same attributes as WooCommerce [products] shortcode

= Use Cases =

* Offer and sell loot boxes - similar to those found in video games
* Engage customers with high-value prizes
* Sell randomized prize bundles
* Offer free box as reward for purchase

= PRO Features =

All features of the free version, plus:

* Weights for items to define relative chance of winning item in box
* Rarity classes: common - 50, uncommon - 30, rare - 15, epic - 4, legendary - 1
* Opening animation
* Custom sounds (rolling, opening, rare, legendary)
* Confetti animation on win
* Premium support: Direct access to our ticket support system at https://wpgenie.org/support/



== Installation ==

= Minimum Requirements =

* WordPress 5.0 or greater
* WooCommerce 5.0 or greater

= Setup =

This section describes how to install Mysterx - Mystery Boxes for WooCommerce plugin and get it working.

1. Upload the plugin files to the /wp-content/plugins/ directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. New menu in wp-admin will appear called "Mystery Box"
4. New product type will appear called "Mystery box", select that product type
5. Product type "Mystery box" has new product data tab called "Mysterx Boxes", set gifts in this tab
6. Publish your new mystery box product
7. PRO version has option opening animation
8. PRO version has option for sounds (rolling, opening, rare, legendary)
9. PRO version has confetti animation on win


If you have any problems contact us at https://wpgenie.org/

== Screenshots ==

1. Mystery Boxes custom product type
2. Edit Mystery Box product page with settings
3. Mystery Boxes for WooCommerce settings page
4. Frontend: List of gift products in the box
5. Frontend: List of gift products that are marked "gone"

== Changelog ==
= 1.0.2 =
* Description texts

= 1.0.1 =
* List of gift products in the box (in frontend) with settings
* "Open your Mystery Boxes" link on order thank you page which links My Account > Boxes tab

= 1.0.0 =
* First release
