SiteBar 3 Troubleshooting ========================= [All file paths in this document are relative to the location of this file!] In case of some strange behavior, or even blank screens open file ../inc/errorhandler.inc.php and set following define to true (the easiest is to change the word false to true. define('SB_DEBUGGING', defined('SB_DEVELOPMENT') || false); Verify that your http server has write right to the path where does the following define points to (alternatively change the path): define("SB_LOG_FILE_PATH", "sitebar.log"); All classes with exception of Localizer are subclasses of ErrorHandler so, the static dump and log functions can be called via $this->dump() and $this->log(). All errors and warnings are written to the log file as well. HTTP communication and SQL operations can be logged by changing define in the mentioned file ../inc/errorhandler.inc.php: define ("SB_LOG_HTTP", true); define ("SB_LOG_SQL", true); FAQ --- Q: What means error message 'Cannot connect to database!' A: This means that either your database server is down, or you have entered wrong information when configuring database connection. Verify your credentials using mysql command line or using web application like phpMyAdmin. By default only root user exists in each mysql application. If you are using other username you may need to create the user first. See install.txt for some MySQL hints In order to get more information switch on logging by defining path to the log file (see above). In the log file you will find an error message from your database driver. The information is intentionally hidden to the log file, to prevent other users seeing details about your database in case the connection fails from any reason. In case the connection parameters are incorrect, simply delete file ../inc/config.inc.php and click on [Check Settings] button. Q: I have wrongly setup Base URL in SiteBar Settings. How can I fix it? A: Please edit ../inc/page.inc.php and instead of null in the following define define( 'ABS_BASE_URL', null); empty string or proper URL. Fix URL in SiteBar Settings and change the define back. Q: I have setup redirection from HTTP to HTTPS for SiteBar. Now some things do not work as expected. A: Please setup Base URL in SiteBar Settings to the HTTPS URL.