Nimble troubleshooting guide

This is a simple troubleshooting guide for websites using the Nimble Builder plugin.

The most common sources of problem are : 

  • outdated software : make sure Nimble Builder and your theme are up to date.
  • server loading cached content : 90% of the users problem are related to a cache plugin. Cache plugins ( like Total Cache, WP Optimize, Super Cache, WP Fastest Cache ) are useful, but when you customize your site, make sure you deactivate your cache plugin, and always clear your plugin cache. Otherwise you might not see your changes when closing the customizer.
  • or a plugin in conflict with the Nimble plugin.

Before doing anything else :

  1. Make sure that you have updated WordPress to its latest version
  2. Update your active theme and active plugins to their latest versions

Clearing cache content ( Cache plugin or Server cache )

  1. Check with your web hosting company whether your hosting account has a server cache.
  2. If you are using a cache plugin ( like Total Cache ) or server cache. Please clear your cache content and disable your caching via it's settings.
  3. Deactivating a cache plugin will not stop it from working, you need to disable it via it's settings.
  4. Clear your browser history and re-visit your issue, check if it's resolved.
  5. NOTE: if your issue is not resolved, Please keep your caching disabled and proceed with next troubleshooting steps.

Check for Plugin Conflict

A plugin or plugins could be using code that conflicts with the Nimble Builder. 
You can disable all plugins, clear cache,  browser history and check if your problem is resolved.

You can isolate the plugin by using the following troubleshooting steps.

  1. If you are using a server cache or cache plugin, please clear it’s cache content and disable caching via it’s settings.
  2. Proceed to disable one plugin at a time, clear browser history and re-visit your issue. 
    Check if it’s working properly now. If it's working properly, this means the plugin that you had just disabled is causing your issue.

Do this until you find the plugin that’s causing your issue.

The Customizer Preview is not working

If your Appearance -> Customize page is not loading or settings are not saving properly, please carry out the above mentioned troubleshooting steps on Clearing cache content, Updating the Nimble Builder and check for plugin conflict.

If your issue is still not resolved, please proceed with troubleshooting steps as listed in the following documentation :  Customizer Preview is not working ( Appearance - Customize ) 

Blank page

A blank page happens when there is a PHP error on your website. 

  1. It could be due to a child theme including custom code that is outdated.
  2. Theme is not installed completely or Theme update failed without completing. 
    This will cause some Theme files to be missing and thus causing error.
  3. Server not having enough memory to run all your software, thus resulting in PHP memory exhaust error.
  4. A plugin not installed or updated properly, causing some files to be missing and thus causing error.

You'll find a detailed documentation about blank page issues in WordPress Parse error leading to blank page - How to fix ?

Turn on WP_DEBUG ( error reporting )

Please refer to this  documentation to turn on WP_DEBUG or get your web hosting company for help in turning on WP_DEBUG so that you can see the error message.

Troubleshoot according to error message

Contact your web hosting company to help get your website up and running, if you do not know how to use FTP or are not sure on which files to delete.

Deleting wrong files can cause further damage to your website. Please do not do it yourself, if you are unsure.

  1. Take a look at your error message. 
  2. Login to your server via FTP.
  3. If you are sure that this error is cause by a custom code you added into a child theme or modification to theme, you can proceed to edit your file and remove the error code.
  4. If it's about PHP memory exhaust error. You will have to ask your web hosting company to increase your memory.
  5. If it's pointing to an error in a plugin file or theme file, because your installation or update stopped without completing.
    You can use FTP to delete the plugin or theme ( folder including all files in it ) and your website should be loading properly. 
    You will be able to access your WordPress admin to re-install your plugin or Theme.
  6. if you are using a child theme. Use your FTP to access your server and backup a copy of your child theme onto your PC. Delete your child theme from your website and check if your website is loading properly. A plugin containing outdated codes can cause fatal error.