# WinRocket — Full Reference Manual

This manual contains the detailed setup guides, customer experiences, and verification workflows verified to exist within the WinRocket WooCommerce plugin.

---

## 1. Installation & License Activation
WinRocket requires standard WordPress and WooCommerce environments to deploy correctly.

### Installation Steps
1. Download the ZIP file for the premium version from your account dashboard.
2. In the WordPress admin panel, go to **Plugins → Add New → Upload Plugin**.
3. Select the premium ZIP file and click **Install Now**.
4. Once the upload completes, click **Activate Plugin**.

### License Activation
1. Navigate to the new **WinRocket** menu item in your WordPress admin sidebar.
2. Go to **Settings → License Setup**.
3. Input your Pro license key in the provided field.
4. Click the activation button to verify and activate the software.

---

## 2. Customer Experience & Checkout Journey
This section describes the standard transactional workflow for customers participating in giveaway campaigns.

### Journey Outline
1. **Browse:** Customers view giveaway items in the WooCommerce store. Individual product pages display custom countdown timers and campaign progress bars showing remaining entries.
2. **Ticket Selection:** Customers choose ticket quantities. The product layout supports manual quantity selections, range sliders, or manual seat/ticket pickers.
3. **Cart & Checkout:** Selected tickets are added to the WooCommerce cart as native items. The store can optionally display a Lucky Wheel pop-up on the cart or checkout page.
4. **Payment & Generation:** Customers complete checkout using standard WooCommerce gateways.
5. **Confirmation:** Customers receive a system transactional email listing their generated ticket numbers.
6. **Winner Draw:** Once the campaign ends, the store owner draws a winner, and results are published on the website's reveal panel.

---

## 3. Core Campaign Structures

### Giveaways & Lotteries
Allows store owners to designate WooCommerce products as giveaway items. Draws can be set to run on auto-close dates or triggered manually.

### Lucky Wheel
An interactive spin-to-win wheel. Store owners define segment colors, prizes (such as custom discount codes or credits), and select weight-based odds for each prize segment.

### Credit Wallet
A virtual currency wallet. Customers earn credits from store actions (purchases, reviews, referrals) and spend credits to buy tickets in active campaigns.

---

## 4. FAQs & Common Troubleshooting

### Q: Why aren't campaigns ending automatically at the scheduled close date?
**A:** WinRocket relies on WordPress cron (`wp-cron.php`) to execute scheduled drawings. If a website experiences low traffic volume, the cron system may not trigger on time. Setting up a system-level server cron task pointing to your site's cron URL every 5 to 10 minutes ensures accurate draw endings.

### Q: How are ticket lists handled if an order is refunded?
**A:** If a WooCommerce order containing tickets is marked as Refunded or Cancelled, the associated ticket entries are automatically removed from the active raffle draw pool.