Troubleshoot Cookie Banner Issues

Common Cookie Banner Problems & Solutions

Banner Not Displaying

Problem: Cookie banner doesn’t appear on website

Symptoms:

1. Banner completely missing from all pages
2. No consent prompt shown to visitors
3. Console errors related to banner scripts

Solutions:

4. Check Module Status

`
SLOS → Settings → Modules
`
Ensure “Consent Management” is enabled

5. Verify Banner Configuration

`
SLOS → Consent Management → Banner Settings
`
– Check if banner is set to “Enabled”
– Verify display conditions are met
– Confirm banner position is set

6. Check Theme Conflicts

– Disable other consent plugins temporarily
– Switch to default WordPress theme
– Check for JavaScript errors in browser console

7. Clear Caches

– Clear WordPress cache (if using caching plugin)
– Clear browser cache and cookies
– Hard refresh the page (Ctrl+F5)

Problem: Banner displays but doesn’t work properly


Symptoms:

8. Banner appears but buttons don’t respond
9. Consent choices aren’t saved
10. Banner reappears on every page load

Solutions:

11. Check JavaScript Errors

Open browser developer tools (F12) and check Console tab for errors

12. Verify Cookie Settings

`
SLOS → Consent Management → Cookie Settings
`
– Ensure cookies are properly configured
– Check cookie expiration settings
– Verify cookie domain settings

13. Test Consent Storage

– Accept cookies and check if they’re stored
– Use browser dev tools → Application → Cookies
– Look for slosconsent* cookies

Consent Not Being Saved


Problem: User consent choices aren’t remembered


Symptoms:

14. Banner reappears on every visit
15. Consent preferences reset
16. Cookies blocked despite consent

Solutions:

17. Check Cookie Domain

`
SLOS → Consent Management → Advanced Settings
`
– Ensure cookie domain matches your site
– For subdomains, use .domain.com
– Check for www vs non-www issues

18. Verify SSL Configuration

– Consent cookies require HTTPS in most browsers
– Check SSL certificate validity
– Ensure site loads over HTTPS

19. Browser Privacy Settings

– Some browsers block third-party cookies
– Check browser privacy settings
– Test in incognito/private mode

20. Cookie Expiration

– Check cookie lifetime settings
– Default is usually 1 year
– Adjust based on your needs

Banner Styling Issues


Problem: Banner looks wrong or overlaps content


Symptoms:

21. Banner covers important content
22. Styling conflicts with theme
23. Banner appears in wrong position
24. Colors don’t match site design

Solutions:

25. Adjust Banner Position

`
SLOS → Consent Management → Banner Design
`
– Try different positions: top, bottom, corner
– Adjust z-index if overlapping
– Test on mobile devices

26. Custom CSS Fixes

`css
/ Add to theme custom CSS /
.slos-consent-banner {
z-index: 999999 !important;
}

.slos-consent-banner .banner-content {
max-width: 1200px;
margin: 0 auto;
}
`

27. Theme Integration

– Use theme hooks to position banner
– Check for theme-specific CSS conflicts
– Test with different themes

Geo-Targeting Problems


Problem: Wrong banner shown for location


Symptoms:

28. Wrong language or regulations shown
29. Banner not appearing in certain countries
30. Incorrect geo-detection

Solutions:

31. Check Geo-Detection

`
SLOS → Consent Management → Geo-Targeting
`
– Verify IP geolocation service is working
– Check API key if using paid service
– Test with different IP addresses

32. Update Geo-Rules

– Review country-specific rules
– Check for EU/EEA country list updates
– Verify regional compliance settings

33. Fallback Settings

– Configure default banner for unknown locations
– Set global fallback rules
– Test with VPN or proxy

Mobile Display Issues


Problem: Banner doesn’t work properly on mobile


Symptoms:

34. Banner too small on mobile
35. Buttons hard to tap
36. Banner covers mobile navigation
37. Text not readable on small screens

Solutions:

38. Mobile Optimization

`
SLOS → Consent Management → Banner Design
`
– Enable mobile-specific settings
– Adjust banner size for mobile
– Test touch targets (minimum 44px)

39. Responsive Design

– Check banner responsiveness
– Test on various screen sizes
– Verify mobile browser compatibility

40. Mobile-Specific CSS

`css
@media (max-width: 768px) {
.slos-consent-banner {
position: fixed !important;
bottom: 0 !important;
width: 100% !important;
}
}
`

Integration Conflicts


Problem: Banner conflicts with other plugins


Symptoms:

41. Multiple consent banners appearing
42. JavaScript errors from conflicts
43. Features not working together
44. Performance issues

Solutions:

45. Plugin Conflict Resolution

– Temporarily disable other consent plugins
– Check plugin compatibility lists
– Update all plugins to latest versions
– Use plugin conflict detection tools

46. JavaScript Conflicts

– Check for duplicate jQuery loading
– Resolve script loading order issues
– Use script defer/async attributes
– Minify and combine scripts

47. Theme Conflicts

– Test with default WordPress theme
– Check theme JavaScript conflicts
– Use child theme for customizations
– Contact theme developer for compatibility

Performance Issues


Problem: Banner slows down website


Symptoms:

48. Slow page loading times
49. High CPU usage
50. Large JavaScript bundle size
51. Poor Core Web Vitals scores

Solutions:

52. Optimize Loading

`
SLOS → Consent Management → Performance
`
– Enable lazy loading
– Use CDN for assets
– Minify CSS and JavaScript
– Enable browser caching

53. Reduce Bundle Size

– Disable unused features
– Use tree shaking for JavaScript
– Optimize images and assets
– Enable compression

54. Caching Strategies

– Implement proper caching headers
– Use service worker for caching
– Enable browser caching
– Use CDN for global delivery

Cookie Scanner Issues


Problem: Cookie scanner not finding cookies


Symptoms:

55. Empty cookie inventory
56. Missing third-party cookies
57. Scanner not detecting dynamic cookies

Solutions:

58. Scanner Configuration

`
SLOS → Consent Management → Cookie Scanner
`
– Enable all scanner options
– Configure scan frequency
– Set up automated scanning
– Check scanner permissions

59. Manual Cookie Detection

– Use browser dev tools to inspect cookies
– Check network tab for cookie setting
– Manually add undetected cookies
– Update cookie database

60. Dynamic Content Scanning

– Enable JavaScript execution during scans
– Configure user interaction simulation
– Set up authenticated scanning
– Use headless browser scanning

Analytics Integration Problems


Problem: Consent events not tracking properly


Symptoms:

61. Missing consent events in analytics
62. Incorrect consent status tracking
63. Analytics platform connection issues

Solutions:

64. Platform Connection

`
SLOS → Analytics Integration → Platform Settings
`
– Verify API keys and credentials
– Check platform connectivity
– Test authentication
– Review error logs

65. Event Configuration

– Verify event mapping
– Check consent status passing
– Test event firing
– Validate event parameters

66. Debug Analytics

– Use platform debug tools
– Check browser developer console
– Verify event queue
– Test with different scenarios

Legal Compliance Issues


Problem: Banner not meeting legal requirements


Symptoms:

67. Non-compliant with GDPR/CCPA
68. Missing required information
69. Incorrect consent mechanisms

Solutions:

70. Compliance Check

`
SLOS → Consent Management → Compliance
`
– Run compliance audit
– Check regulation requirements
– Update banner content
– Verify consent mechanisms

71. Legal Review

– Consult with legal counsel
– Update privacy policies
– Review consent wording
– Document compliance decisions

72. Regulation Updates

– Stay updated on regulation changes
– Update banner for new requirements
– Review geo-targeting rules
– Monitor compliance deadlines

Advanced Troubleshooting


Debug Mode


Enable Debug Logging


`php
// Add to wp-config.php
define(‘WP_DEBUG’, true);
define(‘WPDEBUGLOG’, true);
define(‘SLOS_DEBUG’, true);
`

Check Debug Logs


`
wp-content/debug.log
`

System Diagnostics


Run Diagnostics


`
SLOS → Settings → Diagnostics
`

73. Check system requirements
74. Verify file permissions
75. Test database connections
76. Review configuration settings

Support Resources


Get Help


77. Check this troubleshooting guide
78. Review error logs
79. Test in staging environment
80. Contact support with diagnostic information

Diagnostic Information


81. WordPress version
82. PHP version
83. Plugin version
84. Browser console errors
85. Server error logs
86. Configuration export

Prevention Tips


Regular Maintenance


87. Update plugin regularly
88. Monitor error logs
89. Test banner functionality
90. Review compliance status

Best Practices


91. Use staging environment for testing
92. Document customizations
93. Keep backups of configurations
94. Monitor performance metrics

Proactive Monitoring


95. Set up uptime monitoring
96. Monitor consent rates
97. Track error rates
98. Review analytics data