Skip to main content

Troubleshooting

Activation Emails Not Arriving​

Check Email Delivery Configuration​

Symptoms:

  • Users not receiving activation codes
  • No email in inbox or spam

Solutions:

  1. Install SMTP Plugin (Recommended)

  2. Test Email Functionality

    // Add to functions.php temporarily
    wp_mail('your@email.com', 'Test Email', 'Testing WordPress email');

  3. Check Server Email Logs

    • Contact hosting provider
    • Check if emails are being sent but blocked

  4. Verify Email Address

    • Check user profile for correct email
    • Test with different email provider (Gmail, Outlook)

Users Can't Access Activation Page​

Page Not Found (404 Error)​

Cause: Page slug incorrect or permalinks not flushed

Solution:

  1. Navigate to Pages → All Pages
  2. Verify page slug is exactly account-activate
  3. Go to Settings → Permalinks
  4. Click "Save Changes" (no changes needed, just save)

Redirect Loop​

Cause: Page conflict or plugin conflict

Solution:

  1. Verify activation page contains [loginberry_account_activate] shortcode
  2. Deactivate other plugins temporarily to test
  3. Switch to default WordPress theme (Twenty Twenty-Four)
  4. Check browser console for JavaScript errors

Activation Code Not Working​

"Invalid Code" Error​

Possible causes:

  • Code entered incorrectly
  • Code expired (if custom expiration implemented)
  • Database issue

Solutions:

  1. Resend Code

    • Navigate to Users → All Users
    • Click "Send Activation Code" for user
    • Try new code

  2. Check User Meta

    // Check activation code
    $code = get_user_meta($user_id, '_berrypress_activation_code', true);

  3. Manually Activate

    • Use admin link to activate user without code

Account Locked After Multiple Attempts​

Cause: User entered wrong code 15 times

Solution:

  1. Navigate to Users → All Users
  2. Find locked user (🔒 icon)
  3. Click red "Unlock Account" link
  4. Optionally: Manually activate user

Shortcode Not Rendering​

Blank Activation Page​

Cause: Plugin not activated or shortcode syntax error

Solution:

  1. Verify LoginBerry is activated (Plugins → Installed Plugins)
  2. Check shortcode syntax: [loginberry_account_activate]
  3. Edit page in Code Editor view, not page builder
  4. Try WordPress default editor (Classic or Block)

Page Builder Conflicts​

Common conflicts:

  • Elementor
  • Beaver Builder
  • WPBakery

Solution:

  1. Use WordPress Block Editor instead
  2. Add shortcode using WordPress Shortcode block
  3. Contact page builder support for shortcode compatibility

Admin Column Not Showing​

"Account Activated" Column Missing​

Cause: Screen Options setting or plugin conflict

Solution:

  1. Navigate to Users → All Users
  2. Click "Screen Options" (top right)
  3. Check "Account Activated" checkbox
  4. If not visible, deactivate other plugins temporarily

Styling Issues​

Form Looks Broken​

Cause: Theme CSS conflicts

Solution:

LoginBerry uses standard WordPress classes:

  • wp-block-group
  • wp-block-input
  • wp-block-button

  1. Check Theme Compatibility

    • Test with Twenty Twenty-Four theme
    • Report theme-specific issues on support forum

  2. Add Custom CSS

    /* Add to Appearance → Customize → Additional CSS */
    .loginberry-activation-form {
        max-width: 500px;
        margin: 0 auto;
    }

    .loginberry-activation-form input[type="text"] {
        font-size: 24px;
        text-align: center;
        padding: 15px;
    }

Debugging​

Enable WordPress Debug Mode​

Add to wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Check debug log:

wp-content/debug.log

Check User Meta​

// Get all LoginBerry meta for user
$user_id = 123; // Replace with actual user ID
$activated = get_user_meta($user_id, '_berrypress_user_activated', true);
$code = get_user_meta($user_id, '_berrypress_activation_code', true);
$attempts = get_user_meta($user_id, '_berrypress_activation_attempts', true);
$locked = get_user_meta($user_id, '_berrypress_account_locked', true);

var_dump([
    'activated' => $activated,
    'code' => $code,
    'attempts' => $attempts,
    'locked' => $locked
]);

Getting Help​

Before Asking for Support​

  1. Check This Guide - Review all sections
  2. Test Email Delivery - Ensure emails are working
  3. Verify Page Setup - Confirm activation page exists
  4. Test Different Email - Try Gmail, Outlook
  5. Check Browser Console - Look for JavaScript errors

Support Channels​

  • WordPress.org Forum: Plugin Support
  • Feature Requests: Submit via support forum
  • Bug Reports: Include WordPress version, PHP version, theme name

What to Include in Support Request​

  1. WordPress Version: (Dashboard → Updates)
  2. PHP Version: (Dashboard → Site Health)
  3. Theme Name & Version
  4. Active Plugins List
  5. Error Messages (exact text or screenshots)
  6. Steps to Reproduce
  7. What You've Tried

Known Limitations​

Current Version (1.0.0)​

  • Fixed 15 failed attempt limit (customization planned)
  • Fixed activation page URL /account-activate/ (customization planned)
  • No custom redirect after activation (planned)
  • No automatic verification for existing users (planned)
  • No WooCommerce integration (planned)

Useful Resources​

Still Need Help?​

If you've tried all troubleshooting steps and still experiencing issues:

  1. Visit WordPress.org Support Forum
  2. Search for similar issues
  3. Create new support topic with detailed information
  4. Include system details and error messages

We actively monitor the support forum and respond to all requests.