FW Gallery – Documentation

If the lightbox fails to open when clicking gallery images, the most common causes are JavaScript conflicts, theme issues, or missing assets. The steps below help you identify and resolve the problem.

Check the Browser Console for JavaScript Errors

Open your browser's developer tools (usually F12) and click the Console tab. Reload the page and look for any red error messages. A JavaScript error from another plugin or theme script can prevent the lightbox from initialising. Note the source of any errors — this points directly to the conflicting code.

Test with a Default Theme

Temporarily switch to a default Joomla theme and check whether the lightbox works. If it does, your active theme is interfering with FW Gallery's front-end assets. Common theme-related causes include:

• The theme dequeues or replaces component stylesheets and scripts
• The theme loads its own lightbox library that conflicts with FW Gallery's
• Component assets are excluded from the theme's asset optimisation pipeline

If switching themes resolves the issue, contact your theme developer or disable the theme's script optimisation options.

Identify jQuery Conflicts

The lightbox depends on jQuery being loaded correctly and only once. Problems occur when:

• Multiple plugins load different versions of jQuery simultaneously
• A plugin loads jQuery in a way that overwrites the version already on the page
• jQuery is loaded in no-conflict mode without proper handling

Check the browser console for errors mentioning jQuery is not defined or similar messages. Use a script manager plugin to control load order and prevent duplicate jQuery instances if needed.

Check for Plugin Conflicts

Deactivate other plugins one at a time, testing the lightbox after each deactivation. This isolates whether a specific plugin is causing the conflict. Pay particular attention to:

• Page builder plugins
• Performance or caching plugins that minify or combine JavaScript
• Other gallery or media plugins that load their own lightbox scripts

Once you identify the conflicting plugin, check whether that plugin has options to exclude scripts on pages where FW Gallery is used.

Caching and Minification

If you use a caching or performance plugin, try clearing all caches and disabling JavaScript minification or concatenation temporarily. Combining scripts from multiple sources can break execution order and cause lightbox failures.

Verify FW Gallery Assets Are Loading

In the browser developer tools, open the Network tab and filter by JS or CSS. Reload the page and confirm that FW Gallery's own script files appear in the list and return a 200 status code. A 404 error on any FW Gallery asset means the file is missing or the path is incorrect — reinstalling the extension usually resolves this.

Quick Checklist

1. Open the browser console and check for JavaScript errors
2. Switch to a default theme and test
3. Disable caching and minification, then retest
4. Deactivate other plugins one by one to find a conflict
5. Confirm FW Gallery assets load without 404 errors
6. Reinstall FW Gallery if assets are missing