> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modelos de Conta

> Guarda conjuntos prontos de limites, permissões e ajustes de PHP, os planos, para preencher de uma vez o formulário de uma conta de cliente, ao criar ou ao editar.

**Caminho no painel:** menu da esquerda > Configuração > cartão **Modelos** >
**Modelos de Conta**

![Lista de modelos de conta com dois modelos, Completo e Unlimited: espaço de disco, recursos, permissões e ajustes de PHP de cada um, e os ícones de editar e excluir](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/modelos-conta-lista.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=ae7ee5eb348ff4002dec4ff42ae2de7c)

## A lista

Cada linha é um modelo, em ordem alfabética, com o resumo do que ele preenche:

| Coluna | O que mostra |
| - | - |
| **NOME** | o nome do modelo |
| **ESPAÇO DE DISCO** | o limite de disco. O símbolo `∞` quer dizer ilimitado |
| **RECURSOS** | tráfego e as quantidades de domínios, e-mails, bancos, usuários de FTP e tarefas agendadas, também com `∞` para ilimitado |
| **PERMISSÕES** | as 15 permissões. Quadrado verde é ligada, cinza é desligada |
| **PHP / PHP-FPM** | os ajustes de PHP. Os campos longos aparecem como **Mostrar**, que abre o conteúdo ao clicar, e o campo vazio aparece como um traço |
| **AÇÕES** | o lápis, para editar, e a lixeira, para excluir |

## Criar um modelo

1. Clique em **Adicionar modelo de conta**.
2. Em **Nome**, escreva o nome do plano.
3. Ajuste os valores nas quatro abas.
4. Clique em **Salvar**.

O painel responde *"O modelo de conta foi adicionado com sucesso."*

![Começo do formulário de modelo: o Nome e os primeiros recursos, Espaço de Disco, Tráfego e Domínios](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/modelos-conta-adicionar.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=1c2e892f8230e512ceae657b1d9e5039)

As abas são **Geral / Recursos**, **Permissões**, **PHP** e **PHP-FPM**, com os
mesmos campos e os mesmos valores iniciais do formulário de conta. O que cada um
faz está em [Limites e permissões do cliente](/keyhelp-admin/limites-e-permissoes-do-cliente)
e em [PHP e PHP-FPM da conta](/keyhelp-admin/php-do-cliente).

**O que o modelo não guarda:** nome de usuário, senha, e-mail, idioma, as
**Notas**, os dados de contato, as configurações avançadas (suspensão e datas) e
o campo `sendmail_from` da aba PHP. Esses ficam só no formulário da conta.

### O nome não pode repetir

Dois modelos não podem ter o mesmo nome, e a comparação não diferencia maiúscula
de minúscula: com um modelo **Unlimited**, o nome `unlimited` foi recusado com
*"Já existe um modelo de conta com este nome."*

> [!WARNING]
>
> **A recusa do nome apaga o que foi preenchido**
>
> Medido: depois da mensagem, o formulário de modelo novo voltou em branco, com
> os valores iniciais em todas as abas. Na edição, voltou com os valores que
> estavam gravados. Antes de salvar um modelo grande, confira se o nome já não
> existe na lista.

### O modelo aceita valores que a conta recusa

O formulário do modelo não confere os ajustes de PHP. A conferência acontece só
quando o modelo é aplicado a uma conta e ela é salva. Medido, com um modelo para
cada valor, aplicado na edição de uma conta:

| Valor no modelo | O modelo | A conta, ao salvar |
| - | - | - |
| `abc` em `memory_limit` | aceitou | recusou: *"Entrada inválida no campo configurações do PHP memory\_limit."* |
| `pm` em `dynamic`, sem os dois campos de spare | aceitou | recusou: *"Entrada inválida no campo de configurações do PHP-FPM pm.min\_spare\_servers."* e o mesmo para `pm.max_spare_servers` |
| `post_max_size` menor que `upload_max_filesize` | aceitou | **aceitou também**, embora a ajuda da tela diga que ele deve ser maior |

Os valores do segundo caso estão explicados em
[PHP e PHP-FPM da conta](/keyhelp-admin/php-do-cliente).

## Aplicar um modelo numa conta

O campo **Modelo de conta**, com o botão **Aplicar modelo**, fica na aba **Geral**
do formulário de conta, tanto ao criar quanto ao editar.

1. Em **Modelo de conta**, escolha o modelo.
2. Clique em **Aplicar modelo**.
3. Confira as abas e clique em **Salvar**.

**Escolher na lista não aplica nada: o clique em Aplicar modelo é que preenche.**
A introdução desta tela diz o contrário, que *"basta selecionar o nome do plano
desejado e todos os valores serão atribuídos de acordo"*, e isso está medido em
[Criar uma conta de cliente](/keyhelp-admin/criar-conta-de-cliente).

**Medido, com um modelo de valores próprios em todas as abas:**

| Aba da conta | Preenchida pelo modelo |
| - | - |
| **Recursos** | sim, com os valores e as caixas **Ilimitado** |
| **Permissões** | sim |
| **PHP** | sim |
| **PHP-FPM** | sim |
| **Geral**, **Dados de contato** e **Configurações avançadas** | não |

A lista **Modelo de conta** tem duas opções além dos modelos:

| Opção | Com Aplicar modelo |
| - | - |
| **-- Favor selecione --** | nada muda |
| **- Modelo padrão -** | as quatro abas voltam aos valores iniciais do formulário, desfazendo um modelo aplicado antes |

Na edição, salvar a conta com um modelo aplicado vale como qualquer outra
edição: o painel responde *"O usuário ... foi atualizado. As alterações terão
efeito em alguns instantes."*, e a tarefa de fundo do minuto seguinte aplica a
cota de disco nova.

## Mudar um modelo não muda as contas

**O modelo é copiado para a conta no momento em que é aplicado, e o painel não
registra de qual modelo cada conta veio.** Medido numa conta com um modelo
aplicado:

| O que foi feito no modelo | A conta |
| - | - |
| editar o disco, os domínios e o `memory_limit` | **não mudou**, nem depois da tarefa de fundo seguinte |
| excluir o modelo | **não mudou** |

Para mudar os limites de quem já tem um plano, é preciso editar cada conta.

## Excluir

* Na linha do modelo, clique na lixeira.

A tela seguinte mostra o nome e o espaço em disco do modelo e pede a caixa
**Confirmação**. Sem ela marcada, o navegador não deixa excluir. Com ela, clique
em **Excluir**, e o painel responde *"Os seguintes itens foram excluídos."*,
seguido do nome.

![Confirmação de exclusão de um modelo: nome, espaço em disco, a caixa Confirmação e os botões Voltar a visão geral e Excluir](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/modelos-conta-excluir.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=962256dd143f8153fe70332322469786)

Para excluir vários de uma vez:

1. Marque as caixas das linhas.
2. Em **- Ações em massa -**, escolha **Excluir seleção**.
3. Clique em **Aplicar**.
4. Na tela de confirmação, que lista todos os marcados, marque **Confirmação** e clique em **Excluir**.

Clicar em **Aplicar** sem escolher a ação não faz nada.

Excluir um modelo não mexe nas contas que o usaram, como medido acima.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Escolhi o modelo e a conta nasceu vazia** | faltou clicar em **Aplicar modelo** | abrir a conta no lápis, aplicar o modelo e salvar |
| **Mudei o plano e os clientes continuaram com o limite antigo** | o modelo é copiado no momento da aplicação | editar cada conta, ou aplicar o modelo de novo em cada uma |
| **Perdi tudo o que preenchi no modelo** | o nome já existia, e a recusa limpa o formulário | conferir a lista antes e preencher de novo com outro nome |
| **A conta não salva depois de aplicar o modelo** | o modelo tem um valor de PHP que a conta recusa | ler a mensagem, corrigir o valor no modelo e aplicar de novo |
| Os limites de upload não batem | o modelo aceitou `post_max_size` menor que `upload_max_filesize` | deixar o `post_max_size` maior, no modelo e nas contas |

## Ver também

* [Criar uma conta de cliente](/keyhelp-admin/criar-conta-de-cliente), onde o modelo é aplicado
* [Limites e permissões do cliente](/keyhelp-admin/limites-e-permissoes-do-cliente), os campos das abas Recursos e Permissões
* [PHP e PHP-FPM da conta](/keyhelp-admin/php-do-cliente), os campos das abas PHP e PHP-FPM
* [Importar/Exportar as Configurações](/keyhelp-admin/importar-exportar-as-configuracoes), que leva os modelos para outro servidor


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.