Support

Documentation

Miscellaneous features

This section describes features that are not available inside the application's interface and are meant to be used by advanced users.

Enabling the debug mode

If you want to report a bug we need to have access to more detailed information of the error which occurred. You can obtain this information by enabling Akeeba Solo's debug mode.

In order to do that you will have to edit the defines.php file in the root of your Akeeba Solo installation with a plain text editor such as Notepad, Notepad++, TextWrangler, Fraise or gEdit. You will see the following line towards the top of the file:

// define('AKEEBADEBUG', 1);

Remove the double slash in front of it so that it now reads

define('AKEEBADEBUG', 1);

A couple lines below you will see the following line:

// define('AKEEBADEBUG_ERROR_DISPLAY', 1);

Remove the double slash in front of it so that it now reads

define('AKEEBADEBUG_ERROR_DISPLAY', 1);

Save the file. The debug mode is now enabled. When you trigger the error again you will see much more details about it. You will need to copy this information and paste it to your support ticket.

In order to disable the debug mode just modify the same line to include the two forward slashes in front of it.

[Important]Important

We strongly advise AGAINST having the debug mode enabled for prolonged periods of time. When the debug mode is enabled the web installer is accessible to logged in users by visiting http://www.example.com/index.php?view=setup where http://www.example.com is where you have installed Akeeba Solo. This is a security risk, as any logged in user can see your database connection information and modify your super user password. That's why the debug mode is disabled by default.