Skip to main content

Troubleshooting Guide

This comprehensive guide covers common issues, diagnostic procedures, and solutions for the Live Carts for WooCommerce plugin.

Table of Contents​

Quick Diagnostic Checklist​

Before diving into specific issues, run through this quick checklist:

Prerequisites Verification​

  • WordPress version 6.2+ installed
  • PHP version 7.0+ (8.0+ recommended)
  • WooCommerce plugin activated and functioning
  • Plugin properly activated without errors
  • Database tables created successfully
  • WordPress cron functionality enabled

Common Issues and Solutions​

Installation and Activation Issues​

Plugin Won't Activate​

Symptoms:

  • Plugin activation fails with error message
  • WordPress displays "Plugin could not be activated" notice
  • PHP fatal errors in logs

Solutions:

  1. Version Compatibility:

    • Update WordPress to 6.2+
    • Update PHP to 7.0+ (8.0+ recommended)
    • Ensure WooCommerce is installed and activated

  2. Memory Issues:

    // Add to wp-config.php
    ini_set('memory_limit', '256M');
    define('WP_MEMORY_LIMIT', '256M');

  3. Plugin Conflicts:

    • Deactivate other plugins temporarily
    • Activate Live Carts plugin
    • Reactivate other plugins one by one to identify conflicts

Cart Tracking Issues​

Solutions:

  1. Session Issues:

    • Verify WordPress sessions are working
    • Check for session-blocking plugins or themes
    • Test with default WordPress theme

  2. Hook Conflicts:

    • Temporarily disable other WooCommerce extensions
    • Test with minimal plugin configuration
    • Check for theme conflicts with WooCommerce hooks

Cart Status Not Updating​

Symptoms:

  • All carts remain "active" indefinitely
  • No abandoned or converted cart statuses
  • Cron jobs not running

Solutions:

  • Confirm WP-Cron is enabled
  • Check scheduled events
  • Low-traffic sites
    • WP-Cron triggers on front-end/admin requests. If your site has low traffic, events may not fire on time.

Performance Issues​

Pro Version Specific Issues​

License Activation Problems​

Symptoms:

  • Pro features not appearing in admin interface
  • "License required" messages
  • Auto-update not working

Solutions:

  1. Re-enter License Key:

    • Navigate to WooCommerce > Live Carts> Activation
    • Clear existing license key
    • Re-enter valid license key from BerryPress account

  2. Check Base Plugin Version:

    • Ensure free plugin is version 1.0.12 or higher
    • Update free plugin if necessary before activating Pro features

Recovery URLs Not Working​

Symptoms:

  • Recovery URLs return 404 errors
  • URLs don't restore cart contents
  • Database recovery_key column missing

Solutions:

  1. URL Rewrite Issues:
    • Flush WordPress permalinks (Settings > Permalinks > Save)
    • Check for .htaccess conflicts
    • Test with different permalink structures

Order Creation Failures​

Symptoms:

  • "Create Order" button doesn't work
  • Orders created without proper data
  • Permission errors when creating orders

Solutions:

  1. User Permissions:

    • Verify user has manage_woocommerce capability
    • Test with administrator account

  2. WooCommerce Configuration:

    • Check WooCommerce > Settings > General for proper configuration
    • Verify tax settings are properly configured
    • Ensure at least one payment method is enabled

Debug Mode and Logging​

Enabling Debug Mode​

// Enable WordPress debugging
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

// Enable plugin-specific debugging
add_filter('phplugins_live_carts_debug_mode', '__return_true');

Advanced Diagnostics​

Support and Professional Help​

When to Seek Support​

Contact support if you encounter:

  • Persistent data loss or corruption
  • Critical performance degradation
  • Security-related concerns
  • Complex integration requirements

Information to Provide​

When requesting support, include:

  • WordPress, WooCommerce and PHP versions
  • Complete error messages and logs
  • System information report
  • Steps to reproduce the issue
  • Screenshots of the problem

Support Channels​

For additional help, continue to Developer Hooks for advanced customization options, or visit the WordPress Support Forum for community assistance.