💬 WhatsApp Flutuante

Um plugin WordPress profissional e seguro que adiciona um botão flutuante do WhatsApp ao seu site. Configure a posição, ícone personalizado e páginas de exibição com uma interface intuitiva — sem precisa editar código.

🚀 Características

• ✅ Botão Flutuante Responsivo - Adapta-se perfeitamente a qualquer dispositivo
• ✅ Ícone Personalizado - Use a biblioteca de mídia do WordPress para enviar seu próprio ícone
• ✅ Posicionamento Flexível - Escolha entre 4 posições diferentes
• ✅ Controle de Exibição - Mostre em todas as páginas, apenas na home ou em IDs específicas
• ✅ Mensagem Padrão - Defina uma mensagem personalizada
• ✅ Código Seguro - Nonces, sanitização e validação completas
• ✅ Performance Otimizada - Carregamento eficiente de scripts
• ✅ Acessibilidade - ARIA labels e navegação por teclado
• ✅ Modo Escuro - Compatível com preferência do navegador
• ✅ Arquitetura OOP - Código profissional com padrão Singleton

📋 Requisitos

• WordPress 5.0 ou superior
• PHP 7.4 ou superior

📦 Instalação

Instalação via Upload

1. Faça o download do plugin em GitHub
2. No painel do WordPress, vá para Plugins → Adicionar Novo
3. Clique em Fazer Upload do Plugin
4. Selecione o arquivo ZIP do plugin
5. Clique em Instalar Agora e depois Ativar

Instalação via FTP

1. Descompacte o arquivo ZIP
2. Envie a pasta whatsapp-flutuante para /wp-content/plugins/ via FTP
3. No painel do WordPress, vá para Plugins e ative o plugin

⚙️ Configuração

1. Após ativar, vá para Painel de Controle → WhatsApp Flutuante
2. Preencha os campos obrigatórios:
   • Número do WhatsApp: Com código do país e DDD (ex: 5562999999999)
   • Mensagem Padrão (opcional): Mensagem que aparecerá no chat
   • Posição do Botão: Escolha onde exibir
   • Ícone: Envie um ícone personalizado via Media Library
   • Exibir em: Todas as páginas, apenas home ou IDs específicas
3. Clique em Salvar Alterações

🔒 Segurança

Implementa as melhores práticas de segurança do WordPress:

• ✅ Verificação de Nonce contra CSRF
• ✅ Sanitização de todos os inputs
• ✅ Validação de número de telefone
• ✅ Escapagem de outputs
• ✅ Verificação de permissões (apenas admins)
• ✅ Validação de arquivos (apenas imagens)

🎨 Personalização

CSS Customizado

/* Alterar cor do botão */
.wa-flutuante-link {
    background-color: #your-color;
}

/* Alterar tamanho */
.wa-flutuante-icon {
    width: 70px;
    height: 70px;
}

/* Alterar posição */
.wa-flutuante.wa-bottom-right {
    bottom: 40px;
    right: 40px;
}

📝 Changelog

v3.0 (Atual)

• 🎉 Nova arquitetura OOP com padrão Singleton
• 🎉 Integração completa com Media Library do WordPress
• 🎉 Melhorias significativas de segurança
• 🎉 Suporte a tradução (i18n)
• 🎉 Interface aprimorada
• 🎉 Melhor acessibilidade
• 🎉 Suporte a modo escuro
• 🎉 Hook uninstall.php padrão

v2.0

• Versão anterior com funcionalidades básicas

📄 Licença

GPL-2.0-or-later — Você é livre para usar, modificar e distribuir.

👨‍💻 Autor

Luiz Gustavo
GitHub: @luizgustavorodriguesdev

🤝 Contribuições

Contribuições são bem-vindas!

1. Faça um Fork do projeto
2. Crie uma branch (git checkout -b feature/sua-feature)
3. Commit suas mudanças (git commit -m 'Adiciona nova feature')
4. Push para a branch (git push origin feature/sua-feature)
5. Abra um Pull Request

🐛 Reportar Bugs

Encontrou um bug? Abra uma issue no GitHub.

📞 Suporte

Dúvidas ou sugestões? Entre em contato via GitHub Issues.

📸 Demonstração

Desenvolvido com ❤️ para a comunidade WordPress