Badge per il tuo sito, README e forum
Un'immagine SVG piccola e statica con i giocatori connessi ora su Steam e la posizione del gioco nella classifica Statcade, per esempio «12.345 giocatori ora · n. 7 su Statcade». Si incolla come una normale immagine con link: niente script, niente iframe, niente cookie.
Scrivi almeno due lettere: scegli il gioco e i codici qui sotto si aggiornano. Senza JavaScript, l'appid è il numero nell'indirizzo della scheda del gioco su Statcade (statcade.com/giochi/730) o su Steam (store.steampowered.com/app/730/); l'elenco completo è nel catalogo e in /api/games.json.
Anteprima
Gioco mostrato: Counter-Strike 2 (appid 730).
Indirizzi dei badge
| Indirizzo | Cosa mostra |
|---|---|
/badges/{appid}.svg | Giocatori connessi ora e posizione nella classifica dei giocatori: «12.345 giocatori ora · n. 7 su Statcade». Per un titolo non Steam con le copie vendute, la posizione per copie vendute. |
/badges/{appid}-giocatori.svg | Solo i giocatori connessi ora. |
/badges/{appid}-classifica.svg | Solo la posizione nella classifica dei giocatori connessi su Steam. |
/badges/{appid}-vendite.svg | Posizione nella classifica delle copie vendute. Esiste solo per i giochi con il dato (fonte Wikipedia, come la pagina Vendite). |
Indirizzo completo: https://statcade.com/badges/730.svg. A sinistra c'è il nome del gioco (accorciato con «…» oltre i 32 caratteri), a destra il dato. Se il gioco non ha il numero dei giocatori il badge scrive «n.d.»: nessun numero viene stimato. Se un gioco esce dal catalogo il suo badge non sparisce, diventa un badge neutro «Statcade · statistiche», così sul tuo sito non compare un'immagine rotta. Il link porta sempre alla scheda del gioco, https://statcade.com/giochi/{appid}.
Codice da incollare
HTML (siti, blog)
<a href="https://statcade.com/giochi/730"><img src="https://statcade.com/badges/730.svg" alt="Counter-Strike 2: giocatori connessi ora e classifica su Statcade" height="20"></a>Markdown (README di GitHub e GitLab, siti statici)
[](https://statcade.com/giochi/730)BBCode (forum)
[url=https://statcade.com/giochi/730][img]https://statcade.com/badges/730.svg[/img][/url]Alcuni forum accettano in [img] solo PNG, JPG o GIF e non mostrano gli SVG: in quel caso usa un link di testo, [url=https://statcade.com/giochi/730]Counter-Strike 2 su Statcade[/url].
Per un'altra variante cambia solo la fine del nome del file, per esempio 730-giocatori.svg. Lascia un testo alternativo (alt) che dica di che gioco si tratta: è quello che legge chi usa uno screen reader. Anche l'SVG ha già un titolo accessibile con il numero completo.
Twitch e Discord
- Twitch: i pannelli sotto il canale accettano solo immagini caricate da te (PNG, JPG o GIF), non un indirizzo esterno né un SVG, quindi un badge lì non si aggiornerebbe. Nel pannello metti come link dell'immagine la scheda del gioco,
https://statcade.com/giochi/730, e nel testo una frase come «Giocatori connessi ora su Statcade». Nei comandi della chat basta lo stesso link. - Discord: messaggi e embed non mostrano gli SVG. Incolla il link alla scheda del gioco: per i giochi più seguiti l'anteprima del link mostra una card con la posizione in classifica e i giocatori del giorno. Un bot può leggere i numeri dall'API (
/api/games/{appid}.json) e scriverli nel messaggio.
Ogni quanto si aggiorna
I badge si rigenerano insieme ai dati del sito, di norma una volta al giorno intorno alle 05:00 UTC, a volte con un passaggio in più fuori orario. Leggono gli stessi numeri dell'API pubblica (/api/games.json e /api/rankings.json): «giocatori ora» vuol dire giocatori connessi su Steam all'ultima rilevazione di Statcade, non in tempo reale. Un file viene riscritto solo se il suo contenuto è cambiato.
Cache
Il sito è ospitato su Cloudflare Pages: i badge arrivano con un ETag e il browser li riconvalida, quindi dopo un aggiornamento la versione nuova arriva subito. Alcuni servizi però tengono una copia propria delle immagini: GitHub, per esempio, mostra i badge dei README attraverso il suo proxy di immagini, che può mostrare la versione precedente per un po'. Non aggiungere parametri casuali all'indirizzo per forzare l'aggiornamento: i numeri cambiano comunque al massimo qualche volta al giorno.
Uso e attribuzione
I badge sono gratuiti e non serve chiedere: il link alla scheda del gioco su Statcade vale come attribuzione. I giocatori connessi vengono dalla Steam Web API, le copie vendute da Wikipedia; condizioni e limiti sono nella licenza dell'API. Preferisci un riquadro con anteprima e tema chiaro o scuro? C'è il generatore di widget.