Pular para o conteúdo

Instalação e ativação

O plugin é distribuído como arquivo ZIP — você instala como qualquer plugin WordPress.

ItemMínimo
WordPress5.8
PHP7.4
HTTPSFortemente recomendado (o plugin avisa se o site estiver em HTTP)
Memória PHP64 MB (padrão WP)

Testado oficialmente até WordPress 6.7.

Solicite o arquivo smart2-wp.zip (versão atual: 2.12.2) com a equipe Smart² no atendimento comercial. O plugin é gratuito e está incluído em todos os planos.

  1. Acesse seu painel WordPress em /wp-admin.
  2. Plugins → Adicionar novo → Enviar plugin.
  3. Selecione o arquivo smart2-wp.zip baixado.
  4. Clique em Instalar agora.
  5. Após o sucesso, clique em Ativar plugin.

Se preferir upload manual ou se seu plano de hospedagem não permitir upload de plugins pelo painel:

  1. Extraia o smart2-wp.zip localmente — você terá uma pasta smart2-wp/.
  2. Conecte ao servidor via FTP (FileZilla, Cyberduck) ou SSH (SCP).
  3. Envie a pasta smart2-wp/ inteira pra wp-content/plugins/ do seu site.
  4. No painel WordPress, vá em Plugins → Plugins instalados.
  5. Encontre “app.smart CRM” e clique em Ativar.

A estrutura final deve ser:

wp-content/plugins/smart2-wp/
├── smart2-wp.php
├── readme.txt
├── uninstall.php
├── assets/
├── includes/
└── languages/

Ao ativar pela primeira vez, o plugin:

  1. Cria registro de configuração no banco — a opção smart2_wp_options no wp_options. Todos os campos começam vazios ou com defaults sensatos (WhatsApp tracking ligado, honeypot ligado, JS fallback ligado, logs ligados).
  2. Cria pasta de logs em wp-content/uploads/smart2-logs/ com proteção:
    • .htaccess (Apache nega acesso direto)
    • index.html vazio (evita listagem)
    • web.config (IIS nega acesso)
    • Filename do log é randomizado (smart2-debug-{16 hex}.log) — mitigação extra pro nginx que ignora .htaccess.
  3. Adiciona menu em Configurações → app.smart CRM no admin.

No menu Plugins → Plugins instalados, “app.smart CRM” deve aparecer com:

  • Versão 2.12.2
  • Status Ativado (link “Desativar” disponível)
  • Sem mensagem de erro vermelha

Se você acessar o painel logo após ativar e ainda não configurou, vai ver um aviso amarelo no topo:

⚠ app.smart CRM: plugin não configurado. Acesse Configurações → app.smart CRM pra ligar a conexão.

Esse aviso desaparece quando você configurar a conexão.

Se o site não está em HTTPS, aparecerá também um aviso vermelho recomendando subir certificado SSL antes de usar em produção.

Pra atualizar a uma versão nova, não precisa desativar nem apagar nada:

  1. Plugins → Adicionar novo → Enviar plugin → escolha o ZIP novo.
  2. O WordPress avisa que o plugin já existe e mostra as duas versões lado a lado. Clique em Substituir a versão atual pela enviada.
  3. O plugin continua ativo, com as mesmas configurações.

O plugin ainda não está no diretório oficial do WordPress.org — por isso não aparece em Atualizações. A publicação lá está planejada; enquanto isso, a equipe Smart² avisa quando sai versão nova e manda o ZIP.

As configurações são preservadas entre atualizações — o plugin guarda tudo em wp_options e só apaga ao desinstalar (não ao desativar). Token criptografado também persiste.

Pra remover o plugin e todos os dados que ele guardou:

  1. Plugins → Desativar “app.smart CRM”
  2. Plugins → Apagar (vai aparecer botão vermelho)
  3. Confirme a remoção

O arquivo uninstall.php é executado automaticamente e remove:

  • A opção smart2_wp_options (toda a configuração)
  • A opção smart2_wp_log_hash (nome aleatório do log)
  • Toda a pasta wp-content/uploads/smart2-logs/ (logs)
  • Todos os transients smart2_* (cache temporário)

Os dados que já foram pro app.smart continuam lá — desinstalar o plugin só remove a integração local.