System - WhatsApp Button

Get System - WhatsApp Button (v2.0.0)

New n

Introduction

Chat, Editor Buttons

Lightweight and professional WhatsApp floating button plugin for Joomla 4 / 5 / 6.

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/

plgsystembtnwhatsapp — Plugin de Botão Flutuante WhatsApp para Joomla

Plugin leve e profissional de botão flutuante WhatsApp para Joomla 4 / 5 / 6.

plgsystembtnwhatsapp é um plugin do tipo System para Joomla desenvolvido para injetar automaticamente um botão flutuante de WhatsApp no frontend do site. Ele permite comunicação direta entre visitantes e o administrador do site sem necessidade de modificar o template.

O plugin foi construído com abordagem limpa e modular, garantindo desempenho, facilidade de manutenção e compatibilidade com versões modernas do Joomla.

Visão Geral da Arquitetura

Tipo de plugin: System
Interceptação de evento: onAfterRender()
Execução somente no frontend
Injeção dinâmica de HTML/CSS/JS
Estrutura independente do template
Separação da pasta media para melhor organização e cache

O plugin se integra ao ciclo de renderização do Joomla, injetando o botão apenas após a geração final do HTML da página.

Como Funciona

Carregado como plugin do tipo System
Executa durante o evento onAfterRender
Verifica se está no contexto frontend (site)
Injeta estrutura HTML do botão flutuante
Aplica CSS de posicionamento
Carrega interações JavaScript opcionais
Entrega a página final renderizada com o botão WhatsApp

Esse método evita alterações no template e garante compatibilidade global no frontend.

Principais Recursos

Botão flutuante de WhatsApp
Configuração personalizada do número
Suporte a mensagem pré-definida
Controle de exibição (global ou páginas específicas)
Controle de posição do botão (direita / esquerda)
Configuração opcional de cor personalizada
Implementação leve e não intrusiva
Compatível com Joomla 4.x, 5.x e 6.x
Compatível com PHP 8.0+

Decisões Técnicas

Uso do tipo System para injeção global
Evento onAfterRender para garantir HTML final
Verificação de contexto com isClient('site')
Separação de pasta media para organização dos assets
Injeção dinâmica para evitar alteração de template

Essa arquitetura garante mínima interferência na estrutura do site mantendo total funcionalidade.

Boas Práticas Aplicadas

Nenhuma interferência no backend
Renderização exclusiva no frontend
XML de instalação organizado
Isolamento de arquivos de mídia
Estratégia segura de execução
Preparado para Joomla 5 e 6

Roadmap Planejado

Melhorias futuras incluem:

Suporte a múltiplos números
Integração com WhatsApp Business API
Presets de animação personalizados
Delay configurável de exibição
Controle de visibilidade por item de menu
Suporte automático a modo dark

Autor

Desenvolvedor Web Sênior | PHP & Joomla | Sistemas Corporativos | Governo e Educação

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