Ir para o conteúdo principal

Guia: Como remover o plugin

Objetivo

Remover o plugin de rastreamento de entrega, deixando o painel no estado em que ele estava antes — e decidir conscientemente o que fazer com os dados já coletados.


Escopo e Público

  • Aplica-se a: servidores cPanel/WHM e DirectAdmin com o plugin instalado.
  • Não cobre: atualizar para uma versão nova, que não exige remover — veja Como manter o plugin atualizado.
  • Público-alvo: administrador com acesso root por SSH.

O que a remoção garante

Depois de rodar, o painel fica exatamente como estava antes da instalação. No cPanel, isso inclui devolver a tela nativa de rastreamento, se você a tinha escondido.

O banco de e-mail do painel continua byte a byte o mesmo: o plugin só o leu, da instalação à remoção, e desinstalar não é o momento em que isso deixa de ser verdade.


⚠ Use a cópia que está no servidor

O instalador deixa o desinstalador ao lado da coisa que ele remove:

/opt/sender25-tracking/scripts/uninstall.sh                 # cPanel/WHM
/opt/sender25-tracking/scripts/uninstall-directadmin.sh     # DirectAdmin

Prefira sempre essa cópia, e não a de um pacote que você tenha baixado. Ela é o desinstalador da versão que está de fato instalada. Quando uma versão muda um caminho, o desinstalador de outra versão aponta para diretórios que não existem mais — e a remoção não faz nada, em silêncio.

O arquivo /opt/sender25-tracking/VERSION diz qual versão é essa. É o único lugar no servidor que responde a pergunta.


Passos (sequência)

Passo 1 — Ver antes o que ele faria
/opt/sender25-tracking/scripts/uninstall.sh --dry-run

Imprime tudo que a remoção faria, sem tocar em nada.

Passo 2 — Remover

cPanel/WHM:

flock -w 420 /tmp/sender25-tracking-sync.lock \
  -c "/opt/sender25-tracking/scripts/uninstall.sh"

DirectAdmin:

flock -w 420 /tmp/sender25-tracking-directadmin-sync.lock \
  /opt/sender25-tracking/scripts/uninstall-directadmin.sh

A trava vale pelo mesmo motivo da atualização: o coletor está rodando e os arquivos dele vão sumir.

No cPanel, a remoção devolve a tela nativa, tira o registro das duas telas do plugin, apaga os arquivos e o agendamento, e reinicia o cpsrvd — a mesma interrupção breve da instalação.

No DirectAdmin, remover os arquivos do plugin e o agendamento é todo o serviço do desinstalador. Nenhum reinício de painel, nem antes nem depois.

Mas se você substituiu a tela nativa, desfaça isso primeiro — à mão. A troca é uma personalização de menu do próprio painel, não um arquivo do plugin, então o desinstalador não a alcança. Removendo o plugin sem desfazê-la, os seus clientes ficam com a tela nativa de rastreamento ainda desabilitada e um item de menu que não abre nada. O caminho é o mesmo da instalação, ao contrário: em Personalizar Skin → Identidade visual → Menu, reabilite user/email/tracking na categoria E-mail Manager e apague a entrada que aponta para o plugin. Ver Como instalar o plugin no DirectAdmin.


Os dados coletados

Por padrão eles são mantidos. São a resposta para "o que aconteceu com o meu e-mail semana passada", e apagá-los em silêncio só porque o plugin foi removido seria uma troca ruim. Ficam em /var/lib/sender25-tracking.

Isso também significa que, se você reinstalar depois, o histórico ainda está lá.

Para apagá-los, é preciso pedir explicitamente:

/opt/sender25-tracking/scripts/uninstall.sh --purge

⚠ --purge é irreversível. Use quando estiver desativando o serviço de vez, ou quando houver exigência de descarte.


Problemas comuns

Rodei o desinstalador e a tela do plugin continua no menu

Quase sempre é ter rodado o desinstalador de outra versão, que aponta para caminhos antigos e não encontra nada para remover. Use a cópia em /opt/sender25-tracking/scripts/.

Removi o plugin e quero o histórico de volta

Se você não passou --purge, ele está em /var/lib/sender25-tracking e volta a ser usado quando o plugin for reinstalado — veja cPanel/WHM ou DirectAdmin.

A tela nativa do cPanel não voltou

O desinstalador a restaura como primeiro passo, antes de remover qualquer coisa — justamente para que uma falha adiante não deixe o painel sem nenhuma tela. Se ela não voltou, confira se o desinstalador chegou a rodar até o fim.


Controle de Mudanças

Informações de controle de versão
  • Última revisão 02-09-2026
  • Próxima revisão 02-03-2027
  • Autor Sender25
  • Versão 1.0