Troubleshooting

This guide covers common issues encountered with the CruiseAppy plugin, along with recommended solutions, debugging tips, and support resources. The information below is based on the CruiseAppy plugin source and the technical specification PDF.

Common Issues & Solutions

1. Data Import Failures

  • Symptoms: Missing or incomplete cruise data, import scripts not running.
  • Solutions:
  • Verify FTP credentials and endpoint configuration in plugin settings.
  • Check file and folder permissions for scripts/, uploads/, and cache/.
  • Review cron job or WP-CLI schedules for automation scripts.
  • Inspect log files in the log/ directory for error messages.

2. API Connection Errors

  • Symptoms: Unable to fetch data from TravelTek, API requests timing out.
  • Solutions:
  • Confirm TravelTek API credentials and endpoint URLs.
  • Ensure server firewall allows outbound connections to TravelTek.
  • Check for API rate limiting or throttling in logs.
  • Enable debug mode to capture detailed API responses.

3. Payment Processing Issues

  • Symptoms: Failed transactions, payment gateway errors.
  • Solutions:
  • Verify payment gateway configuration and credentials.
  • Ensure PCI DSS compliance settings are enabled.
  • Check for plugin or gateway updates.
  • Review payment logs for error codes and messages.

4. Search or Filtering Problems

  • Symptoms: No results, incorrect filtering, slow search performance.
  • Solutions:
  • Rebuild search indexes using automation scripts.
  • Clear plugin cache and verify cache settings.
  • Check for missing or outdated cruise/cabin data.
  • Review search configuration in plugin settings.

5. UI/UX Display Issues

  • Symptoms: Broken layouts, missing assets, unresponsive elements.
  • Solutions:
  • Confirm CSS and JS assets are properly enqueued.
  • Check for theme conflicts or outdated template overrides.
  • Inspect browser console for JavaScript errors.
  • Update plugin and theme to latest versions.

6. Booking Flow Errors

  • Symptoms: Incomplete bookings, validation failures, missing confirmation.
  • Solutions:
  • Validate required fields in booking forms.
  • Check integration with payment gateway and TravelTek API.
  • Review booking logs and error messages.
  • Ensure automation scripts are processing bookings correctly.

Debugging Tips

  • Enable WordPress debug mode (WP_DEBUG in wp-config.php).
  • Use plugin logging features to capture errors and actions.
  • Review logs in the log/ directory for script and API errors.
  • Test in a staging environment before deploying changes to production.

Support Resources