Ci scusiamo per il ritardo nella risposta alla tua domanda. Sto testando il plugin ora configurandolo seguendo questa guida: https://meta.discourse.org/t/discourse-github/99895.
Una differenza tra la guida e il README del plugin è che la guida afferma che è necessario generare un token di accesso GitHub per l’assegnazione dei badge. Tale token di accesso deve essere aggiunto all’impostazione github linkback access token del tuo sito prima che vengano assegnati i badge.
Per creare un token di accesso, vai su Sign in to GitHub · GitHub. Se utilizzi il token solo per l’assegnazione dei badge, non dovresti aver bisogno di selezionare alcuno scope. Scorri semplicemente fino in fondo alla pagina e clicca sul pulsante Generate Token.
L’altra impostazione necessaria per i badge è github badges repo. Inserisci l’URL completo di ciascuno dei tuoi repository GitHub per cui desideri che vengano assegnati i badge. L’URL visualizzato nella barra degli indirizzi del tuo browser funzionerà per questo scopo.
Il plugin crea 6 badge:
- Contributor
- Great contributor
- Amazing contributor
- Committer
- Frequent committer
- Amazing committer
I primi tre badge dell’elenco vengono abilitati automaticamente quando vengono creati dal plugin. Gli ultimi tre badge dell’elenco devono essere abilitati manualmente dalla pagina Amministrazione / Badge.
Il numero di commit richiesti per i badge Frequent committer e Amazing committer può essere impostato tramite le impostazioni del sito github silver badge min commits e github gold badge min commits.
Un’ultima cosa da notare sui badge è che vengono assegnati tramite un job in background eseguito ogni 4 ore. Ciò significa che puoi aspettarti un ritardo fino a 4 ore tra il momento in cui l’utente è stato attivo su GitHub e il momento in cui gli viene assegnato il badge.
Gli utenti vengono individuati in base all’indirizzo email del commit di GitHub. Nella maggior parte dei casi, si tratta dell’indirizzo email dell’utente. Per gli utenti che hanno configurato Git per utilizzare l’indirizzo email no-reply di GitHub (<username>@users.noreply.github.com), il plugin tenta di trovare l’utente basandosi sulla parte del nome utente di quell’indirizzo email. Lo fa cercando una corrispondenza del nome utente nella tabella Discourse GithubUserInfo. Gli utenti verranno trovati in questo modo solo se hanno precedentemente effettuato l’accesso a Discourse tramite GitHub.
Sto anche esaminando la funzionalità di linkback del plugin. Aggiornerò presto il README del plugin e la guida del plugin su Meta.
Se stai configurando il plugin su un sito che ospitiamo, puoi ottenere supporto privato inviando un’email all’indirizzo di supporto indicato nella dashboard di amministrazione del tuo sito.