Troubleshooting Common Issues

Plugin Won’t Activate

Symptoms

1. “Error activating plugin” message
2. Plugin remains inactive
3. No SLOS menu in admin

Causes & Solutions


Cause: PHP Version Too Old

4. Requirement: PHP 7.4+
5. Solution: Upgrade PHP version with hosting provider
6. Check: SLOS → Settings → System Info to verify

Cause: WordPress Version Incompatible

7. Requirement: WordPress 6.0+
8. Solution: Upgrade WordPress to latest version
9. Check: Dashboard → Updates

Cause: Memory Limit Too Low

10. Requirement: 256MB minimum (512MB recommended)
11. Solution: Add to wp-config.php:

`php
define(‘WPMEMORYLIMIT’, ‘256M’);
define(‘WPMAXMEMORY_LIMIT’, ‘512M’);
`

Cause: File Permissions

12. Issue: Plugin can’t write to directories
13. Solution: Fix permissions:

`bash
chmod -R 755 wp-content/plugins/shahi-legalflowsuite
`

Cause: Conflicting Plugin

14. Issue: Another plugin prevents activation
15. Solution:

1. Deactivate all other plugins
2. Try activating SLOS
3. Re-enable plugins one by one
4. Identify conflicting plugin

Debug Steps


16. Enable WordPress debugging:

`php
// In wp-config.php
define(‘WP_DEBUG’, true);
define(‘WPDEBUGLOG’, true);
define(‘WPDEBUGDISPLAY’, false);
`

17. Check error log:

– Location: /wp-content/debug.log
– Look for SLOS errors
– Note exact error message

18. Contact support with:

– Error message
– PHP version
– WordPress version
– Active plugins list

Dashboard Won’t Load


Symptoms


19. Blank page when clicking SLOS menu
20. “Nonce verification failed” message
21. 500 Internal Server Error

Solutions


Clear WordPress Cache

22. Via plugin (W3 Total Cache, WP Rocket, etc.)
23. Or manually via FTP/SSH:

`bash
rm -rf wp-content/cache/
`

Check User Permissions

24. Verify user has manage_options capability
25. Ensure user is Administrator role
26. Go to Users → Select user → Check “Administrator”

Disable Plugins

27. Deactivate all plugins except SLOS
28. Try accessing dashboard
29. Reactivate plugins one by one
30. Identify culprit

Increase PHP Resources

31. In wp-config.php:

`php
define(‘WPMEMORYLIMIT’, ‘512M’);
settimelimit(300);
`

Check Browser Console

32. Open DevTools (F12)
33. Go to Console tab
34. Look for JavaScript errors
35. Check Network tab for failed requests

Database Tables Not Created


Symptoms


36. “Table doesn’t exist” errors
37. Settings won’t save
38. Blank dashboard metrics

Solutions


Reinstall Database

39. Go to SLOS → Settings → Advanced
40. Click Reinstall Database Tables
41. Wait for completion
42. Check if tables created

Manual Check via phpMyAdmin

43. Open phpMyAdmin
44. Select your database
45. Look for tables starting with slos_
46. If empty, reinstall tables

Check Database Permissions

47. User must have CREATE TABLE permission
48. User must have ALTER TABLE permission
49. User must have INSERT, SELECT, UPDATE, DELETE permissions

Check Disk Space

50. Verify adequate disk space on server
51. Database creation requires space
52. Ask hosting provider if needed

Review Error Log

53. Check /wp-content/debug.log
54. Look for database errors
55. May show permission issues or MySQL version problems

Consent Banner Not Showing


Symptoms


56. Banner doesn’t appear on frontend
57. Users can interact without consenting
58. Cookies set immediately

Solutions


Verify Module Enabled

59. Go to SLOS → Settings → Modules
60. Check “Consent Management” is enabled
61. Click Save if changed

Check Frontend Setting

62. Go to Consent Management → Settings
63. Verify “Enable Banner on Frontend” is checked
64. Verify “Auto-Load Banner” is checked
65. Save settings

Clear Cache Completely

66. Browser cache
67. WordPress cache plugin
68. CloudFlare cache
69. CDN cache
70. Memcached/Redis cache

Check JavaScript Errors

71. Open page in browser
72. Press F12 to open DevTools
73. Go to Console tab
74. Look for red error messages
75. Check Network tab for failed assets

Verify No CSS Conflicts

76. Banner CSS might be hidden
77. Try banner in incognito mode
78. Test with all plugins disabled except SLOS

Check Banner Position

79. Is banner behind other elements?
80. Check z-index conflicts
81. Try different position (top vs bottom)

Cookies Not Being Tracked


Symptoms


82. Consent records empty
83. Cookie inventory shows zero cookies
84. Analytics not recording

Solutions


Verify Scanner Enabled

85. Go to Consent Management → Settings
86. Check “Enable Cookie Scanner” is enabled
87. Click “Run Cookie Scan” manually
88. Wait for completion

Check for JavaScript Errors

89. DevTools Console (F12)
90. Look for errors in consent code
91. Check Network tab for failed loads

Browser Settings Blocking Cookies

92. Test in private/incognito mode
93. Check browser cookie settings
94. Try different browser
95. Test on different device

Test Cookie Setting

96. Accept consent in banner
97. Check browser Storage:

– DevTools → Application → Cookies
– Look for cookie with site domain
– Verify consent value stored

Accessibility Scan Not Running


Symptoms


98. Scan button doesn’t work
99. Progress popup doesn’t appear
100. Scan seems to hang

Solutions


Check Module Enabled

101. Go to SLOS → Settings → Modules
102. Verify “Accessibility Scanner” is enabled
103. Enable if disabled

Increase PHP Timeout

104. In wp-config.php:

`php
define(‘WPMEMORYLIMIT’, ‘512M’);
settimelimit(600); // 10 minutes
`

Increase Server Timeout

105. Edit .htaccess (if using Apache):

`
phpvalue maxexecution_time 600
phpvalue memorylimit 512M
`

Check URL Accessibility

106. Scan must reach your pages
107. Test URL in browser
108. If password protected, disable authentication for scan
109. Verify no IP blocking

Run Single Page Scan

110. Instead of site-wide scan
111. May help identify problematic pages
112. Try scanning homepage first

Check Error Log

113. Location: /wp-content/debug.log
114. Look for accessibility scanner errors
115. May indicate resource issues

DSR Requests Not Sending Emails


Symptoms


116. Users don’t receive verification emails
117. Admin doesn’t get notifications
118. Emails not appearing anywhere

Solutions


Verify SMTP Setup

119. Go to SLOS → Settings → Email
120. Click “Send Test Email”
121. Check admin email for test message
122. If doesn’t arrive, SMTP is misconfigured

Check WordPress Mail Configuration

123. Go to SLOS → System Info
124. Look for “Mail Setup” section
125. Verify mail function not disabled
126. Check mail server logs

Whitelist SLOS Emails

127. Some hosts filter plugin emails
128. Add SLOS emails to whitelist
129. Check spam/trash folder
130. Ask hosting provider

Test Mail Plugin

131. Use “Test Mail” in Settings
132. Check admin email address
133. Verify it’s configured correctly
134. Check spam filters

Review Error Log

135. Location: /wp-content/debug.log
136. Look for mail() function errors
137. May show SMTP connection issues

Document Generation Failing


Symptoms


138. “Error generating document” message
139. Export fails
140. PDF won’t create

Solutions


Verify Company Profile Complete

141. Go to Legal Documents → Company Profile
142. Fill in all required fields
143. Click Save
144. Try generating document again

Check File Permissions

145. Documents need write permission
146. Location: /wp-content/uploads/slos/
147. Fix permissions:

`bash
chmod -R 755 wp-content/uploads/slos/
`

Increase PHP Memory

148. Document generation memory intensive
149. In wp-config.php:

`php
define(‘WPMEMORYLIMIT’, ‘512M’);
`

Check Disk Space

150. Verify adequate space in uploads folder
151. Ask hosting provider if full
152. Clean up old documents if needed

Try Different Format

153. If PDF fails, try HTML export
154. If HTML fails, try JSON export
155. Helps identify specific issue

Test with Simple Template

156. Use “Standard” template
157. Simpler templates need less resources
158. Try more complex after success

Modules Interfering with Each Other


Symptoms


159. Enabling one module breaks another
160. Features stop working
161. Unexpected behavior

Solutions


Check Execution Order

162. Some modules depend on others
163. Module Manager controls order
164. Go to SLOS → Settings → Module Order
165. Re-order if needed

Disable & Re-enable

166. Disable problematic module
167. Click Save
168. Wait 30 seconds
169. Re-enable module
170. Click Save

Clear All Caches

171. WordPress cache
172. Browser cache
173. CDN cache
174. Database cache (Redis/Memcached)

Check for Conflicts

175. Disable all modules
176. Enable one module
177. Test it works
178. Enable next module
179. Test
180. Repeat to find conflict

Reset Module Settings

181. Go to module settings
182. Click “Reset to Defaults”
183. Reconfigure module
184. Test functionality

Performance Issues After Activation


Symptoms


185. Site slow after plugin activation
186. Page load time increased
187. Server CPU usage high

Solutions


Disable Modules Temporarily

188. Keep only essential modules
189. Enable others one by one
190. Identify which causes slowdown
191. Configure that module for performance

Check Scanning Schedule

192. Accessibility scans can be intensive
193. Disable automatic scheduled scans
194. Run manually during off-peak
195. Go to Settings → Scanning Schedule

Optimize Database Queries

196. Go to Settings → Advanced
197. Check “Query Optimization”
198. Runs periodic optimization
199. Helps with large data volumes

Reduce Cookie Scan Frequency

200. Scanner can impact performance
201. Go to Consent Management → Settings
202. Change scan frequency from daily to weekly
203. Run manually as needed

Disable Debug Logging

204. Debug logging adds overhead
205. Go to Settings → Advanced
206. Uncheck “Debug Logging”
207. Only enable when troubleshooting

Check Hosting Resources

208. Ask hosting provider about:

– PHP memory available
– CPU limits
– Database performance
– Disk I/O speed

Getting Help


Gather Information


Before contacting support:

209. Go to SLOS → System Info
210. Copy entire system information
211. Note exact error messages
212. Check /wp-content/debug.log
213. List active plugins
214. Note WordPress & PHP versions

Contact Support


Include:

215. System info from above
216. Error messages (exact text)
217. Steps to reproduce issue
218. What you’ve tried so far
219. Hosting provider info

Post in Forums


WordPress.org plugin forums:

220. Go to plugin page
221. Click “Support” tab
222. Search for similar issues first
223. Provide all information above

Getting More Help

Next steps if issue persists: