Entrar
Documentação

Começo

Meta e doadores na vitrine

Mostre a meta do mês do servidor e o ranking de quem mais apoiou na página inicial da loja de jogo.

Nas lojas de servidor de jogo, a página inicial pode ter a seção Meta e doadores: a barra da meta do mês, com o prêmio, e o ranking dos maiores apoiadores. São os mesmos números que o plugin do Minecraft mostra com /meta e /doadores, agora para todos os jogos.

Configurar a meta e o ranking#

Em Servidor > Configuração:

  • Meta do mês: ligue Mostrar a meta, escolha se ela conta o valor vendido ou o número de compras, o alvo, o título e o prêmio quando bater.
  • Ranking de doadores: Mostrar o ranking liga e desliga o ranking no jogo e na vitrine ao mesmo tempo.

Ligar a seção na vitrine#

  1. Abra a página inicial no editor#

    Em Customizar, abra a aba Início.

  2. Ligue Meta e doadores#

    Ligue a chave da seção Meta e doadores e abra ela para escolher o título, se aparece a barra da meta, o ranking ou os dois, e quantas posições o ranking mostra (3, 5 ou 10).

  3. Escolha a posição#

    Arraste a seção para cima ou para baixo, ou use as setas que aparecem ao passar o mouse na prévia. Salve para publicar.

Sem meta ligada e sem ranking, a seção não aparece. Com o ranking ligado e nenhuma compra no mês, ele mostra um aviso convidando a primeira compra.

Quem aparece no ranking#

O ranking da vitrine é público fora do servidor, por isso mostra menos que o do jogo:

  • O nick ou o gamertag do jogador, que todo mundo já vê dentro do servidor.
  • Sem nick, o primeiro nome com a inicial do sobrenome, como "Lucas S.".
  • Sem nome, Jogador anônimo.

O ID da cidade, a Steam, a license, o Discord, o e-mail e quanto cada um gastou nunca aparecem na vitrine. A posição é a mesma do /doadores.

Como a conta é feita#

  • Conta só pedido pago de verdade no mês, no horário de Brasília. Reembolso sai da conta, e pedido do ambiente de teste não entra.
  • A meta passa de 100% sem quebrar a barra: ela fica cheia e aparece Meta batida.
  • A vitrine atualiza em até um minuto depois da compra.

Personalizar com CSS#

A seção tem data-section="goal", e cada parte tem um ponto fixo:

CSS
[data-store="server-goal"] { /* cartão da meta */ }
[data-store="top-donors"] { /* cartão do ranking */ }

Em tema publicado#

Um tema publicado monta a própria página inicial. Ligue a seção em Customizar e leia os dados no JavaScript do tema:

JavaScript
const res = await fetch('/api/sf/game/highlights');
const { goal, top } = await res.json();
// goal: { title, kind, target, current, percent, reward, ends_at } ou null
// top: [{ position, name }] ou null (name nulo é jogador anônimo)

Com a seção desligada, a resposta vem com goal e top nulos.