Email Codes Not Arriving
Test Email Functionality:
// Install Check Email plugin
or
// Send test email from Settings → Email
Solutions:
- Check spam/junk folders
- Verify email address is correct
- Configure SMTP plugin (WP Mail SMTP)
- Contact hosting provider about email deliverability
QR Code Won’t Scan
- ✅ Use Google Authenticator or Microsoft Authenticator app
- ✅ Ensure good lighting when scanning
- ✅ Try manual entry with secret key
- ✅ Generate new QR code if corrupted
Verification Codes Invalid
Time Sync Issues:
// Server and device must have accurate time
- Check server time: date command
- Check device time settings
- Time difference > 30 seconds causes failures
Locked Out After Enabling 2FA
Admin Recovery:
// Disable 2FA via database (emergency only)
UPDATE wp_usermeta
SET meta_value = '0'
WHERE meta_key = 'attrua_2fa_enabled'
AND user_id = YOUR_USER_ID;
Use Backup Codes:
- Enter backup code instead of regular code
- Each backup code works only once
- Generate new codes after using all
Prevention Tips
- ✅ Save backup codes when setting up 2FA
- ✅ Test 2FA before enforcing for all users
- ✅ Provide clear setup instructions
- ✅ Have admin recovery procedure documented
