blog
Revenda

Deixar cPanel e webmail em português em toda a revenda

Como aplicar pt_br em lote pelo WHM, deixar o Roundcube abrindo em português e responder ao cliente que reclama das mensagens que continuam em inglês.

JR · · 7 min de leitura · 1 tabela · 3 blocos de código

Resposta curta: padronize pelo WHM em vez de ajustar conta por conta: defina `locale=pt_br` como padrão em Tweak Settings e na criação de contas, aplique em lote nas antigas com `whmapi1 modifyacct` sobre uma lista revisada, e saiba que bounces do Exim e erros de PHP seguem em inglês por virem de fora do painel.

Neste artigo
  1. O que o locale da conta cPanel traduz e o que fica fora do alcance dele
  2. As duas frentes que fazem a conta nova já nascer em pt_br
  3. Trocar o locale das contas antigas em lote com whmapi1 modifyacct
  4. Webmail em português, e por que a caixa antiga continua em inglês
  5. Bounce, erro de PHP e string sem tradução: de onde vem cada mensagem em inglês
  6. Checklist para padronizar o idioma de toda a revenda
  7. A resposta pronta para o cliente que reclama de mensagem em inglês

O que o locale da conta cPanel traduz e o que fica fora do alcance dele

No cPanel, idioma é um atributo da conta, não do navegador. Cada conta cPanel carrega um locale (no caso do português do Brasil, pt_br), e é ele que decide em que língua a interface aparece quando o cliente faz login. Trocar o idioma no rodapé do cPanel muda uma conta. Quem administra uma revenda com dezenas de clientes não quer fazer isso uma por uma, e nem quer que a conta criada amanhã nasça em inglês de novo.

O locale alcança a interface do cPanel, os nomes dos ícones, os assistentes e boa parte das mensagens geradas pelo próprio cPanel. Ele não alcança o texto que vem de fora: retorno do Exim, do Dovecot, do MySQL, do PHP e de plugins de terceiros continuam no idioma em que foram escritos. Isso não é falha de configuração, é limite de escopo, e é a parte que mais gera reclamação de cliente. Volto nela no fim.

A documentação oficial do recurso de idiomas no WHM está em Configure Application Locales, que é também onde se editam e se criam traduções customizadas.

As duas frentes que fazem a conta nova já nascer em pt_br

Duas frentes, e vale cuidar das duas porque elas cobrem caminhos diferentes de criação de conta. Aviso de método: a documentação que citei acima cobre a edição de locales, não os caminhos de Tweak Settings nem os parâmetros da API de contas. O que vem abaixo é prática de operação, conferida no WHM e na saída do whmapi1, e os nomes de menu e de parâmetro mudam entre versões. Confira o que aparece na sua tela antes de automatizar.

Onde fica o locale padrão do servidor no Tweak Settings

No WHM, em Server Configuration » Tweak Settings, busque por locale no campo de pesquisa da própria página. A opção de locale padrão define o idioma atribuído a contas criadas sem que o idioma seja informado explicitamente. Se o seu WHM não expuser essa opção (o conjunto de tweaks varia conforme versão e perfil do servidor, e em revenda você depende do que o provedor habilitou), siga pela frente seguinte, que funciona em qualquer caso.

Passar locale=pt_br no formulário de criação e na API de billing

Ao criar conta em Account Functions » Create a New Account, o formulário tem o campo de locale. Deixe Portuguese (Brazil) selecionado. Se você cria contas por API ou por integração com o sistema de billing, passe o parâmetro explicitamente, que é mais confiável que depender de padrão global:

whmapi1 createacct user=exemplo domain=exemplo.com.br \
  plan=revenda_basico locale=pt_br

O valor exemplo acima é fictício, troque pelos seus. O que importa é o par locale=pt_br: com ele na chamada, nenhuma mudança futura de padrão global quebra o seu fluxo.

Trocar o locale das contas antigas em lote com whmapi1 modifyacct

Para as contas antigas, o caminho manual é WHM » Account Functions » Modify an Account, trocar o locale e salvar. Para dezenas de contas, use a API. Vale a mesma ressalva: modifyacct com locale= é uso de operação, não procedimento transcrito da documentação citada; valide o retorno da chamada em vez de confiar no silêncio.

Primeiro liste e confira. Nunca rode o loop antes de ver a saída da listagem:

# 1. listar usuário, dono e locale atual das contas que você enxerga
whmapi1 --output=json listaccts \
  | jq -r '.data.acct[] | [.user, .owner, .locale] | @tsv'

# 2. filtrar pelo seu usuário de revenda e guardar em arquivo para revisar
whmapi1 --output=json listaccts \
  | jq -r '.data.acct[] | select(.owner=="seurevendedor") | select(.locale!="pt_br") | .user' \
  > contas-pt-br.txt

# 3. conferir o locale atual de uma conta específica
whmapi1 --output=json accountsummary user=exemplo | jq '.data.acct[0].locale'

O filtro importa por dois motivos. listaccts sem filtro devolve tudo que o seu usuário enxerga, não só o que é seu, e o laço grava pt_br em cima de quem talvez tenha escolhido outro idioma de propósito (cliente que prefere inglês, ou espanhol). Abra o contas-pt-br.txt, tire quem não deve entrar e só então rode o lote.

Confirmada a lista, aplique:

while read -r u; do
  [ -z "$u" ] && continue
  echo "== $u"
  whmapi1 --output=json modifyacct user="$u" locale=pt_br \
    | jq -r '.metadata.result, .metadata.reason'
done < contas-pt-br.txt | tee lote-locale-$(date +%F).log

O jq no fim imprime 1 e OK por conta: se aparecer 0 com uma razão, você tem o erro na tela em vez de um loop silencioso. Causas comuns de falha: conta suspensa, usuário fora da sua revenda e permissão de reseller sem o privilégio de modificar contas. Nesse último caso, só o administrador do servidor resolve.

Se você não tem acesso a shell no WHM, faça por Modify an Account mesmo, e priorize os clientes que mais abrem chamado.

Troca de locale em lote, passo a passoListar contaslistaccts com user, owner, localeFiltrar e salvarsó seu revendedor, locale diferenteRevisar arquivotirar quem escolheu outro idiomaRodar o laçomodifyacct locale=pt_br com logConferir amostraaccountsummary em algumas contas
Nunca rode o laço antes de ler a listagem filtrada.

Webmail em português, e por que a caixa antiga continua em inglês

O webmail herda o locale da conta cPanel, então a troca acima já faz o Roundcube abrir em português para quem nunca mexeu na preferência. A pegadinha é o endereço de e-mail que já entrou no Roundcube alguma vez: o Roundcube guarda preferência por caixa postal, e a preferência salva vence o padrão da conta.

Para essas caixas, o próprio usuário resolve em Roundcube » Configurações » Preferências » Interface de usuário » Idioma, selecionando Português (Brasil) e salvando. Vale avisar o cliente de que a mudança é por caixa postal, não por domínio: trocar em contato@ não troca em financeiro@.

Na interface jupiter, o seletor de idioma do cPanel fica no rodapé da página e no menu de usuário. É o caminho para o cliente que você não quer tirar do autoatendimento.

Bounce, erro de PHP e string sem tradução: de onde vem cada mensagem em inglês

Origem da mensagem Segue o locale pt_br Observação
Interface e ícones do cPanel Sim Traduzido pelo cPanel
Interface do Roundcube Sim, salvo preferência salva na caixa Preferência por caixa postal vence
Retorno de entrega do Exim (bounce) Não Texto do servidor de e-mail, em inglês
Erro de login do Dovecot Não Texto do servidor IMAP/POP
Erro de PHP, MySQL, WordPress plugin Não Vem da aplicação, não do painel
String nova do cPanel ainda sem tradução Não Cai no inglês de origem

Esse último caso tem conserto, mas não na sua mão se você é revendedor: WHM » Locales » Configure Application Locales é área de administrador do servidor, acessível com WHM root. Em uma conta de reseller o item não aparece. Lá dá para editar as frases de um locale e cadastrar tradução própria para strings específicas, conforme a documentação do cPanel. Se a frase incomoda de verdade, o caminho é pedir ao provedor, mesmo caminho do Tweak Settings. E pese o custo antes de pedir: tradução customizada é manutenção sua a cada atualização. Na prática, só compensa para uma frase que aparece em tela que o seu cliente usa toda semana.

O que o pt_br alcança e o que não alcançaSegue o locale0Ignora o locale0
Leia a mensagem antes de mexer no locale da conta.

Checklist para padronizar o idioma de toda a revenda

  1. Definir o locale padrão em Tweak Settings, se a opção existir no seu WHM.
  2. Passar locale=pt_br na criação de conta, no WHM e na integração de billing.
  3. Gerar a lista filtrada, revisar o arquivo e rodar o laço de modifyacct guardando a saída em log.
  4. Reconferir uma amostra por accountsummary depois do lote.
  5. Abrir o webmail de uma caixa antiga e de uma caixa nova, para ver a diferença entre preferência salva e padrão herdado.
  6. Incluir no e-mail de boas-vindas ao cliente a instrução de trocar o idioma do Roundcube por caixa postal.
  7. Repetir o lote de modifyacct quando migrar contas de outro servidor, porque a migração traz o locale de origem.

Vale uma observação contra o meu próprio interesse: se o cliente reclama de "painel em inglês" mas o que ele vê em inglês é bounce de e-mail, nenhuma configuração de painel resolve. Leia a mensagem antes de mexer no locale.

A resposta pronta para o cliente que reclama de mensagem em inglês

Use esta, ou uma variação dela, quando vier a reclamação de mensagem em inglês depois da troca:

A última linha é a que fecha o assunto de verdade: o cliente não quer tradução, quer entender o que está acontecendo. Resolver o significado da mensagem encerra o chamado melhor do que traduzir a mensagem.

Referências

  1. Documentação oficial (cpanel) — Configure Application Locales (WHM). Consultado em 2026-10-09.
Leia também