# Badges e Certificados
Atualmente as opções são:
* Badge avulso, quando um usuário completa um treinamento, **independente da pontuação** obtida.
* Badge avulso, quando um usuário completa um treinamento, **dependendo da pontuação** obtida.
* Badge avulso, quando um usuário completa um módulo, **independente da pontuação** obtida.
* Badge avulso, quando um usuário completa um módulo, **dependendo da pontuação** obtida.
* [Certificado](#tipo-certificado-treinamento-completado), quando um usuário completa um treinamento.
O botão "Restaurar Badges" permite que um badge deletado seja ativado novamente.
O botão "Adicionar Badge" permite cadastrar um badge do zero.
## Criando um novo Badge
## Tipo "Treinamento Completado"
* Tipo: Selecione o tipo **"Treinamento Completado"**
* Campo **"Treinamento Completado"**: permite escolher o treinamento específico do badge.
* Campo **"Título"**: nome do badge (sem aspas)
* Campo **"Subtítulo"**: texto curto, exibido logo abaixo do "Título" na visualização do badge.
* Campo **"Texto"**: descrição do badge; texto completo que aparecerá na área de "Conquistas" do usuário.
Caso não seja preenchido, o texto é gerado automaticamente. Ex: Certificado "xxxxx" disponível.
* Campo **"Imagem"**: imagem do badge, no tamanho de 500x500px.
* Campo **"Cor Hexa"**: cor do badge; aparecerá na área de "Conquistas" do usuário.
* Campo **"Share - Título"**: é o título do badge que aparecerá na rede social, quando ele for compartilhado pelo usuário.
* Campo **"Share - Descrição"**: é a descrição do badge que aparecerá na rede social, quando ele for compartilhado pelo usuário.
* Campo **"Share - Imagem"**: é a imagem do badge (1200x630px) que aparecerá na rede social, quando ele for compartilhado pelo usuário.
**Exemplo Share:**
Exemplo de cadastro de badge e compartilhamento em redes sociais
* Campo **"Chave Única"**: é a identificação do badge no LMS; algo único e específico desse badge, para que você cadastre para facilitar buscas futuras.
## Tipo "Treinamento Completado com Pontuação Min/Max"
Mesma lógica do cadastro anterior, porém, com a opção de ter múltiplos níveis de badges de acordo com a pontuação obtida pelo usuário naquele treinamento.
Por exemplo, digamos que você queira criar 3 níveis de um mesmo badge: ouro, prata e bronze, sendo:
* **Ouro: 100-80**
* **Prata: 79-50**
* **Bronze: 49-20**
Ao cadastrar esses valores nos campos "Percentual Mínimo" e "Percentual Máximo", em cada novo badge, relacionado ao mesmo treinamento, a plataforma distribuirá o badge correspondente aos pontos atingidos. No exemplo acima, se o usuário conquistar 19 pontos ou menos, não receberá nada.
A mesma lógica anteriormente descrita vale para cadastro de badges para os módulos, quando a opção escolhida no campo "Tipo" for "Módulo Completado" ou "Módulo Completado com Pontuação Min/Max".
## [Tipo "Certificado - Treinamento Completado"](#tipo-certificado-treinamento-completado):
* Tipo: Selecione o tipo **Certificado - Treinamento completado**
* Campo **"Treinamento Completado"**: permite escolher o treinamento específico do badge.
* Campo **"Título"**: nome do badge.
* Campo **"Subtítulo"**: texto curto, exibido logo abaixo do "Título" na visualização do badge.
* Campo **"Texto"**: descrição do badge; texto completo que aparecerá na área de "Conquistas" do usuário.
Caso não seja preenchido, o texto é gerado automaticamente. Ex: Certificado "xxxxx" disponível.
* Campo **"Imagem"**: imagem do badge, no tamanho de 500x500px.
* Campo **"Cor Hexa"**: cor do badge; aparecerá na área de "Conquistas" do usuário.
* O certificado poderá ser gerado a partir de um template (fundo do certificado sem texto) que você defina previamente. Tal template deve ser exportado como uma imagem .SVG, com resolução 1000x1000 pixels adicionado no campo "Certificado - Imagem".
**Exemplo:**
* No campo **"Certificado - Texto"**, o certificado poderá receber variáveis do sistema, para que ele seja personalizado ao usuário.
São elas:
* @name: Nome do usuário
* @track: Nome da Trilha
* @date: Data que foi gerado o certificado
* @duration: Duração do treinamento (Treinamento: Duração - Texto)
O campo "Certificado - Texto" recebe diferentes instruções para definir o que será inserido no certificado. Explicando o exemplo disponível no LMS:
\
Define que a imagem tem 1000x1000
\
\
Define a fonte a ser utilizada e o tamanho da mesma. Outras opções, conforme indicação no LMS.
\Eu, \@name\, concluí a trilha de microlearning\
"X" é a altura do texto; "Y" é a linha que iniciará a inserção. Nesse exemplo, a variável "@name" será inserida em bold.
\\”@track”\ em \@date\\
\com duração de \@duration\ na Plataforma Grano.\
Outras 2 linhas, utilizando novas variáveis do sistema.
O resultado final, desse template, parametrizado, é:
O uso de variáveis é opcional pelo administrador do sistema. Caso queira apenas um texto genérico, ou uma variável específica (exemplo: @name) basta copiar/colar o trecho de código do exemplo (no campo "Certificado - Texto") e editar (ou excluir) as linhas que iniciam pela tag \.
* Campo **"Share - Título"**: é o título do badge que aparecerá na rede social, quando ele for compartilhado pelo usuário.
* Campo **"Share - Descrição"**: é a descrição do badge que aparecerá na rede social, quando ele for compartilhado pelo usuário.
* Campo **"Share - Imagem"**: é a imagem do badge (1200x630px) que aparecerá na rede social, quando ele for compartilhado pelo usuário.
**Exemplo Share:**
Exemplo de cadastro de badge e compartilhamento em redes sociais
* Campo **"Chave Única"**: é a identificação do badge no LMS; algo único e específico desse badge, para que você cadastre para facilitar buscas futuras.
Salve o badge para salvar todas as informações.
Após salvar, é possível ter um preview (exemplo) de como a frase será aplicada no template, acessando o menu **"Lista - Badge"**, localizando o respectivo badge criado e, na coluna **"ações"**, clicar no **ícone (olho)** de visualizar item.
## Exemplo dos badges na aba de Conquistas:
