Criação e configuração de campos de usuário personalizados

[Discourse]

Este guia explica como criar e configurar campos de usuário personalizados no Discourse, incluindo como adicioná-los ao formulário de inscrição, perfis de usuário e diretório de usuários.

Nível de usuário necessário: Administrador

Os campos de usuário personalizados permitem que você colete informações adicionais de seus usuários além dos campos de perfil padrão. Esses campos podem ser exibidos em cartões de usuário, páginas de resumo de usuário e até mesmo recuperados usando o plugin Data Explorer. Este guia o guiará pelo processo de criação e configuração de campos de usuário personalizados.

Adicionando um campo de usuário

1. Vá para Admin > Comunidade > Campos de Usuário (discourse.example.com/admin/config/user-fields).

2. Se você ainda não criou nenhum campo de usuário, verá esta tela:
   

   

3. Clique no botão “Adicionar campo de usuário” para adicionar um novo campo.
   

   

Escolhendo um tipo de campo

O tipo de campo determina o campo de entrada que os usuários verão no formulário de inscrição. Escolha com base no tipo de informação que você está coletando:

Campo de texto

• Use para perguntas curtas com muitas respostas possíveis (ex: “Em qual empresa você trabalha?”)
• Exibido como uma entrada de texto HTML de linha única
  
  

Área de texto

• Use para perguntas que podem exigir respostas mais longas e de múltiplas linhas (ex: “Fale-nos sobre você”)
• Exibido como uma entrada de área de texto HTML de múltiplas linhas

Data

• Use para coletar valores de data (ex: “Qual é sua data de nascimento?”)
• Exibido como um seletor de data (date picker)

Confirmação

• Use para perguntas de sim/não (ex: “Você gostaria de se inscrever em nossa newsletter?”)
• Exibido como uma caixa de seleção (checkbox) HTML
  
  

Lista suspensa (Dropdown)

• Use para perguntas com um número fixo de respostas possíveis (ex: “Qual é o seu gênero?”)
• Exibido como uma entrada de seleção (select) HTML
  
  

Para adicionar opções a um campo de lista suspensa:

1. Clique na entrada de opção
2. Digite uma resposta e clique em “Criar”
3. Repita para opções adicionais
   
   

As opções completas devem ser parecidas com isto:

Seleção Múltipla (Multiselect)

• Use para perguntas onde os usuários podem escolher várias respostas de um conjunto de opções (ex: “Quais tópicos lhe interessam?”)
• Exibido como uma entrada de seleção múltipla (multi-select)
• Opções são configuradas da mesma forma que os campos de lista suspensa

Definindo o nome e a descrição do campo

• Nome do Campo: Aparece antes da entrada no formulário de inscrição e no perfil do usuário
• Descrição do Campo: Aparece após a entrada para ajudar os usuários a preencher o campo

Tanto o nome do campo quanto a descrição são obrigatórios para salvar um campo.

Veja como os campos personalizados aparecem no formulário de inscrição:

Configurando opções de campo de usuário

Requisitos do Campo

• Opcional - Campos opcionais podem ser deixados em branco pelos usuários
• Para todos os usuários - Quando um campo é exigido por todos os usuários, toda conta, incluindo usuários logados, será forçada a preenchê-lo. Isso é muito útil para casos como um requisito de termos de serviço (ToS).
• Na inscrição - Todas as novas contas serão obrigadas a preencher o campo.

Além disso, na parte inferior do formulário de criação, você encontrará estas caixas de seleção de preferência:

• Editável após a inscrição: Permite que os usuários atualizem o campo a partir de sua página de perfil
• Mostrar no perfil público: Exibe o valor do campo na página de resumo do usuário
• Mostrar no cartão de usuário: Exibe o valor do campo no cartão de usuário
• Pesquisável: Permite a busca por usuários com base no valor deste campo no diretório de usuários
• Mostrar no formulário de inscrição: Controla se o campo aparece no formulário de inscrição. Isso é ativado automaticamente (e não pode ser desativado) quando o requisito do campo é “Para todos os usuários” ou “Na inscrição”, ou quando o campo não é editável após a inscrição.

Mostrar no perfil público

Quando ativado, o valor do campo será exibido na página de perfil do usuário:

Mostrar no cartão de usuário

Quando ativado, o valor do campo será exibido no cartão de usuário:

Pesquisável

Quando ativado, você pode pesquisar usuários com base nos valores de seus campos personalizados:

Salvando e editando campos

1. Clique em “Salvar” para adicionar o campo à lista de campos de usuário do seu site
2. Para editar um campo, clique no botão “Editar” ao lado dele na lista
3. Para excluir um campo, clique no menu de reticências (⋮) ao lado dele e selecione “Excluir”

Adicionando campos personalizados ao diretório de usuários

1. Vá para o diretório de usuários
2. Clique no ícone de chave inglesa:

3. Marque os campos de usuário personalizados que deseja exibir
4. Clique em “Salvar”

Os campos de usuário personalizados selecionados agora aparecerão na tabela do diretório de usuários: