# Ranking

> A gamificação da comunidade. Os pontos que cada ação vale, os nove níveis, os períodos do ranking, o espaço de Ranking, como ligar o ranking geral e onde mudar os pontos.

O **Ranking** transforma participação em pontos. Cada ação vale uma quantidade de pontos, os pontos somam níveis, e o espaço de Ranking mostra quem mais participa. A gamificação já vem ligada quando a comunidade é criada.

## Para que serve

| Comunidade | Como o ranking ajuda |
|---|---|
| Escola online | Premiar os alunos que mais completam aulas e ajudam nos comentários |
| Comunidade de clientes | Reconhecer quem mais responde dúvidas |
| RH de empresa | Engajar a participação no mural da cultura |

## Como funciona

### O que dá pontos

Os valores padrão, que o proprietário e o administrador mudam em **Membros › Gamificação**:

| Ação | Pontos |
|---|---:|
| Criar publicação | 10 |
| Curtir publicação | 1 |
| Comentar publicação | 5 |
| Responder comentário | 3 |
| Participar de evento | 20 |
| Criar evento | 20 |
| Criar curso | 30 |
| Inscrever-se em curso | 10 |
| Completar aula | 25 |
| Receber curtida | 2 |
| Login diário | 1 |

### Os níveis

| Nível | Pontos |
|---|---|
| 1 | 0 a 99 |
| 2 | 100 a 299 |
| 3 | 300 a 599 |
| 4 | 600 a 999 |
| 5 | 1.000 a 1.999 |
| 6 | 2.000 a 3.499 |
| 7 | 3.500 a 5.999 |
| 8 | 6.000 a 9.999 |
| 9 | 10.000 ou mais |

### Os períodos

O ranking pode ser visto em **Esta Semana** (7 dias), **Este Mês** (30 dias) e **Histórico**. Além do **Ranking Geral** da comunidade, um espaço de Ranking pode mostrar o **Ranking da Secção**: só a participação naquela secção.

### O espaço de Ranking

O espaço mostra a **Classificação**, os **Principais Contribuidores**, **O Meu Ranking** (a posição de quem está a ver, com o progresso para o próximo nível) e a explicação de como os pontos e os níveis funcionam.

### Ligar e desligar

Em **Definições › Geral**, a chave **Ranking Global** (*"Habilitar o ranking global para todos os membros"*).

### Mudar os pontos

Em **Membros › Gamificação**, o proprietário e o administrador ligam ou desligam os pontos e mudam quanto vale cada ação. O valor novo vale a partir da próxima ação. Ver [Gamificação](/membros/gamificacao).

## Passo a passo: criar o espaço de Ranking

*Papel: proprietário ou administrador.*

1. **Adicionar Espaço › Ranking**, **Seguinte**.
2. Título (ex.: *Ranking*), ícone e visibilidade (normalmente **Membros**).
3. **Criar Espaço**.

## Exemplos com números

**Uma aluna numa semana.** Completa 4 aulas (100), comenta 6 vezes (30), responde 5 comentários (15), entra 7 dias (7) e recebe 10 curtidas (20): **172 pontos**, e passa do nível 1 para o nível 2.

**Um evento.** Quem cria o evento ganha 20; cada participante, 20.

## Perguntas frequentes

**Os pontos têm valor em dinheiro?**
Não. São reconhecimento. Se quiser premiar, combine o prêmio com a comunidade (um mês grátis, um brinde).

**Dá para zerar o ranking?**
Os períodos **Esta Semana** e **Este Mês** já recomeçam sozinhos.

**Quem é da equipa aparece no ranking?**
Aparece, como qualquer pessoa que participa.

## Na API

`GET /api/gamification/leaderboard`, `GET /api/gamification/score`, `GET /api/gamification/actions`, `GET`/`PUT /api/gamification/config`. Ver [Gamification](/api/referencia/gamification).

## Relacionados

- [Gamificação](/membros/gamificacao)
- [Feed](/espacos/feed)
- [Cursos](/espacos/cursos)
- [Definições gerais](/configuracoes/configuracoes-gerais)