Common Installation Issues #

If you encounter problems while installing inPIPE, check these common issues and their solutions:

PHP Version Compatibility #

Issue: You receive an error message stating “Inpipe requires PHP 8.3 or higher.”

Solution:

• Contact your hosting provider to upgrade your PHP version
• Verify your current PHP version in Tools → Site Health → Info → Server
• The plugin will automatically deactivate if PHP requirements aren’t met

Database Table Creation Failure #

Issue: Plugin activates but doesn’t function properly due to missing database tables.

Solution:

• Deactivate and reactivate the plugin to trigger table creation again
• Check your server’s error logs for specific database errors
• Ensure your database user has CREATE TABLE permissions
• If problems persist, contact your hosting provider to verify database permissions

REST API Not Working #

Issue: Tracking features aren’t working properly or you see permalink warnings.

Solution:

• Ensure Pretty Permalinks are enabled (Settings → Permalinks)
• Check if your server has any restrictions on REST API endpoints
• Verify that your .htaccess file is properly configured and writable
• Test the WordPress REST API functionality with a simple endpoint like /wp-json/

Plugin Conflicts #

Issue: inPIPE functionality is limited or not working due to conflicts with other plugins.

Solution:

• Temporarily deactivate other marketing or tracking plugins to identify conflicts
• Ensure you don’t have multiple plugins trying to modify UTM parameters simultaneously
• Check browser console for JavaScript errors that might indicate conflicts
• Look for plugins that modify the WordPress REST API as they may interfere with inPIPE

Permission Issues #

Issue: Installation fails due to file permission errors.

Solution:

• Ensure your web server has write permissions to the wp-content/plugins directory
• Typical permissions should be 755 for directories and 644 for files
• Contact your hosting provider if you cannot modify permissions

Memory Limit Issues #

Issue: Installation fails due to memory limitations.

Solution:

• Increase WordPress memory limit in your wp-config.php file by adding: define(‘WP_MEMORY_LIMIT’, ‘256M’);
• Request increased PHP memory allocation from your hosting provider if needed
• For larger sites, consider using the FTP installation method

If you continue to experience installation issues after trying these solutions, please contact Seresa support with details about your server environment and the specific error messages you’re encountering.