Diagnosing Obscure Issues

Strategy for digging into root causes of problems

General Troubleshooting to find odd problems

The most detailed procedure to follow to find out what’s wrong when you’ve made some system changes or just completed an upgrade but something’s not working well, or you’re getting unexplained results, would be:

  1. Download all your site’s files with your FTP tool to a new temporary folder on your PC.
  2. Run a file compare utility to compare all your site’s files against a freshly unzipped copy of the same version of Zen Cart. You can find the original Zen Cart release ZIP files here.
  3. Identify all the differences, and check each one to see if it could cause the problem.

Things to look for are:

  • Unexpected blank lines or spaces at top or bottom of files.
  • Customized code that’s missing closing brackets ) or braces } or semicolons ; or quote marks ' and “.
  • Incomplete files that may have not been uploaded properly.
  • Plugins that have been installed, and whether they’ve been done right or not.
  • Files that have been upgraded incompletely.
  • Files that have been corrupted during upload by becoming double-spaced due to improper handling of end-of-line characters.

Most Common Causes:

  • In many cases it’s a result of define() statements being customized and missing the closing ' or ') or '); or maybe using ' marks inside strings but not using \' instead so the ' is treated properly.
  • Second most common root cause is poorly-written plugins.
  • Third most common is an incomplete upgrade of PHP files.

Still have questions? No problem! Just head over to the Zen Cart support forum and ask there in the appropriate subforum. In your post, please include your Zen Cart and PHP versions, and a link to your site.

Is there an error or omission on this page? Please post to General Questions on the support forum. Or, if you'd like to open a pull request, just review the guidelines and get started. You can even PR right here.
Last modified September 20, 2020 by Chris Brown (aec6608).