Troubleshooting

Common issues and how to resolve them.

Connection Issues

• Verify your Account ID, API Key, and Secret are entered correctly in the CareHQ tab.
• Ensure your API key has the required permissions (Actions, Care enquiries, Groups, Locations).
• Check that your CareHQ account is active.
• Try switching between Development and Production environments.
• Confirm your server can make outbound HTTPS requests.

Form Submissions Not Arriving

• Check that all required fields are mapped (first_name, last_name, email, phone, message).
• Make sure a CareHQ location is assigned to the form.
• Check the Logs tab for error details.
• Submit a test form with basic data to isolate the issue.

Plugin Errors

• Confirm you’re running WordPress 6.0+ and PHP 8.0+.
• Check for plugin conflicts by temporarily disabling other plugins.
• Ensure your license key is valid and activated.
• Try reinstalling the plugin.

Common Error Codes

Timeout Errors

If you see cURL error 28, increase your PHP timeout settings. Add these to your php.ini, .htaccess, or wp-config.php:

max_execution_time = 60
default_socket_timeout = 60

Upload Size Limits

If the plugin zip exceeds your upload limit, increase these PHP settings:

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M

Alternatively, upload the plugin via FTP to wp-content/plugins/ and activate it from the WordPress admin.

Getting Support

If you’re still stuck, contact us at billy@victory.digital. Include:

• Your WordPress and PHP versions
• Any error log entries from the Logs tab
• Steps you’ve already tried