Spin Wheel

⌘K
  2. Home
  4. Spin Wheel
  6. Overview
  8. System Requirements & Compatibility

System Requirements & Compatibility

System Requirements & Compatibility

The Ultimate Spin Wheel plugin is built to be lightweight and compatible with the vast majority of WordPress environments. Like any modern software, though, it has a few server requirements that must be met to run correctly. Meeting them prevents common issues such as a blank “white screen,” failed database writes, or slow loading, and keeps the visual builder working smoothly.

1. Core Technical Requirements

Before installing, verify your server environment against this checklist. These are the versions declared in the plugin header, so activation may be blocked on anything lower.

PHP Version

  • Required: PHP 7.4 or higher (the plugin declares Requires PHP: 7.4).
  • Recommended: PHP 8.1 or higher.
  • Why? The plugin uses modern PHP for security and speed. Older, End-of-Life versions (5.6, 7.2) pose real security risks and are not supported.

WordPress Version

  • Required: WordPress 6.1 or higher (the plugin declares Requires at least: 6.1).
  • Recommended: The latest stable release.
  • Why? The admin builder relies on the modern Block Editor (Gutenberg) APIs and the React libraries bundled with recent WordPress core.

Database

  • MySQL: 5.6 or greater, or MariaDB 10.1 or greater.
  • Why? On activation the plugin creates a single custom table (wp_wdengage_entries) that stores every lead and spin entry. Your analytics and lead dashboard are computed from that table, so a healthy database version keeps queries fast and data intact.

Browser Compatibility

  • Supported: Modern versions of Chrome, Firefox, Safari, and Edge.
  • Not supported: Internet Explorer 11.
  • Note: The front-end wheel is built on HTML5 Canvas and the admin builder is a React app. Both need modern JavaScript and will not load in legacy browsers.

2. Server Configuration & Limits

Sometimes a server meets the version requirements but has restrictive resource limits. These recommendations keep the admin dashboard and background tasks running comfortably.

Memory Limit

  • Recommended: 256MB or higher (memory_limit).
  • Minimum: 128MB.
  • Issue: A low memory limit can trigger fatal errors when loading detailed analytics reports or exporting large lead lists to CSV/Excel.

Execution Time

  • Recommended: 300 seconds (max_execution_time).
  • Why? The wheel itself is fast, but background tasks such as the database update on a plugin upgrade need room to finish without timing out.

File Permissions

  • Directories: 755
  • Files: 644
  • Why? These are the standard WordPress permissions. Correct ownership and permissions ensure the plugin loads its bundled assets and updates cleanly.

3. WooCommerce Compatibility

WooCommerce is optional — the wheel works perfectly for lead capture on any WordPress site. You only need WooCommerce if you plan to hand out its coupon codes as prizes.

  • Version: WooCommerce 4.0 or higher.
  • Coupons enabled: Make sure “Enable the use of coupon codes” is checked in WooCommerce → Settings → General. If coupons are disabled globally, won codes cannot be redeemed at checkout.
  • Note: In the free plugin you attach Static or Unique Pool coupon codes to a slice. Automatically generating a unique clone of a master coupon per winner (WooCommerce Dynamic and Auto Generate types) and auto-applying it to the cart are (Pro) features.

4. Conflict Troubleshooting

The WordPress ecosystem is vast, and conflicts occasionally happen. Here are the most common ones and how to resolve them.

Caching Plugins

  • Symptom: You update the wheel design but the old design keeps showing.
  • Solution: After making changes, clear the cache in tools like WP Rocket, Autoptimize, or LiteSpeed Cache — including any minified CSS/JS cache. If you see visual glitches, exclude the plugin’s assets from aggressive JS/CSS minification.

Security & Firewall Plugins

  • Symptom: You cannot save a campaign (a 403 Forbidden error).
  • Solution: Firewalls like Wordfence or Solid Security (formerly iThemes Security) can falsely flag a save request that contains rich content — for example a custom winner-email template (Pro). Whitelist the plugin’s admin-ajax operations in your firewall if this happens.

Page Builders

Elementor, Divi, and Beaver Builder are fully compatible. When used as a Popup layout the wheel is a global overlay that sits on top of your page content, so it never interferes with a page builder’s layout grid.

5. Hosting Recommendations

The plugin runs happily on shared hosting, but performance scales with hosting quality.

  • Shared hosting (Bluehost, GoDaddy, etc.): Works fine for small to medium traffic.
  • Managed WordPress (Kinsta, WP Engine, etc.): Recommended for high-traffic sites. Their object caching (often Redis) keeps the admin dashboard and analytics snappy.

Related Documentation

Conclusion

Most users never need to think about this page. If you are on a reputable host running current PHP and WordPress, you already meet every requirement. If you are unsure of your configuration, a “System Info” plugin or a quick note to your hosting support will confirm your PHP version, memory limit, and database version. Ready to get started? Head to Download & License Activation.

How can we help?