Spin Wheel

⌘K
  2. Home
  4. Docs
  6. Spin Wheel
  8. Troubleshooting
  10. Common Issues & Quick Fixes

Common Issues & Quick Fixes

“It’s Not Working!” – Let’s Fix It.

Welcome to the troubleshooting center. WordPress is a massive ecosystem with thousands of themes and plugins. While Ultimate Spin Wheel is built to be compatible with standard WordPress coding standards, sometimes conflicts happen.

This guide covers the “General” issues that don’t fit into specific categories like Email or Display. If you are experiencing weird visual glitches, button failures, or activation errors, start here.

1. Visual & Design Glitches

“The Wheel looks ‘Broken’ or Unstyled”

Symptom: The text is Times New Roman, the colors are missing, or the images are scattered all over the screen. The Cause: CSS Caching or “Minification” errors.

  • Explanation: Many “Speed Optimization” plugins (like Autoptimize, WP Rocket, or SiteGround Optimizer) try to combine all CSS files into one to make your site faster. Sometimes, they break the order of the code.
  • The Fix:
    1. Clear Cache: Purge your caching plugin and your browser cache.
    2. Exclude CSS: Go to your optimization plugin settings and look for “Exclude CSS from Minification”. Add uspw-style.css to the list.
    3. Check 404s: Open Chrome Developer Tools (F12) > Network Tab. Refresh the page. If you see red “404 Not Found” errors for .css or .png files, your installation might be corrupted. Re-install the plugin.

“The Popup is Hidden Behind My Menu”

Symptom: You can see the wheel, but your website’s sticky header (or a chat widget) is covering the “Spin” button. The Cause: Z-Index (Stacking Order).

  • The Fix: You need to tell the browser that the Wheel is the “Top Layer.”
    1. Go to Spin Wheel > Settings > General.
    2. Look for the “Custom CSS” box.
    3. Paste this code:.uspw-popup-container { z-index: 99999999 !important; }
    4. Save and refresh.

2. Functionality & Logic Issues

“I click ‘Spin’ but nothing happens”

Symptom: You click the button, the animation doesn’t start, and no error message appears. It just sits there. The Cause: JavaScript Conflict.

  • Investigation:
    1. Right-click the page > Inspect > Console.
    2. Do you see red text?
    3. “jQuery is not defined”: Your theme is loading scripts incorrectly (too late in the footer).
    4. “403 Forbidden”: Your security plugin (Wordfence, iThemes) is blocking the AJAX request because it thinks the spin is a “hack attempt.”
  • The Fix:
    • For Security Plugins: Go to your Firewall settings and “Whitelist” the action ultimate_spin_wheel_process_spin.
    • For Theme Issues: Try switching to a default theme (like Twenty Twenty) temporarily. If it works, contact your theme developer.

“It works for me, but guests can’t see it”

Symptom: You (the Admin) see the wheel perfectly. But when you check on your phone (logged out), it’s gone. The Cause: Server-Side Caching.

  • Explanation: Your hosting provider (Bluehost, WP Engine, Cloudflare) caches the “Static” version of your page to serve it faster to guests. If the cached version “thinks” the wheel is hidden, it will serve that hidden version to everyone.
  • The Fix:
    1. Clear your Server Cache (usually a button in the top admin bar).
    2. Clear your CDN Cache (Cloudflare).
    3. Exclude the cookie uspw_already_played from caching if your host allows it.

3. License & Update Issues

“Invalid License Key”

Symptom: You paste your key, click Activate, and it says “Invalid” or “Connection Failed.” The Cause: Typo or Server Block.

  • The Fix:
    1. Check Spaces: Make sure you didn’t copy a “space” at the end of the key.
    2. Firewall: Some strict firewalls block our activation server. Contact your host and ask them to allow outgoing requests to api.wowdevs.com.
    3. Reset: Go to Settings > License, click “Deactivate” (if available), and try again.

“Changes I make aren’t saving”

Symptom: You change the probability from 10% to 50%, click Save, but when you reload, it’s back to 10%. The Cause: Database Permissions or Object Cache.

  • The Fix:
    1. Object Cache: If you use Redis or Memcached, flush it.
    2. Database: Check if your MySQL user has UPDATE permissions. (Ask your host).

4. Frequently Asked Questions (FAQ)

Q: Will this slow down my site? A: No. The wheel assets (CSS/JS) only load on pages where the wheel is active. We use “Conditional Loading” to keep your site fast.

Q: Does it work with Elementor / Divi? A: Yes. The plugin runs independently of page builders. It hooks into the wp_footer action, which is standard on all WordPress themes.

Q: Can I reset all data and start over? A: Yes. If you uninstall and choose “Delete Data” in the settings, all leads and campaigns will be wiped. (Back up first!).

Conclusion

Most issues are caused by Browser Caching or Plugin Conflicts. Before contacting support, always try opening your site in an Incognito Window. If it works there, the issue is just your browser cache!

How can we help?