=== Epic Snack Store – Candy & Snacks Affiliate Engine ===
Contributors: epicsnackbox
Tags: candy store, snacks, affiliate, ecommerce, candy shop, snack box
Requires at least: 5.6
Tested up to: 6.7
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a complete candy and snack store with 1,100+ items to your WordPress website and earn commissions on every order.

== Description ==

**Epic Snack Store** turns any WordPress blog, community, or business website into a physical snack and candy store in 60 seconds.

Earn 5%–10% affiliate commissions on physical snack orders with zero inventory, zero warehousing, and zero shipping headaches. All orders are packed and shipped directly by EpicSnackBox.com with **Free US Ground Shipping on orders $35+**.

### 🌟 Key Features

* **1,100+ Curated Treats**: Japanese KitKats, Haribo gummies, sour candy, exotic sodas, chocolates, and mystery crates.
* **Automatic Live Catalog Sync**: Always up-to-date with live inventory, prices, and high-resolution packaging photography.
* **100% Affiliate Monetization**: Set your affiliate ID once, and every product checkout button automatically attaches your referral tag (`?r=YOUR_ID`).
* **Instant Client-Side Search & Filters**: Visitors can search by flavor or brand, filter by category pills, and sort by price or popularity without page reloads.
* **Responsive Quick View Modal**: Let visitors explore descriptions and nutritional highlights before ordering.
* **Interactive Snack Roulette Widget**: Boost visitor engagement with an animated "Spin the Wheel" treat game.
* **Ultra-Lightweight & Fast**: Built-in transient caching ensures lightning-fast page loading with minimal server resource usage.

### 📋 Shortcodes

* `[epic_snack_store]` &mdash; Full interactive storefront with search, category tabs, and product cards.
* `[epic_snack_bestsellers limit="6"]` &mdash; Compact bestseller showcase for sidebars or blog posts.
* `[epic_snack_roulette]` &mdash; Interactive Mystery Snack Roulette game.

== Installation ==

1. Upload the `epic-snack-store` folder to the `/wp-content/plugins/` directory, or upload the `.zip` file via Plugins &rarr; Add New &rarr; Upload Plugin.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **Settings &rarr; Epic Snack Store** and enter your EpicSnackBox Affiliate ID (free signup at [epicsnackbox.com/affiliates](https://epicsnackbox.com/affiliates)).
4. A new page "Snack & Candy Shop" (`/candy-store/`) will be created automatically. You can also paste `[epic_snack_store]` into any page or post.

== Frequently Asked Questions ==

= Do I need an inventory or warehouse? =
No! Epic Snack Box handles all inventory, fulfillment, customer service, and direct shipping.

= How do I get paid? =
Enter your Affiliate ID in Settings &rarr; Epic Snack Store. All purchases made through your store buttons earn you affiliate commissions tracked automatically.

= What is the free shipping threshold? =
All orders $35 and above receive Free US Ground Shipping.

== Changelog ==

= 1.0.0 =
* Initial public release with full catalog sync, search, category pills, quick view, and roulette widget.
