Migrating from WooCommerce Lottery

If your store is currently running the legacy WooCommerce Lottery plugin (and the Pick Ticket Number add-on), migrating to Quantum Competitions for WooCommerce is a seamless, zero-downtime process designed to preserve all your existing data.

---

Why Upgrade to Quantum Competitions?

Quantum Competitions is the modern successor to WooCommerce Lottery:

• Consolidated All-in-One Solution: Merges the core lottery engine and the manual ticket picker add-on into a single, cohesive codebase while adding built-in Instant Wins, Lucky Dip, and HPOS support out of the box (no separate add-ons to manage).
• Full HPOS Compatibility: Built for WooCommerce High-Performance Order Storage and custom order tables.
• Quantum Random Engine: True quantum vacuum fluctuation randomness via ANU Quantum and Wpgenie Quantum Randomizer with public verification audit trails.
• Live Streaming Ready: Includes a full-screen Live Draw Wheel console and transparent OBS browser source overlays.
• Modern Reveal Games: Replaces static text with interactive HTML5 Scratch Cards, Flip Cards, Fortune Wheels, and Mystery Cases.

---

Zero Data Loss Guarantee

Quantum Competitions is engineered with 100% backward compatibility:

1. Existing Products: Your existing lottery products (post_type: product, product type: lottery) remain untouched and instantly gain all Quantum Competitions features.
2. Database Tables: Ticket logs and reservations use the same battle-tested tables:
   • {$wpdb->prefix}wc_lottery_log
   • {$wpdb->prefix}wc_lottery_pn_log
   • {$wpdb->prefix}wc_lottery_pn_reserved
   • {$wpdb->prefix}wc_lottery_pn_instantwin
   • {$wpdb->prefix}wc_lottery_pn_instant_prizes Every past order, customer ticket number, and winner history record is 100% preserved.
3. Automatic Settings Migration: On first activation, the plugin scans for legacy settings (lottery_*, woocommerce_lottery_*, and simple_lottery_*) and automatically converts them to the modern qcw_* schema.
4. Shortcode & Hook Aliases: Legacy shortcodes like [lottery], [my_lotteries], [lottery_winners], and [featured_lotteries] continue working without modifying your existing pages.

---

Step-by-Step Migration Guide

Upgrading takes less than 3 minutes:

Step 1: Create a Backup (Recommended Best Practice)

Before making any plugin changes on a production store, take a standard backup of your WordPress database and /wp-content/ directory.

---

Step 2: Deactivate Legacy Plugins

In your WordPress Dashboard, navigate to Plugins > Installed Plugins and Deactivate (do not delete data):

• ❌ WooCommerce Lottery
• ❌ WooCommerce Lottery - Pick Ticket Number (if installed)

Data Preservation

Deactivating these plugins does not delete any of your ticket records, orders, or products. All database records remain safely in place.

---

Step 3: Install & Activate Quantum Competitions

1. In Plugins > Add New > Upload Plugin, select quantum-competitions-for-woocommerce.zip.
2. Click Install Now, then click Activate Plugin.
3. Quantum Competitions detects the existing tables and automatically executes the migration routine in the background.

---

Step 4: Verify Settings & Activate License

1. Navigate to Competitions > Settings > License.
2. Activate your license using either WPGenie Account Login or your Site Key.
3. Go through Competitions > Settings > General and Display to review any new features (such as Instant Reveal animation styles or Status Badges).
4. Check an existing competition on the frontend to confirm ticket counts and countdown timers are running smoothly.

---

Need Assistance?

If you have custom child theme template overrides or specialized custom code from your legacy setup, our team can help ensure a flawless transition. Contact us via the Competitions > Support desk or directly at wpgenie.org/support.