plgsystembtnwhatsapp — Floating WhatsApp Button Plugin for Joomla

plgsystembtnwhatsapp is a System type Joomla plugin designed to automatically inject a floating WhatsApp button into the frontend of a Joomla website. It enables direct communication between visitors and the site owner without modifying the template structure.

The plugin was built with a clean and modular approach, ensuring performance, maintainability, and compatibility with modern Joomla versions.

---

Architecture Overview

• Plugin type: System
• Event interception: onAfterRender()
• Frontend-only execution
• Dynamic HTML/CSS/JS injection
• Template-independent structure
• Media separation for cache optimization

The plugin integrates into Joomla’s rendering lifecycle, injecting the button only after the final page output is generated.

---

How It Works

• Loaded as a System plugin
• Executes during the onAfterRender event
• Verifies frontend context (site client)
• Injects floating button HTML structure
• Applies positioning CSS
• Loads optional JavaScript interactions
• Outputs final rendered page with the WhatsApp button

This method avoids template overrides and guarantees global frontend compatibility.

---

Key Features

• Floating WhatsApp button
• Custom phone number configuration
• Predefined message support
• Display control (global or specific pages)
• Button position control (left / right)
• Optional custom color configuration
• Lightweight and non-intrusive
• Fully compatible with Joomla 4.x, 5.x and 6.x
• PHP 8.0+ compatible

---

Technical Decisions

• System plugin type for global injection
• onAfterRender event to ensure final HTML processing
• Context verification using isClient('site')
• Media folder separation for structured assets
• Dynamic injection to avoid template modifications

This architecture guarantees minimal interference with site structure while maintaining full functionality.

---

Best Practices Applied

• No backend interference
• Frontend-only rendering
• Organized installation XML
• Media asset isolation
• Safe execution strategy
• Joomla 5 and 6 compatibility ready

---

Planned Roadmap

Future improvements include:

• Multiple phone number support
• WhatsApp Business API integration
• Custom animation presets
• Configurable display delay
• Menu item visibility control
• Automatic dark mode support

---

Author

Senior Web Developer | PHP & Joomla | Corporate Systems | Government & Education

• LinkedIn: https://linkedin.com/in/hirleicarlos
• GitHub: https://github.com/hirleicarlos
• Website: https://hirleicarlos.github.io/

© 2026 — plgsystembtnwhatsapp