Professional Floating Call-To-Action Button Module for Joomla

Key Features

Button Types

• Single Button: One-click call/contact button
• Multibutton (Expanding): Multiple action buttons in a floating menu

Link Types

• Phone: Direct dial links (tel:)
• WhatsApp: WhatsApp chat links with country code support
• Custom URL: Any custom link with full control over rel and target attributes

Appearance Options

Button Styles

• Circular Icon: Classic floating button with icon only
• Icon with Text (Pill Shape): Button with icon + label

Positioning & Display

• 8 Position Options: Bottom/Top + Left/Center/Right
• Full Width: Full-width display at top or bottom (Icon+Text only)
• Custom Margins: Full margin control from screen edges
• Responsive Sizes: Device-specific size controls (Desktop, Tablet, Mobile)

Customization

Icons & Visual Controls

• 18 Built-in Icons: Phone, WhatsApp, Telegram, Instagram, Facebook, Twitter, LinkedIn, YouTube, etc.
• Custom Icon Upload: Upload your own image/icon
• Color Controls: Background + icon color customization
• Typography: Font size, color, and weight for text buttons
• Animations: Pulse, Bounce, Shake (with pill-shape support)
• Z-Index Control: Stacking order control

Multibutton Features

• Tooltip Themes: Light / Dark
• Title Display: Show on hover, always show, or hide
• Individual Item Styling: Custom colors and icons per item
• Smooth Animations: Staggered slide-in animations

SEO & Standards Compliance

• SEO Optimized: Proper rel attributes (nofollow, noopener, noreferrer)
• Link Attributes: Full target control
• Title Attributes: Anchor title enhancement for SEO
• Alt Text: For custom image icons
• ARIA Labels: Accessibility support
• Joomla Standards: Fully compliant with Joomla 5.x and 6.x
• Namespace Support: Proper Joomla namespace implementation

Technical Features

• Responsive Design: Mobile-first structure with breakpoints
• Display Modes: All devices, mobile only, desktop only
• Multilingual: English and Persian language support
• Auto Updates: Native Joomla update system via GitHub Releases
• Changelog Integration: Release notes in Joomla admin

Installation

Method 1: Download from GitHub

1. Go to Releases
2. Download the latest version
3. Joomla Admin → Extensions → Manage → Install
4. Upload the ZIP file

Method 2: Direct Install (Latest Version)

https://github.com/mostafaafrouzi/joomla-call-now-button/releases/latest/download/mod_callnowbutton.zip

> This link always downloads the latest version.
> The file name will include the version number (e.g., mod_callnowbutton-1.0.0.zip).

Or visit the Releases page to choose a specific version.

Automatic Updates

• Joomla Admin → System → Update → Extensions
• Click Check for Updates
• If update is available → Update

To view the changelog:
- In Manage Extensions, click the version number
- Or in the Update section, click the Changelog button

Requirements

• Joomla: 5.0.0 or higher (compatible with Joomla 6.x)
• PHP: 8.1.0 or higher (8.1 / 8.2 / 8.3 / 8.4)
• Browser: Modern browsers with CSS3 & JavaScript support

Changelog

What's New in v1.1.0

✨ Features & Improvements
- Accessibility: Multibutton main trigger is now a `` element with aria-expanded and keyboard Escape support.
- Asset Management: Front-end assets register via Joomla Web Asset Manager (joomla.asset.json) with a body fallback for late module positions. Media asset URLs now use Uri::root with filemtime cache busting.
- CSS Scoping: Introduced per-instance CSS scoping via wrapper id #cnb-mod-{moduleId}. Per-instance inline styles are emitted next to the module markup for reliable scoping.
- Styling: Added optional CSS color overrides for buttons and icons (var() support) and a custom CSS field with security filtering.
- Responsiveness: Display mode now uses CSS media queries (cache/CDN safe, 768px breakpoint) instead of PHP rendering limits.
- Architecture: New call-now-button.js bootstrap moves the widget to document.body so parent opacity/transform rules cannot hide fixed buttons. Unified multibutton JavaScript.
- Admin & Security: External admin icon selector assets feature subform-row-add event delegation. IconRepository centralizes icon SVG definitions. Added SHA512 checksum to updates.xml for integrity validation.
- CI/CD: Added CI PHP syntax lint matrix for PHP 8.1 through 8.5. Install and update messages now include UTM-tracked developer links.

🐛 Bug Fixes
- Display & Layout: Fixed button staying invisible (opacity: 0) inside sticky headers (e.g., Helix Ultimate). Fixed single-button center positions losing horizontal centering when size scale was applied.
- Multibutton Fixes: Fixed label text not being clickable. Fixed layout overlap caused by double fixed positioning. Fixed option stack overlap by using flex gap instead of margin. Fixed display_mode not applying. Fixed icon selector not working after adding a new subform row.
- RTL Alignment: Fixed multibutton pill buttons, option stack alignment, and corner flushing issues on RTL (Persian) sites.
- CSS/JS Loading: Fixed inline generated CSS overriding between multiple instances. Fixed body fallback CSS link not being generated (HTMLHelper pathOnly bug). Fixed CSS/JS not loading in footer positions that render after the template head (JCH Optimize / Helix layouts).
- Code Execution: Fixed IconRepository class not loading when helper is required directly on the front-end. Fixed Web Asset Manager fatal error when mod_callnowbutton.script was missing from the registry. Fixed button size animation ending at scale(1) instead of the configured size (FOUC). Fixed duplicate module IDs on the same page.
- Clean Up: Removed @unserialize fallback for multibutton subform data and removed legacy helper.php wrapper class (unused with Joomla 5 Dispatcher).

⚠️ Important Upgrade Notes
- CSS Update: If you previously referenced #callnowbutton in your custom CSS, you must update your selectors to #cnb-mod-{moduleId}.
- Cache: Please clear your Joomla cache and JCH Optimize cache after updating if styles still look stale.

Developed by Mostafa Afrouzi - Web Designer & Developer | afrouzi.ir