Formulários

​

Visão geral

​

Configure um formulário em cinco passos

1

Crie o formulário

!form create staff Candidatura para a equipe cria um formulário chamado staff com o título que os membros veem (45 caracteres). Um formulário novo fica fechado até você abri-lo.

2

Adicione as perguntas

!form question add staff short Quantos anos você tem? adiciona uma pergunta no final. Veja Perguntas para os tipos e as opções.

3

Escolha o canal de revisão

!form set staff channel #candidaturas é onde os cards chegam. Um formulário sem canal de revisão não pode ser aberto.

4

Abra o formulário

!form open staff deixa os membros responderem.

5

Publique um painel

!form panel #candidate-se staff publica um botão que abre o formulário. Um painel pode abrir vários formulários: !form panel #candidate-se staff partner --style select cria um menu em vez de botões, e --web yes adiciona um botão de link Preencher na web.

​

Comandos

!form create <name> [title]
!form delete <form>
!form list
!form info <form>
!form open <form>
!form close <form>
!form relink <form>
!form set <form> <setting> <value>
!form message <form> <submitted|accepted|denied> [text] [template]
!form questions <form>
!form question add <form> <type> <label> [required] [help] [description] [image] [placeholder] [min] [max] [options] [choices]
!form question edit <form> <position> <field> <value>
!form question move <form> <from> <to>
!form question remove <form> <position>
!form panel <channel> <forms> [style] [template] [title] [description] [web]
!form submissions [form] [status]
!form view <number>
!form accept <number> [reason]
!form deny <number> [reason]
!form retention [days]

!form create staff "Candidatura para a equipe"
!form question add staff paragraph Por que você quer entrar para a equipe?
!form question add staff choice Em que fuso horário você está? --options "América|Europa|Ásia|Outro"
!form set staff channel #candidaturas
!form set staff accept-roles @Ajudante
!form open staff
!form panel #candidate-se staff --web yes
!form accept 12 Boas-vindas à equipe!

!form list

!form close

!form delete

​

Perguntas

• required: se uma resposta é necessária (sim, por padrão).
• help: uma linha embaixo da pergunta, com até 100 caracteres. O Discord a mostra embaixo do campo.
• description: um texto mais longo, com até 1.000 caracteres, com negrito, itálico e links. A página web o mostra inteiro; o Discord mostra o começo dele quando não há linha help.
• image: uma imagem acima da pergunta na página web, um link https para um arquivo .png, .jpg, .gif ou .webp.
• placeholder: o texto cinza no campo vazio.
• min e max: o tamanho de um texto, ou o intervalo de um número.
• options: para choice e multi, separadas por |.

!form question edit staff 2 description Conte sobre **qualquer** servidor que você ajudou a cuidar. [Nossas regras](https://example.com/rules)
!form question edit staff 2 image https://example.com/banner.png
!form question move staff 3 1
!form questions staff

!form question edit

!form question move

!form question remove

!form questions

Página 1 de 2

Próxima

Uma resposta errada

Enviado

​

Configurações

​

Mensagens para o membro

• submitted: quando as respostas são enviadas.
• accepted e denied: a DM com o resultado.

!form message staff accepted "Boas-vindas à equipe, {user}! Leia o #regras-da-equipe primeiro."
!form message staff denied --template staff-denied

!form message staff accepted

!form message staff submitted

​

Revisando

• Aceitar e Recusar (com um motivo opcional que o membro lê). Os cargos do formulário são dados e retirados, o membro recebe uma DM e a categoria forms do log ganha uma linha.
• Abrir tópico abre um tópico embaixo do card para conversar sobre a resposta.

Aceitar

O card depois

!form accept

!form deny

!form submissions

!form view

​

A página web

• !form info <form> dá o link, petto.sbs/form/<id>, em que o id são 12 letras e números aleatórios (/es/form/<id> e /pt-br/form/… o abrem em espanhol ou em português). Colado no Discord ou em outros apps, ele mostra uma prévia com o título, a descrição e o banner do formulário. Os links antigos petto.sbs/form#… e petto.sbs/f/… continuam funcionando.
• Os links são aleatórios, então ninguém consegue adivinhá-los. !form relink <form> cria um novo, e o antigo deixa de funcionar na hora. Os painéis publicados antes continuam com o link antigo, então publique-os de novo.
• !form set <form> web off mantém um formulário só no Discord.

!form info

!form relink

!form set staff color #ff91c2
!form set staff banner https://example.com/staff-banner.png
!form set staff background gradient
!form set staff server-icon off

• Cor: o destaque da página (botões, links, números).
• Banner: uma imagem em cima (um link https para um .png, .jpg, .gif ou .webp).
• Fundo: default (o do Petto), solid (um tom da cor) ou gradient. Com o Premium há também dois animados, aurora e waves, feitos a partir da cor do formulário; eles se movem devagar e ficam parados para visitantes cujo dispositivo pede menos movimento.
• Ícone do servidor e nome do servidor no cabeçalho; cada um pode ser escondido.
• Marca: com o Premium, !form set <form> branding off esconde a linha pequena “Formulários por Petto” no fim da página.

​

Armazenamento e limites

​

Dashboard

• Formulários: crie e edite formulários, as perguntas (com a descrição e a imagem), as regras, os cargos, as mensagens e a página web.
• Respostas de formulários: as respostas por formulário e estado, com busca, e Aceitar e Rejeitar.
• Painéis de formulários: publique um painel com botões ou um menu.

Formulários

Respostas de formulários

Painéis de formulários

​

Problemas comuns

Os membros dizem que o formulário não está pronto

O formulário não tem canal de revisão. Defina um com !form set <form> channel #canal.

O botão do painel não faz nada

O formulário está fechado. Abra-o com !form open <form>. !form panel lembra quais formulários do painel estão fechados.

Um link web antigo não abre

O formulário ganhou um novo link. Use o link novo do !form info e publique os painéis de novo.

Um cargo não foi dado

O cargo está acima do cargo mais alto do Petto ou é gerenciado por um app. Mova o cargo do Petto para cima dele; veja Problemas de permissão.