Switcher

YOOtheme Pro 5 Ready!

Joomla! 6 Ready!

PHP 8.5 Ready!

Partial Builder Updates: Switchers now update instantly in the YOOtheme Pro builder without a full page reload.

Dynamic initialization of newly added switchers via AJAX/fetch.

Custom fields initialization helper for performance boost.

Added navigation scrolling.

Sticky horizontal navigation (activates after reaching navigation breakpoint).

'Blend with page content' option.

Support for YOOtheme Pro 5 margin options (with full YOOtheme Pro 4 backward compatibility).

'Self-healing' logic to automatically disable unused custom grids and fieldsets for a performance boost.

Content field color option.

Content field HTML element options.

Shrink thumbnav option.

Element-level default aria-label and title for item links with per-item override capability

Autoplay progress bar height option.

Item link aria-label and title settings.

Range slider to control the number of custom fieldsets and grids.

CSS BEM classes for all HTML elements.

'Old CSS classes' compatibility layer (will be removed in v1.6.0).

FormListener PHP class for dynamic fields/settings processing.

NodePropsHelper PHP class to handle props updates.

Fallback logic and sanitization for various fields.

Dashed border to settings 'navigator' dropdown for better visibility.

data-nosnippet to the Modal ID hint message.

Dedicated class for lightbox links.

Complete rewrite of the core JavaScript.

Moving from procedural code to a modern, object-oriented Singleton architecture.

Significant gains in performance, stability, and extensibility.

Complete Refactor: Rewritten to a modern Singleton architecture (FSSwitcherManager) for better performance and stability.

Dynamic Initialization: Uses a MutationObserver to instantly initialize new switchers added via AJAX, fetch, or dynamically in the YOOtheme Pro Builder.

Separated observer for YOOtheme Builder canvas updates.

Smarter Autoplay: Autoplay now automatically pauses when the browser tab is inactive or hidden, saving resources. It also pauses if the switcher is out of view or in a hidden element.

Resource Friendly: Eliminated memory leaks and duplicate event listeners through a proper cleanup infrastructure.

Improved Hash Navigation: Enhanced URL hash fragment handling for reliable scrolling and state-matching.

Custom Toggle Sync: Custom toggles now correctly inherit the switcher's active state on page load.

Enhanced Debugging: Added a new logging system that can be enabled from the browser console.

Improved Touch: Better differentiation between drag/swipe and click gestures on mobile.

Modernized Selectors: Switched from class-based to more efficient data-attribute selectors.

Smooth Progress Bar: Uses requestAnimationFrame for smoother autoplay progress bar animations.

Enforced true singleton through private constructor and static instance.

Explicit UIKit availability check before initialization prevents runtime errors.

Public API: getSwitcher(); getToggle(); refresh(); pauseAll(); destroy();

Comprehensive JSDoc type definitions.

Method Organization: grouped by responsibility: Initialization, Event Handling, Autoplay Logic, Utilities, Public API.

IIFE Scope: proper encapsulation within IIFE to prevent global pollution.

Data Storage: from global scope variables to class properties in `Map` collections.

Efficient DOM Queries: cached element references in `Map` structures.

Margin logic for title, meta, and content fields to correctly respect the selected style and HTML element.

Autoplay progress bar display when the switcher is inside a dropdown menu.

Hash links to scroll to the accordion tab instead of the entire accordion.

Moved Autoplay settings into a dedicated panel.

Moved all custom fieldsets and grids into dedicated settings panels to improve UI.

Consolidated item 'Sublayout' and 'Fields' tabs into the 'Content' tab.

Renamed the element 'Grids' tab to 'Fields'.

Settings 'navigator' dropdown now always resets to 'show all' for better UX.

Sublayout display is now enabled by default.

Sublayout display checkbox moved to the item content tab.

Swipe gestures on mobile are now disabled by default.

Item link quick attribute toggles moved directly under the link field for easier access.

Refactored the installer, replacing installer.php with script.php for better compatibility checks.

Refactored LESS files to use new BEM CSS classes.

Reorganized item template files and folder structure for better maintainability.

Simplified element templates with improved rendering performance using early-return patterns.

Enhanced template code readability with simplified conditional logic.

Updated all templates to modern PHP syntax (ternaries, shorthands).

Replaced hardcoded field definitions with configuration variables to reduce file size.

Standardized plugin namespace to align with Joomla conventions.

Simplified class structure, module loading logic, and removed unused imports.

Enhanced inline documentation tooltips for element settings labels.

Refined element settings display logic with clearer conditional display rules.

The hover thumbnail image now remains visible when its item is active.

Improved element props naming.

Refactored text truncation and character limit functionality.

Minified fs-switcher.js and updated code references to the optimized script.

Unset obsolete props from the element during the update process.

Updated CSS classes hints.

Enhanced element UI/UX with better visual feedback.

Improved element code documentation.

Adjusted schema and metadata files.

Custom grid settings overrides.

Custom grid column settings overrides.

Custom grid image settings overrides.

Back button issue in sublayout navigation, which skipped the parent item and opened the element panel. Requires YOOtheme Pro 4.5.x.

Minimum required YOOtheme Pro version updated to 4.5

Helper to easily display the Modal IDs for each item

Option to control the modal stacking behavior

Modal close button size and position options

Grouped item link and image settings into a dedicated settings panel for easier management

Clarified the instructions for integrating sublayouts with modals

Fine-tuned the conditions for element settings for better control

Improved the user interface and experience for element settings

Menu dropdown no longer automatically closes when using the Switcher within

Improved PHP logic for generating `tab_link` values

Refactored hash handling and improve switcher navigation behavior

Correctly handles non-ASCII hash links using `decodeURIComponent()`

Clearer labels and descriptions for the element settings

Minimum required YOOtheme Pro version updated to 4.2

Minimum required Joomla! version updated to 4.4

Minimum required WordPress version updated to 6.6

Dedicated option to enable scroll on tab change

Option to automatically connect the sublayout modal to a link

Scroll-to-top functionality when switching tabs

"3X-Large" heading style

Visibility issues with modal content when section animations are enabled

Issue where accordion autoplay conflicted with hash links

Enhanced the UI/UX of the element settings

Refactored link-handling logic for improved performance and maintainability

Change active class in custom navigation while autoplay is enabled

WordPress update server integration

Tab cutsom link field

Automatic active class assignment to custom navigation items when switching tabs

Scrolling to element issues while using a custom navigations

Disabling option to keep all items closed for the Accordion navigation style while using autoplay

Removed inline JavaScript

Combined all JavaScript features into a single file

Improved switcher hover mode

Rewrited Autoplay JavaScript function

Rewrited URL hash handling JavaScript function to activate switcher tab on page load

Added exclusion list for system builder element IDs when connecting custom navigation by ID

Detect and ignore dragging function when using custom switcher navigation in slider mode

Added a 100ms delay for hover mode

Autoplay pause on hover now excludes switcher navigation area

Enhanced autoplay progress bar animation smoothness and value calculation

Modernized Joomla! plugin

Utilized DatabaseInterface in Joomla! plugin

Integrated Providers in Joomla! plugin

Minimum YOOtheme Pro version requirement: 4.1

Item custom ID, class, and attributes in accordion mode

"fs-no-scroll" class support to disable scrolling while using custom navigation

Ability to toggle specific switcher elements by ID while using custom navigation

Fixed missing navigation label

Fixed displaying label instead of title in accordions

Fixed thumbnav hover animation toggle trigger from image only

More title, meta, and content text styles

Joomla! 5 support

Image and lightbox focal point options

Item HTML element option

Dynamic content support at element level

Element transform

Minimum PHP version requirement: 8.1

Minimum Joomla! version requirement: 4.3

Minimum YOOtheme Pro version requirement: 4.0

Auto-scroll to a switcher element while using custom navigation

Auto-scroll on the page load to a switcher element if URL hash is present

Image title field

Item HTML element option

Lightbox and modal button conflict

Faster element UI

Improved UX for custom fields settings

Enhanced visibility for item override settings

Reduced element input fields delay

Code optimizations for improved performance

Relocated item ID, class, and attribute settings to the advanced tab

Automatically setting the active class to custom navigation items when the switcher tab is toggled

Switcher autoplay progress bar container background option

Updated speed of switcher autoplay progress bar

Switcher autoplay progress bar

Switching tabs with external buttons (custom navigation)

Switcher autoplay progress bar position option

Switcher autoplay progress bar color option

Switcher autoplay progress bar margin option

Sublayouts container margin top option

Active switcher tab by URL not working on the inactive browser tab

Switcher autoplay not starting in the inactive browser tab

Switcher hover navigation mode not changing to the next item on autoplay

Tab switcher by URL now ignores case-sensitive links

Unique switcher item link class for accurate navigation click trigger integration in hover mode

Sublayouts

Modal builder

Hover navigation mode

Enabled triggering switcher item link click on navigation click in hover navigation mode

Custom grids positions: image cell top/bottom

Support for 20 additional meta fields

Support for 2 new meta fields display positions

Image attributes: loading -> eagerly, fetch priority -> high, decoding -> async, cache -> disable

Link enhancements: Title field, Aria label field, Class field, Attributes (nofollow, noreferrer, noopener, prefetch), Custom attributes

Toggle option for all element links with the uk-toggle attribute

Modal ID field

Modal header field

Custom fields panel offset and grid match options

Item title is not required to display the switcher item

Optimized settings UX

Code optimization

Thumbnav hover image

Thumbnav text label

Thumbnav text label position: left, top, bottom

Thumbnav text label breakpoint

PHP 8.1 support

Autoplay on YOOtheme Pro 3.x

Active tab by URL hash location

Autoplay for all types of navigation

Autoplay interval

Autoplay pause on hover, touch

Touch devices swiping disable option

Custom grids column and row gap item override default value

Lightbox gallery

Accordion navigation

Thumbnav icons

Navigation sticky mode support in left and right position

Panel options for nested fieldsets

Automatic unused nested grids disable option

Support for 4 additional nested grids

Support for 2 new nested grid positions

Support for 10 additional text fields

Support for 20 additional image/icon fields

Support for 20 additional link fields

Link and image attributes fields

Overriding options on the item settings tab

Item ID, class and attributes fields

Limit text output for element title, content, meta, and all custom text fields

Title attribute field for link and image in the element settings

Title and image link hover transition options

Title, meta, content, image and link visibility options

All types of grid and image settings for each nested grid

Mixed width options for nested grids

Visibility breakpoints for nested grids

Optimized element settings

Support for YOOtheme Pro 5 margin options, with backward compatibility for YOOtheme Pro 4.

NodePropsHelper class to handle props updates.

YOOtheme Pro 5 ready!

Joomla! 6 ready!

PHP 8.5 ready!

Installer refactor: replaced installer.php with robust script.php, enhancing dependency management and compatibility checks.

Standardized plugin namespace to align with Joomla conventions.

Simplified class structure, streamlined module loading logic, and removed unused imports.

Adjusted schema and metadata files.

Enhanced code readability and maintainability by polishing templates and simplifying logic.

Minified fs-switcher.js and updated code references to the optimized script.

Added 29 language translations

Menu dropdown no longer automatically closes when using the Switcher within

Refactored hash handling and improve switcher navigation behavior

Correctly handles non-ASCII hash links using `decodeURIComponent()`

Minimum required YOOtheme Pro version updated to 4.5

Minimum required WordPress version updated to 6.6

Scroll-to-top option when switching tabs

Accordion thumbnav icon display

Progress bar display position option

Thumbnav Grid

Accordion navigation Images

Accordion hover thumbnail image

Use hover thumbnail image when item is active option

Use hover thumbnail image when item is active option

Thumbnail image visibility option

Thumbnail image border option

Thumbnail label text align option

Thumbnail label visibility option

Simplified settings UI

Support for YOOtheme Pro 5 margin options, with backward compatibility for YOOtheme Pro 4.

NodePropsHelper class to handle props updates.

YOOtheme Pro 5 ready!

Joomla! 6 ready!

PHP 8.4 ready!

Text fields (title, meta, content, custom fields) now correctly render "0" as valid content.

Installer refactor: replaced installer.php with robust script.php, enhancing dependency management and compatibility checks.

Standardized plugin namespace to align with Joomla conventions.

Simplified class structure, streamlined module loading logic, and removed unused imports.

Adjusted schema and metadata files.

Enhanced code readability and maintainability by polishing templates and simplifying logic.

Replace rendering conditional blocks with ternary operators.

Reduce redundancy and improve code conventions across all templates.

Add inline comments for better code understanding and maintainability.

Optimize function expressions and array handling to match modern PHP practices.

Added support for JSON-based language file handling with dynamic translation loading.

Heading 3X-Large style

Minimum Joomla! version requirement: 4.4

Minimum Joomla! version requirement: 4.4

Minimum required WordPress version updated to 6.6

Minimum required YOOtheme Pro version updated to 4.5

WordPress update server integration

Modernized Joomla! plugin

Nested grid top divider

Nested grid masonry pack mode

Nested grid margin bottom option

Nested grid parallax justify, start, and end options

Nested grid text align and fallback

Nested grid visibility

Item max width option

Meta decoration options

Content limit output

Content force align left option

Image title field

Link title field

Link aria-label

Item ID, class, and attributes

Nested grid CSS classes

Code optimization

Element UI improvement

Minimum YOOtheme Pro version requirement: 4.1

Joomla! 5 support

Minimum PHP version requirement: 8.1

Minimum Joomla! version requirement: 4.3

Minimum YOOtheme Pro version requirement: 4.0

YOOtheme Pro 4 support

Dynamic content source at the element level

Item HTML element option

Image focal point option

Option to remove left or right padding for section/row

Inline CSS useful classes hints

Element transform

Optimized settings UX

Minimum PHP version requirement: 7.4

Minimum Joomla! version requirement: 3.10

Minimum WordPress version requirement: 6.0

Minimum YOOtheme Pro version requirement: 3.0

Initial Release