Common Issues and Solutions

Introduction

This guide covers the most common issues users encounter with Secure User Registration by PureDevs and provides step-by-step solutions. Most issues can be resolved quickly with the solutions outlined below.

Installation and Activation Issues

Plugin Won’t Activate

Symptoms:

• Error message when clicking “Activate”
• Plugin appears inactive after activation attempt
• White screen or fatal error

Solutions:

1. Check WordPress Version:
   • Go to Dashboard → Updates
   • Ensure you’re running WordPress 3.5 or higher
   • Update WordPress if needed
2. Verify PHP Version:
   • Go to Tools → Site Health → Info
   • Check PHP version is 7.0 or higher
   • Contact hosting provider to upgrade if needed
3. Check for Plugin Conflicts:
   • Deactivate all other plugins
   • Try activating Secure User Registration
   • If successful, reactivate other plugins one by one
   • Identify which plugin causes the conflict
4. Increase PHP Memory Limit:
   • Add to wp-config.php: define('WP_MEMORY_LIMIT', '256M');
   • Or contact hosting provider to increase memory

Settings Page Not Appearing

Symptoms:

• No “Safe Registration” option in Settings menu
• Can’t find plugin settings

Solutions:

1. Verify plugin is activated (Plugins → Installed Plugins)
2. Check you’re logged in as Administrator
3. Clear browser cache and refresh
4. Try accessing directly: yoursite.com/wp-admin/options-general.php?page=safe-registration-settings
5. Deactivate and reactivate the plugin

Protection Not Working

CSRF Protection Not Blocking Invalid Submissions

Symptoms:

• Forms submit successfully even with expired nonces
• No security validation occurring

Solutions:

1. Verify Settings:
   • Go to Settings → Safe Registration
   • Ensure “Protect user Registration” is checked
   • Ensure “Enable Nonce” is checked
   • Click Save Changes
2. Check for Caching Issues:
   • Clear all caches (site cache, browser cache, CDN cache)
   • Exclude registration pages from caching
   • Test in private/incognito browser window
3. Test Form Directly:
   • View page source
   • Look for hidden nonce fields in the form
   • If missing, plugin may not be hooking properly
4. Check for Theme Conflicts:
   • Switch to a default WordPress theme (Twenty Twenty-Four)
   • Test if protection works
   • If yes, contact theme developer

Email Blocking Not Working

Symptoms:

• Blocked emails still able to register
• No error message showing for blocked emails

Solutions:

1. Check Blocklist Syntax:
   • Use @ prefix for domains: @example.com
   • Use commas WITHOUT spaces: @test.com,@example.com
   • No trailing commas
   • No special characters except @ and comma
2. Verify Settings Saved:
   • Check blocklist field still contains your entries
   • Click Save Changes again
   • Check for save confirmation message
3. Test with Simple Entry:
   • Add just one test entry: test@test.com
   • Save settings
   • Try registering with test@test.com
   • Should show error message
4. Check Protection is Enabled:
   • Verify “Protect user Registration” is checked
   • For WooCommerce, verify “Protect WooCommerce user Registration” is checked

User Experience Issues

Users Frequently Seeing Nonce Errors

Symptoms:

• Legitimate users getting “Invalid nonce error” messages
• High rate of registration failures

Solutions:

1. Check Caching Configuration:
   • Exclude registration pages from full-page caching
   • Disable caching for /wp-login.php
   • Disable caching for WooCommerce My Account page
2. Review Time Synchronization:
   • Ensure server time is correct
   • Check WordPress timezone setting
   • Nonces rely on accurate server time
3. Adjust Nonce Lifetime (Advanced):
   • WordPress default: 12-24 hours
   • Contact developer to customize if needed
4. Update Error Message:
   • Provide clearer instructions
   • Example: “Please refresh the page and try again”

Legitimate Emails Being Blocked

Symptoms:

• Real users can’t register with valid emails
• Complaints about email restrictions

Solutions:

1. Review Blocklist:
   • Check for overly broad domain blocks
   • Example: @mail.com blocks legitimate Gmail users if they use @gmail.com
   • Be specific with blocks
2. Check Syntax Errors:
   • Extra spaces can cause issues
   • Missing @ prefix blocks exact match only
   • Verify comma-separated format
3. Create Whitelist Alternative:
   • Instead of blocking many domains, allow specific ones
   • Note: Plugin doesn’t have whitelist feature built-in
   • Contact developer for custom solution

WooCommerce-Specific Issues

Protection Not Working on WooCommerce Forms

Symptoms:

• WordPress registration protected, but WooCommerce registration not protected
• reCAPTCHA not appearing on My Account page

Solutions:

1. Enable WooCommerce Protection:
   • Go to Settings → Safe Registration
   • Check “Protect WooCommerce user Registration”
   • Click Save Changes
2. Verify WooCommerce is Active:
   • Go to Plugins → Installed Plugins
   • Ensure WooCommerce is activated
3. Check Registration is Enabled:
   • Go to WooCommerce → Settings → Accounts & Privacy
   • Verify “Allow customers to create an account on the ‘My account’ page” is checked
4. Clear WooCommerce Cache:
   • WooCommerce has its own caching
   • Clear WooCommerce transients
   • Test in incognito window

reCAPTCHA Appearing Twice on WooCommerce Forms

Symptoms:

• Two reCAPTCHA widgets visible
• Duplicate checkboxes

Solutions:

1. Check for Conflicts:
   • Another plugin may be adding reCAPTCHA
   • Deactivate other security plugins temporarily
   • Identify conflicting plugin
2. WooCommerce Extensions:
   • Some WooCommerce extensions add their own reCAPTCHA
   • Disable one or the other

Settings and Configuration Issues

Settings Not Saving

Symptoms:

• Changes revert after clicking Save Changes
• No success message appears

Solutions:

1. Check User Permissions:
   • Ensure you’re logged in as Administrator
   • Check user has manage_options capability
2. File Permissions:
   • Check WordPress can write to database
   • Verify wp-config.php database credentials
3. Browser Issues:
   • Clear browser cache
   • Try different browser
   • Disable browser extensions
4. Check for JavaScript Errors:
   • Open browser console (F12)
   • Look for errors when clicking Save
   • Report errors to support

Can’t Access Settings Page

Symptoms:

• 404 error or blank page
• Permission denied error

Solutions:

1. Ensure you’re logged in as Administrator
2. Try direct URL: /wp-admin/options-general.php?page=safe-registration-settings
3. Deactivate and reactivate plugin
4. Check for .htaccess issues blocking access

Performance Issues

Slow Registration Forms

Symptoms:

• Forms take long time to load
• Delay when submitting registration

Solutions:

1. Check reCAPTCHA Loading:
   • reCAPTCHA loads external JavaScript from Google
   • Can add 1-2 seconds to page load
   • This is normal and unavoidable if using reCAPTCHA
2. Optimize Server Response:
   • Ensure server can communicate with Google quickly
   • Check DNS resolution speed
   • Consider server location relative to Google servers
3. Review Overall Site Performance:
   • Problem may not be plugin-related
   • Check hosting performance
   • Use performance testing tools

Getting Additional Help

If these solutions don’t resolve your issue:

Before Contacting Support

1. Document the exact error message or behavior
2. Note your WordPress version and PHP version
3. List other active plugins
4. Note your theme name and version
5. Take screenshots if applicable
6. Check browser console for JavaScript errors

Where to Get Help

• WordPress.org Support Forum: Search existing threads or post new question
• Plugin Documentation: Review all documentation articles
• PureDevs Support: Contact through the support channels

Preventing Future Issues

Best Practices

• Keep WordPress Updated: Update to latest stable version
• Keep Plugin Updated: Install updates when available
• Regular Backups: Backup before making configuration changes
• Test After Changes: Always test registration after changing settings
• Monitor Registration: Regularly check that legitimate users can register
• Document Settings: Keep notes on your configuration