blog
Revenda

Logo da agência no cPanel sem perder tudo no update

Logotipo, favicon e cores aplicados no nível da revenda duram; arquivo de tema editado na mão não dura. Mapa do que sobrevive, checklist para padronizar contas novas e a frase para alinhar expectativa com o cliente.

JR · · 9 min de leitura · 1 tabela · 2 blocos de código

Resposta curta: a marca da agência no cPanel se aplica no WHM da revenda, em três camadas: logotipo e favicon (configuração, sobrevivem à atualização), cores via cPanel Styles (sobrevivem, mas podem exigir ajuste) e edição direta do tema, que é sempre desfeita pelo update.

Neste artigo
  1. As três camadas de marca do cPanel e por que elas duram tempos diferentes
  2. O que sobrevive à atualização do cPanel e o que é sobrescrito
  3. Por que a marca se aplica no WHM da revenda e não conta por conta
  4. Checklist de padronização por marca atendida
  5. A logo não aparece: como descobrir se é cache, nível errado ou arquivo inválido
  6. O que você não deve prometer ao cliente sobre a personalização
  7. O que responder quando o cliente pergunta de quem é o painel
  8. Rotina de cinco minutos para conferir a marca depois de cada atualização

As três camadas de marca do cPanel e por que elas duram tempos diferentes

Quando o cliente abre o painel, ele vê três camadas diferentes, e elas têm durabilidades diferentes. Confundir as três é a origem de quase todo branding que "sumiu depois da atualização".

A regra prática que resolve 90% das decisões: o que você preenche em formulário tende a sobreviver; o que você sobrescreve em arquivo do tema vai embora. A documentação oficial de temas da cPanel é explícita quanto ao risco de modificar temas padrão, e orienta criar um estilo ou tema próprio em vez de editar o original (Themes, docs.cpanel.net).

Três camadas de marca e sua durabilidadeMarcaFormulário no WHM, sobreviveEstiloCSS próprio, sobrevive com ressalvaTemaCódigo do fornecedor, sobrescrito
O que é formulário tende a durar; o que é arquivo do tema volta ao original a cada atualização.

O que sobrevive à atualização do cPanel e o que é sobrescrito

Item Onde se configura Sobrevive ao update do cPanel
Logotipo do cabeçalho WHM, área de customização de marca Sim, é configuração
Favicon WHM, mesma área de customização Sim
Nome público / contato da agência WHM, customização de marca Sim
URL de ajuda e de documentação WHM, customização de marca Sim
Cores e CSS via cPanel Style próprio WHM, Styles (estilo enviado por você) Normalmente sim, mas pode quebrar visualmente se o tema mudar a marcação
Edição direta de arquivos do tema Jupiter /usr/local/cpanel/base/frontend/jupiter/ Não. É sobrescrito
Troca do tema padrão por tema de terceiros Pacote / conta Depende do fornecedor do tema, não da cPanel
Texto de rodapé injetado por plugin de terceiro Plugin Depende do plugin

A linha do meio é a que dá dor de cabeça em agência. Um estilo seu continua lá depois do update, o arquivo continua existindo, mas se o tema reorganizou classes CSS o resultado visual pode sair torto. Por isso estilo customizado entra no checklist de verificação pós-atualização, não no "configurei e esqueci".

Por que a marca se aplica no WHM da revenda e não conta por conta

Se você é revendedor, trabalhe sempre de cima para baixo: ajuste no WHM da revenda, não conta por conta. A customização de marca no WHM vale para as contas sob aquela revenda, então um ajuste atende o portfólio inteiro, inclusive contas futuras.

Como preparar logo, favicon e cores antes de abrir o WHM

Tenha a logo em PNG com fundo transparente e o favicon em .ico ou PNG quadrado. Logo muito alta estoura o cabeçalho; prefira uma versão horizontal, enxuta, legível a 30 px de altura. Teste no escuro e no claro, porque o cabeçalho do Jupiter não é branco puro.

Um checklist de nomes padronizados economiza tempo quando você tem várias marcas:

branding/
  agencia-x/
    logo-cpanel.png      # horizontal, fundo transparente
    favicon.ico
    cores.txt            # #hex primário, secundário, link
    links.txt            # URL de suporte, URL de documentação

No WHM, abra a área de customização (Customization) e preencha logotipo, favicon, nome público e os links de ajuda/documentação. Salve e abra o cPanel de uma conta de teste em janela anônima. Cache de navegador engana muito nessa hora, e favicon é o campeão de cache teimoso.

Mudar cores com cPanel Style em vez de editar o tema Jupiter

Para cor, use o recurso de Styles do WHM, que permite disponibilizar estilos próprios para as contas. A documentação de temas da cPanel descreve estilo como a maneira suportada de alterar aparência sem tocar no tema original (docs.cpanel.net/whm/themes). Esse é o ponto que separa trabalho que dura de trabalho que você vai refazer.

Se a tentação de abrir o diretório do tema e trocar uma cor no CSS aparecer, lembre do custo real: a próxima atualização restaura o arquivo, o cliente vê a mudança sumir, e você gasta uma hora para descobrir que não foi "bug do servidor".

Deixar o estilo padrão e o cpanel3-skel prontos para contas novas

Duas coisas devem estar prontas antes do próximo cliente entrar:

Quem já organizou Feature List e versão padrão de PHP por revenda reconhece o padrão: o trabalho é configurar o molde, não repetir a tarefa em cada conta.

Checklist de padronização por marca atendida

Use isto como procedimento interno, uma passada por marca atendida.

  1. Arquivos de marca validados (logo horizontal, favicon quadrado, hex das cores).
  2. Logo e favicon aplicados na customização do WHM da revenda.
  3. Nome público e contato de suporte apontando para a agência, não para o fornecedor.
  4. URL de ajuda apontando para a sua base de conhecimento ou para o formulário de chamado.
  5. Estilo de cores criado e definido como padrão da revenda.
  6. cpanel3-skel com página inicial da agência e, se fizer sentido, um robots.txt que bloqueie a indexação do provisório.
  7. Conta de teste criada do zero para conferir se tudo apareceu sem intervenção manual.
  8. Print do cPanel já personalizado guardado na pasta do cliente, com data. Serve de prova em caso de dúvida futura.
  9. Registro no seu controle de qual versão do cPanel estava ativa quando o estilo foi criado.
  10. Revisão agendada: depois de cada atualização maior do painel, abrir uma conta e olhar.

O item 9 parece burocracia e é o que mais ajuda. Quando o visual quebra, a primeira pergunta é "o estilo foi feito para qual versão do tema".

A logo não aparece: como descobrir se é cache, nível errado ou arquivo inválido

Antes de abrir chamado com o provedor, elimine as causas banais, nesta ordem:

Para saber se o navegador está recebendo o arquivo novo ou uma cópia velha, pegue a URL do próprio ativo: abra o cPanel logado, clique com o botão direito no logotipo e copie o endereço da imagem (o favicon costuma estar no <link rel="icon"> do HTML). Depois peça só os cabeçalhos dessa URL:

curl -sI 'https://seuservidor.com.br:2083/cpsess0000000000/<caminho-do-ativo>.png'

Três cabeçalhos respondem a pergunta:

Se Last-Modified e ETag já refletem o arquivo novo e mesmo assim a tela continua velha, o problema está no cache do navegador ou em algum intermediário, não na configuração. Isso evita que você desfaça um ajuste correto por achar que não funcionou.

Diagnóstico quando a logo não apareceJanela anônimaElimina cache do navegadorNível da configuraçãoWHM da revenda, não contaArquivo do ativoFormato e dimensão válidoscurl -sI no ativoChecar Last-Modified e ETagProxy ou CDNCache intermediário preso
Ordem de verificação antes de abrir chamado com o provedor.

O que você não deve prometer ao cliente sobre a personalização

Três coisas estão fora do seu controle, e vender o contrário cria conflito depois:

Coloque isso no escopo do contrato com uma linha só: "personalização visual do painel (logotipo, favicon, cores e contatos de suporte), sujeita a ajustes após atualizações do fabricante do painel". Protege os dois lados e evita a conversa chata seis meses depois.

O que responder quando o cliente pergunta de quem é o painel

Quando o cliente perguntar de quem é o painel, ou quando notar o nome "cPanel" na tela, uma resposta curta encerra o assunto sem prometer o impossível:

Para e-mail de onboarding, uma variação ainda mais curta funciona melhor:

A segunda frase é a mais importante: você antecipa a mudança e já se posiciona como quem resolve. Cliente que foi avisado não abre reclamação, abre pedido.

Rotina de cinco minutos para conferir a marca depois de cada atualização

Depois de qualquer atualização relevante do painel, faça a mesma passada curta, sempre na mesma ordem, para não depender de memória:

  1. Abrir o cPanel de uma conta real em janela anônima.
  2. Conferir logotipo no cabeçalho e favicon na aba.
  3. Conferir se o link de ajuda ainda aponta para a sua base de conhecimento.
  4. Conferir se as cores do estilo continuam coerentes (menu, botões, cabeçalho).
  5. Criar uma conta de teste e descartar, só para validar que o padrão de contas novas continua aplicado.

Se algo quebrou, corrija o estilo, não o tema. Refazer um estilo leva minutos; refazer uma customização de tema leva horas e quebra de novo no próximo ciclo. É a diferença entre uma entrega que se mantém sozinha e uma que vira manutenção recorrente não faturada.

Referências

  1. Documentação oficial (cpanel) — Themes. Consultado em 2026-10-07.
Leia também