Troubleshooting Guide

We do our best to document and provide solutions for any situation you may encounter with LiteSpeed Cache plugins. If you don't see your issue listed here, there are additional support options available.

See Also: General LSCache Troubleshooting

Tip

Before contacting the support team, please verify that you have upgraded to the most recent version of the plugin.

Logged-in Username Not Showing

In PrestaShop 1.6, with LiteSpeed Cache for PrestaShop enabled, a logged-in visitor may see their logged-in usernames on some pages but not on others, like so:

!

!

This is caused by incorrect ESI hole-punching.

To fix the problem, enable overrides, like so:

Navigate to PrestaShop Admin > Advanced Parameters > Debug mode and set Disable all overrides to NO. This setting must be NO, because both PrestaShop 1.6 & 1.7 rely on overrides to execute ESI hole punching.

Note

For some cases, especially for PrestaShop 1.7, the above solution may not be sufficient. The PrestaShop theme code may need to be analyzed to identify the root cause. This may be a very time-consuming process. If you'd like someone else to do it, you can engage LiteSpeed through paid support. Feel free to ask for a quote if you have such a need.

PageSpeed Insights Zero Score

PrestaShop's internal cache may lead to a zero PageSpeed Insights score.

After LiteSpeed Cache for PrestaShop is enabled, you may see a very fast loading speed (464ms) for TTFB through the browser. Also Gtmetrix and Pingdom show good results. However Google's PageSpeed Insights consistently gives a 0 result.

Google states:

Lighthouse returns a Performance score between 0 and 100. 0 is the lowest possible score. A 0 score usually indicates an error in Lighthouse. If you see a 0 score repeatedly, please file a bug on the Lighthouse repo.

Lighthouse seems to be having difficulty with your PrestaShop site.

PrestaShop has an internal cache, Smarty Cache, which may lead to this zero PageSpeed Insights score. It has nothing to do with LiteSpeed Cache for PrestaShop. If you clear PrestaShop's internal cache then everything should be fine.

Navigate to PrestaShop Admin > Advanced Parameters > Performance and press the Clear cache button.

!

Messy Layout After Clearing Smarty Cache

There is sometimes confusion, when it comes to PrestaShop caching. Whenever possible, be specific about which cache should be cleared. The phrase "clear the cache" could mean "clear PrestaShop's internal Smarty Cache," or it could mean "flush LiteSpeed Cache." Maybe it means both.

If you make changes to your theme, please remember to clear both Smarty Cache and LiteSpeed Cache. Failure to clear both caches may lead to messy layout problems.

!

Clearing Smarty Cache

PrestaShop Smarty Cache can be found on the Configure > Advanced Parameters > Performance > Smarty menu. The Clear cache button on the top of the page clears Smarty Cache.

When your shop has been modified, especially your theme, you will need to clear Smarty Cache.

!

Clearing LiteSpeed Cache

When the LiteSpeed Cache module is installed, it can be found on the IMPROVE > Module Manager > LiteSpeed Cache Plugin menu. Click Configure to see all of the available LiteSpeed Cache settings.

!

The Flush All PrestaShop Pages button on the top of the page clears LiteSpeed Cache.

!


Last update: August 26, 2020