|||
-|-|-|
| Resumo | Validações de Autenticação do Discourse permite adicionar validações personalizadas a um Campo de Usuário para alternar a exibição de Campos de Usuário no Modal de Inscrição.
| Link do Repositório | https://github.com/discourse/discourse-authentication-validations
| Guia de Instalação | Como instalar plugins no Discourse
Sobre
Validações de Autenticação do Discourse adiciona a capacidade de adicionar validações personalizadas a um Campo de Usuário.
Campos de Usuário Personalizados não possuem nenhum tipo de validação fornecida pelo core, além de detectar um valor vazio em um campo obrigatório. Este plugin adiciona a capacidade de definir uma regex, por campo de usuário, que será então verificada contra o valor de entrada fornecido.
Além disso, este plugin adiciona a capacidade de alternar a exibição de Campos de Usuário no Modal de Inscrição. Isso permite que você "conecte" Campos de Usuário, de modo que um Campo de Usuário só seja exibido se um Campo de Usuário anterior tiver um valor específico.
Configuração Básica
1. Habilitar Plugin
O plugin Validações de Autenticação do Discourse pode ser habilitado pelo alternador ou a partir de suas configurações, ambos acessíveis em sua página admin/plugins.
2. Adicionar uma validação personalizada a um Campo de Usuário
Após o plugin Validações de Autenticação do Discourse ter sido habilitado, você verá uma caixa de seleção Incluir Validações Personalizadas na parte inferior do seu formulário de Campo de Usuário.
Quando marcada, ela exibirá três campos adicionais:
- Regex de Validação de Valor
- Mostrar Valores
- Campos de Usuário de Destino
Adicionando uma Validação Personalizada
Inclua uma regex válida no campo Regex de Validação de Valor:
O valor do campo de usuário no formulário de inscrição será agora testado contra a regex que você incluiu. No caso de a entrada não atender aos padrões da sua Regex personalizada, o formulário de inscrição não será enviado.
Nenhum valor (depende da validação padrão do formulário)
Valor incorreto
Valor correto
Conectando Campos de Usuário
Primeiro, inclua um valor Mostrar Valores em um Campo de Usuário.
Quando um Campo de Usuário tem um valor Mostrar Valores incluído, ele observará o valor da entrada anexada até que o valor da entrada corresponda a QUALQUER um dos Mostrar Valores. Ele então alternará a visibilidade de quaisquer Campos de Usuário de Destino incluídos, tornando-os visíveis.
Em segundo lugar, adicione um valor Campos de Usuário de Destino.
No menu suspenso Campos de Usuário de Destino, você verá uma lista de todos os Campos de Usuário disponíveis. Qualquer Campo de Usuário que você selecionar terá sua visibilidade alternada pelos valores correspondentes em Mostrar Valores.
Encadeamento Avançado
Você pode encadear Campos de Usuário adicionando validações personalizadas a vários Campos de Usuário.
Por exemplo, digamos que temos três Campos de Usuário com os valores fornecidos:
| Nome | Possui Validação Personalizada | Mostrar Valores | Campos de Usuário de Destino |
|---|---|---|---|
| Entrada Um | verdadeiro | mostrar-campo-dois | Entrada Dois |
| Entrada Dois | verdadeiro | mostrar-campo-três | Entrada Três |
| Entrada Três | falso |
A Entrada Dois e Três ficarão ocultas por padrão, pois são "filhas" da Entrada Um. Quando o valor de exibição de mostrar-campo-dois for adicionado à Entrada Um, a Entrada Dois será exibida, mas a Entrada Três permanecerá oculta. Ela permanecerá oculta até que a Entrada Dois tenha o valor de mostrar-campo-três.
Com a combinação correta de Mostrar Valores e Classes de Destino, você pode aninhar infinitamente Campos de Usuário uns abaixo dos outros.
