Debugging

When using TangoCMS (even during installation) and you come across a 'Internal Error' or a blank page, then you will need to change some configuration details to make TangoCMS more verbose about the errors that have occurred. These configuration values can be found in the 'config.ini.php' file within your configuration profile, for example 'config/default/config.ini.php'.

Log Files

Every time a severe error occurs, a dump file is made by Zula (the framework powering TangoCMS), which will provide us with a lot of information to help debug the problem. The dump file can be found in the 'application/logs' directory, and will be named something such as 'zula-dump.1.log'.

There are also other general log files that are generated (stored in the same directory as above), these can also give us information as to what cause the severe error or blank page.

Changing the Needed Values

Open up the above file using which ever editor you prefer, and find the '[debug]' heading (roughly around line 118). You will then need to ensure that the values in that section are set to the following (some have been left out here, as they are irrelevant):

php_error_level = 8191
php_display_errors = 1
zula_detailed_error = 1
zula_log_level = 95
zula_log_errors = 1
zula_show_errors = 1

After you have made these changes, save the file and re-load the page that was producing the severe error/blank page. More information should now be provided to you, this information can then help us to debug your problem.

Reporting the Issue

Please Report the Bug to us so that we can fix it (make sure to attach the dump file, or any other log files that are relevant), or check the Community page for details on how to contact us another way.