Troubleshooting

Version: 2.3.0

Troubleshooting

  • Parallax Effect Not Working: Ensure jQuery is loaded on your site (Joomla 4+ includes jQuery by default). Check browser console for JavaScript errors. Verify that the module is published and assigned to the correct position. Make sure you have selected a background image.
  • Image Not Displaying: Verify that the image path is correct and the image exists in the specified location. Check that the image is accessible via the media manager. Ensure the image file format is supported (JPG, PNG, GIF, WebP).
  • Text Not Readable: Enable the Image Overlay option and adjust the overlay color and opacity. Use dark overlays with light text or light overlays with dark text. Increase overlay opacity for better text contrast.
  • Content Not Centered: Check the Content Padding and Content Maximum Width settings. Ensure your custom CSS is not overriding the module's default styles. Use browser developer tools to inspect the element.
  • Module Not Visible: Check that the module is published, assigned to the correct menu items or pages, and that the module position exists in your template. Verify module access levels match your user's access level.
  • JavaScript Errors: Check browser console for errors. Ensure jQuery is loaded before the parallax scripts. Verify that all JavaScript files are loading correctly. Clear browser cache and Joomla cache.
  • Styling Issues: Check if your template's CSS is overriding the module styles. Use browser developer tools to inspect elements. Add custom CSS via the Custom CSS field or your template's custom CSS file.
  • Smooth Scroll Not Working: Ensure Smooth Scroll is enabled in Advanced Settings. Check browser compatibility (works best in Chrome and WebKit browsers). Verify that SmoothScroll.js is loading correctly.
  • Image Not Visible on Mobile: By default, parallax is disabled on mobile devices and uses a static background image. If you've enabled "Enable Parallax on Mobile" and the image is not showing, check that the image path is correct and the module is published. Clear browser cache and test again.
  • Overlay Not Visible: Ensure the Image Overlay option is enabled. Check that the overlay color and opacity are set correctly. Verify that the overlay z-index is not being overridden by custom CSS.