Criar e configurar campos de usuário personalizados

[Discourse]

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

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

Os campos personalizados de usuário permitem que você colete informações adicionais de seus usuários, além dos campos padrão do perfil. Esses campos podem ser exibidos nos cartões de usuário, nas páginas de resumo do 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 personalizados de usuário.

Adicionando um campo de usuário

1. Vá para Admin > Community > User Fields (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 “Add user field” para adicionar um novo campo.
   

   

Escolhendo o 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.: “Para 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, em várias linhas (ex.: “Fale um pouco sobre você”)
• Exibido como uma entrada de área de texto HTML de várias linhas

Data

• Use para coletar valores de data (ex.: “Qual é a sua data de nascimento?”)
• Exibido como uma entrada de seletor de data

Confirmação

• Use para perguntas de sim/não (ex.: “Você gostaria de se inscrever na nossa newsletter?”)
• Exibido como uma caixa de seleção HTML
  
  
• Adicione links importantes para os usuários confirmarem usando HTML, por exemplo:
  I agree to read and follow <a href="https://meta.discourse.org/guidelines">the Community guidelines.</a>

Menu suspenso (Dropdown)

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

Para adicionar opções para um campo de menu suspenso:

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

As opções concluídas devem se parecer com isto:

Seleção múltipla

• Use para perguntas em que 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
• As opções são configuradas da mesma forma que os campos de menu suspenso

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 depois da entrada para ajudar os usuários a preencher o campo

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

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

Configurando as opções do 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 é obrigatório para todos os usuários, todas as contas, incluindo usuários conectados, serão forçadas 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 da página do perfil
• Exibir no perfil público: Exibe o valor do campo na página de resumo do usuário
• Exibir no cartão de usuário: Mostra o valor do campo no cartão do usuário
• Buscável: Permite a busca de usuários com base no valor deste campo no diretório de usuários
• Exibir 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.

Exibir no perfil público

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

Exibir no cartão de usuário

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

Buscável

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

Salvando e editando campos

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

Adicionando campos personalizados ao diretório de usuários

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

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

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