A handful of issues have been known to crop up on Backlight sites hosted on Bluehost. This article serves to provide solutions and workarounds to these issues.
While the below is written specifically with issues experienced with Bluehost, it is likely that some issues and solutions will apply to other hosts.
You are not receiving emails from Backlight
Outgoing emails from your site need to have the From value set correctly. Backlight attempts to use your Company Name and Vendor Email, as found in the Backlight Settings, for this.
Bluehost however will only set the From value correctly if it trusts the values you are trying to use. If not, a generic From setting will be used, which causes outgoing emails to be picked up as spam and either not go out at all or be dropped between your server and the inbox where you are trying to receive email.
The following steps need to be taken to receive emails reliably from Bluehost:
Configure the Email address within Bluehost
Configure the PHP sendmail_path setting
sendmail_path = /usr/sbin/sendmail -t -i -email@example.com'
The setting can then be verified by logging into Backlight, clicking on View PHP Info, and checking the value for sendmail_path.
Pages often take several seconds to load.
One culprit we have come across is that some sites on Bluehost use network storage for site files. Backlight uses SQLite databases, a filesystem-based database system that by default expects the database files to be accessible on a local drive.
The performance bottleneck can be removed by changing the database synchronisation settings. To do so:
An explanation of what these settings do can be found here.
You see errors such as:
Something went wrong Unexpected error: Module 'ionCube Loader' already loaded in Unknown on line 0 Please report error at http://community.theturninggate.net
According to Bluehost, these errors are caused by incorrect permissions set on PHP files. We have no information about how this arises.
Below are three solutions to this problem.
1. Disable all optional extensions.
Bluehost provides a number of additional extensions. Backlight requires none of these. If you have no other software running on your site that depends on these, then you can safely disable them from your Control Panel:
Note: we have recently found that Bluehost may not always provide a list of Additional extensions that can be unchecked. Changing PHP version may provide a similar effect. We recommend changing to the latest version of PHP with single php.ini.
2. Have Bluehost fix this issue
Note that this last step can only be performed by Bluehost's support.
3. Backlight provides a mechanism to suppress startup errors. To activate this:
so that it reads as:
After providing a Backlight admin login and clicking Login, the login page appears again, without any error message.
Bluehost provides optional caching add-ons, such as Varnish and CloudFlare. The caching services may fail to handle user sessions properly, resulting in being unable to login to Backlight. Customer sessions such as for Cart and Client Response may also be impacted.
Disable any caching services configured with your Bluehost account.
To disable CloudFlare:
To disable Varnish:
For further assistance, contact Bluehost's technical support.