Easy Parallax

What's new?

Version 2.3.1: 19 October 2026

• Runs on Joomla 5 and 6 with the Behaviour Backward Compatibility plugins disabled
• The system shortcode plugin loads jQuery through the Web Asset Manager

Version 2.3.0: 15 September 2026

• Compatibility: Joomla 6 native APIs. The Behaviour Compatibility plugin is not required.
• Improvement: Module boots through Joomla 4/5/6 services (dispatcher, HelperFactory, and database from the container).
• Improvement: Removed leftover Joomla 3 field and element PHP.

Version 2.2: 07 April 2026

• FIxed issue with image overalapping the text.

Version 2.1: 14 February 2026

• Fixed parallax position wrong on page refresh when elements above load asynchronously:
  • Added ResizeObserver + fallback poll in parallax.js to detect layout changes and automatically recalculate positions
  • Defers setup to window.load when page isn't fully loaded, preventing wrong calculations from cached images
• Added optional debug logging in parallax.js (set window.PARALLAX_DEBUG = true before page load to enable)

Version 2.0: 11 February 2026

• Fixed parallax broken on page refresh:
  • Parallax image no longer freezes or overlays content after refresh
  • Added window load handler to trigger resize so positions recalculate when layout is final
  • Fixes issue where resizing the window was previously required to restore correct behavior
• Fixed stacking order so content always stays above the parallax background:
  • Parallax block (#jx-easyparallax) now has position: relative and z-index: 2
  • Ensures mirror layer (z-index: 1) stays behind module content even if positioning is wrong

Version 1.9: 09 January 2026

• Removed mobileHeight parameter - simplified height management.
• Moved parallax.js script to document head using WebAssetManager for proper loading order.
• Fixed overlay visibility and positioning issues:
  • Updated overlay z-index to 1 to appear above parallax image
  • Fixed overlay height coverage using inset: 0 for full container coverage
  • Added box-sizing: border-box to prevent spacing issues
• Set parallax bleed to 0 to ensure overlay covers the full container area.
• Fixed Parallax Speed Ratio description - corrected to reflect valid range (0.0 to 1.0).
• Added new parameter: "Enable Parallax on Mobile" in Advanced Settings:
  • Allows users to enable/disable parallax effect on mobile devices
  • Default: disabled (better performance and battery life)
  • Modified parallax.js to support mobile parallax when enabled
• Improved code cleanup - removed all unnecessary debugging and extra code.
• Enhanced mobile device support with proper image display fallback.

Version 1.8: 04 December 2025

• Upgraded to fully support Joomla 4, 5, and 6.
• Updated all PHP file headers to modern Joomlax branding and PHPDoc.
• Reorganized module parameters into 3 logical fieldsets: "Image Settings", "Content Settings", and "Advanced Settings".
• Updated radio button fields to use modern switcher layout for better UX.
• Replaced deprecated asset loading methods with WebAssetManager for modern asset management.
• Moved JavaScript and CSS files to assets folder following Joomla 4+ standards.
• Updated all CSS classes and IDs to use "jx-" prefix for better namespace isolation.
• Added new parameter: Enable Module Selection (allows disabling module embedding feature).
• Renamed elements folder to fields following Joomla 4+ naming conventions.
• Updated jQuery compatibility:
  • Replaced deprecated .bind() with .on()
  • Replaced deprecated .unbind() with .off()
  • Replaced deprecated $(window).load() with $(window).on('load')
  • Fixed document.height deprecation in SmoothScroll.js
  • Fixed getClientRects error in stellar.js for window elements
• Enhanced security with proper input sanitization and XSS prevention.
• Improved error handling in helper class with try-catch blocks.
• Updated language files with comprehensive labels and descriptions.
• Added proper escaping for all CSS values and HTML output.
• Improved code quality and compatibility with modern Joomla standards.

Version 1.7: 12 December 2023

• Support Joomla 5.
• No need for a Backward Compatibility Plugin.

Version 1.6: 11 February 2023

• Single file installation for both Joomla 3 and Joomla 4

Version 1.5: 27 January 2023

• Fixed a bug with Joomla 3

Version 1.4: 18 July 2022

• Fixed jQuery Issue

Version 1.3: 26 October 2021

• Supports PHP version 8
• Supports Joomla 4

Version 1.2: 01 February 2017

• Integrated Joomla Update System

Version 1.1

• Fixed Mobile Issue