Button WhatsApp WBL Produções

Um plugin WordPress completo e responsivo que adiciona um botão do WhatsApp em todas as páginas do seu site, com configuração via painel administrativo.

📱 Descrição

O Button WhatsApp WBL Produções é um plugin desenvolvido para facilitar o contato direto com seus visitantes através do WhatsApp. Com design moderno e responsivo, o plugin oferece total controle sobre a aparência e posicionamento do botão.

✨ Características Principais

• Totalmente Responsivo: Adapta-se perfeitamente a todos os dispositivos
• 4 Posições Disponíveis: Inferior direito, inferior esquerdo, superior direito, superior esquerdo
• Configuração Simples: Interface intuitiva no painel administrativo
• Mensagem Personalizada: Configure uma mensagem padrão para ser enviada
• Ativar/Desativar: Controle total sobre quando o botão deve aparecer
• Acessibilidade: Totalmente compatível com leitores de tela
• SEO Friendly: Não afeta o desempenho do site
• Analytics: Rastreamento integrado com Google Analytics e Facebook Pixel

🚀 Instalação

Instalação Manual

1. Baixe o Plugin

   • Faça o download dos arquivos do plugin
   • Extraia o arquivo ZIP

2. Upload via FTP

   /wp-content/plugins/wblp_plugin_button_whatsapp/

3. Upload via WordPress Admin

   • Acesse Plugins → Adicionar Novo → Enviar Plugin
   • Selecione o arquivo ZIP do plugin
   • Clique em "Instalar Agora"

4. Ativação

   • Vá para Plugins → Plugins Instalados
   • Encontre "Button WhatsApp WBL Produções"
   • Clique em "Ativar"

Requisitos do Sistema

• WordPress: 5.0 ou superior
• PHP: 7.4 ou superior
• MySQL: 5.6 ou superior

⚙️ Configuração

Acesso às Configurações

1. No painel administrativo do WordPress, vá para:

   Configurações → Button WhatsApp WBL Produções

Opções Disponíveis

📞 Número do WhatsApp

• Campo: Número do WhatsApp
• Formato: +55 21 99999-9999
• Obrigatório: Sim
• Exemplo: +55 11 98765-4321

💬 Mensagem Padrão

• Campo: Mensagem Padrão
• Tipo: Texto livre
• Obrigatório: Não
• Exemplo: Olá! Gostaria de mais informações sobre seus serviços.

📍 Posição do Botão

• Inferior Direito (padrão)
• Inferior Esquerdo
• Superior Direito
• Superior Esquerdo

🔄 Ativar/Desativar

• Checkbox: Exibir o botão do WhatsApp no site
• Padrão: Ativado

Salvando as Configurações

1. Preencha todos os campos desejados
2. Clique em "Salvar Configurações"
3. Uma mensagem de sucesso será exibida
4. O botão aparecerá imediatamente no frontend

🎨 Personalização

CSS Personalizado

Para personalizar a aparência do botão, adicione CSS personalizado em: Aparência → Personalizar → CSS Adicional

/* Personalizar cor do botão */
.wblp-whatsapp-button {
    background: #128c7e !important;
}

/* Personalizar tamanho do botão */
.wblp-whatsapp-button {
    padding: 15px 20px !important;
    font-size: 16px !important;
}

/* Ocultar texto em telas pequenas */
@media (max-width: 480px) {
    .wblp-whatsapp-text {
        display: none !important;
    }
}

JavaScript Personalizado

O plugin expõe métodos JavaScript para controle programático:

// Mostrar o botão
WBLPWhatsApp.show();

// Ocultar o botão
WBLPWhatsApp.hide();

// Alternar visibilidade
WBLPWhatsApp.toggle();

// Atualizar configurações
WBLPWhatsApp.update({
    phone_number: '+55 11 99999-9999',
    default_message: 'Nova mensagem'
});

🔧 Hooks e Filtros

Filtros Disponíveis

// Controlar onde o botão deve aparecer
add_filter('wblp_whatsapp_should_display_button', function($should_display) {
    // Não exibir na página inicial
    if (is_front_page()) {
        return false;
    }
    return $should_display;
});

// Personalizar classes CSS do botão
add_filter('wblp_whatsapp_button_classes', function($classes) {
    $classes[] = 'minha-classe-personalizada';
    return $classes;
});

Actions Disponíveis

// Executar código quando o plugin for ativado
add_action('wblp_whatsapp_plugin_activated', function() {
    // Seu código aqui
});

// Executar código quando as configurações forem salvas
add_action('wblp_whatsapp_settings_saved', function($options) {
    // Seu código aqui
});

📱 Responsividade

O plugin é totalmente responsivo e se adapta automaticamente:

Desktop (> 768px)

• Botão com texto e ícone
• Formato pill (arredondado)
• Hover effects completos

Tablet (481px - 768px)

• Botão apenas com ícone
• Formato circular
• Tamanho otimizado

Mobile (≤ 480px)

• Botão compacto
• Posicionamento ajustado
• Touch-friendly

🔒 Segurança

O plugin segue todas as melhores práticas de segurança do WordPress:

• ✅ Verificação ABSPATH em todos os arquivos
• ✅ Sanitização de dados com sanitize_text_field()
• ✅ Escape de saída com esc_html() e esc_url()
• ✅ Nonce verification para formulários
• ✅ Validação de permissões de usuário
• ✅ Prevenção de XSS e SQL Injection

🌐 Internacionalização

O plugin está preparado para tradução:

• Text Domain: wblp-plugin-button-whatsapp
• Pasta de idiomas: /languages/
• Funções utilizadas: __(), _e(), esc_html__()

Traduzindo o Plugin

1. Use ferramentas como Poedit ou Loco Translate
2. Crie arquivos .po e .mo para seu idioma
3. Salve na pasta /languages/

📊 Analytics e Rastreamento

O plugin inclui rastreamento automático para:

Google Analytics 4

gtag('event', 'button_click', {
    event_category: 'WhatsApp Button',
    event_label: 'WBL Produções'
});

Google Analytics Universal

ga('send', 'event', 'WhatsApp Button', 'button_click', 'WBL Produções');

Facebook Pixel

fbq('track', 'Contact', {
    content_name: 'WhatsApp Button Click'
});

🐛 Solução de Problemas

📋 Para um guia completo de solução de problemas, consulte o arquivo TROUBLESHOOTING.md

Problemas Mais Comuns

O botão não aparece

1. Verifique se o plugin está ativado

   • Vá para Plugins → Plugins Instalados
   • Confirme que está ativado

2. Verifique as configurações

   • Acesse Configurações → Button WhatsApp WBL Produções
   • Confirme que o checkbox "Exibir botão" está MARCADO
   • Verifique se o número do WhatsApp está PREENCHIDO
   • Clique em "Salvar Configurações"

3. Verificação rápida no código fonte

   • Pressione F12 → aba "Elements"
   • Procure por wblp-whatsapp no código
   • Se não encontrar, consulte o TROUBLESHOOTING.md

O botão não funciona

1. Verifique o número do WhatsApp

   • Formato correto: +55 11 99999-9999
   • Inclua o código do país

2. Teste o link manualmente

   • Acesse: https://wa.me/5511999999999
   • Substitua pelo seu número

Problemas de estilo

1. Cache do navegador

   • Limpe o cache do navegador
   • Teste em modo incógnito

2. Conflitos de CSS

   • Consulte o TROUBLESHOOTING.md para soluções avançadas

🔄 Atualizações

Como Atualizar

1. Backup: Sempre faça backup antes de atualizar
2. Desative: Desative o plugin atual
3. Substitua: Substitua os arquivos pela nova versão
4. Ative: Reative o plugin
5. Teste: Verifique se tudo funciona corretamente

Compatibilidade

O plugin é testado com:

• ✅ WordPress 6.0+
• ✅ PHP 8.0+
• ✅ Principais temas do WordPress
• ✅ Principais plugins de cache
• ✅ WooCommerce
• ✅ Elementor
• ✅ Gutenberg

📞 Suporte

Canais de Suporte

• Site: wblproducoes.com.br
• Email: contato@wblproducoes.com.br
• WhatsApp: +55 21 99999-9999

Antes de Entrar em Contato

1. Verifique a seção "Solução de Problemas"
2. Teste com outros temas/plugins desativados
3. Verifique se está usando a versão mais recente
4. Tenha em mãos:
   • Versão do WordPress
   • Versão do PHP
   • Tema utilizado
   • Lista de plugins ativos

📄 Licença

Este plugin é licenciado sob a GPL v2 ou posterior.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

👨‍💻 Créditos

Desenvolvido por: WBL Produções
Site: wblproducoes.com.br
Versão: 1.0.3
Última atualização: 15 de Outubro de 2025

Tecnologias Utilizadas

• PHP 7.4+
• JavaScript (ES6+)
• CSS3
• HTML5
• WordPress API
• jQuery

Agradecimentos

• Comunidade WordPress
• Contribuidores do projeto
• Beta testers
• Usuários que reportaram bugs e sugestões

⭐ Se este plugin foi útil para você, considere deixar uma avaliação!