Désolé pour le délai de réponse à votre question. Je teste actuellement le plugin en le configurant selon ce guide : https://meta.discourse.org/t/discourse-github/99895.
Une différence entre le guide et le README du plugin est que le guide indique qu’un jeton d’accès GitHub doit être généré pour que les badges soient attribués. Ce jeton d’accès doit être ajouté au paramètre « github linkback access token » de votre site avant que les badges ne soient attribués.
Pour créer un jeton d’accès, rendez-vous sur Sign in to GitHub · GitHub. Si vous utilisez uniquement ce jeton pour attribuer des badges, vous n’avez pas besoin de sélectionner de portées. Faites simplement défiler la page jusqu’en bas et cliquez sur le bouton « Generate Token ».
L’autre paramètre à configurer pour les badges est le paramètre du site « github badges repo ». Saisissez l’URL complète de chacun de vos dépôts GitHub pour lesquels vous souhaitez que des badges soient attribués. L’URL affichée dans la barre d’adresse de votre navigateur fonctionnera à cet effet.
Le plugin crée 6 badges :
- Contributor
- Great contributor
- Amazing contributor
- Committer
- Frequent committer
- Amazing committer
Les trois premiers badges de la liste sont activés automatiquement lors de leur création par le plugin. Les trois derniers badges de la liste doivent être activés manuellement depuis votre page Admin / Badges.
Le nombre de commits requis pour les badges « Frequent committer » et « Amazing committer » peut être défini à l’aide des paramètres du site « github silver badge min commits » et « github gold badge min commits ».
Une dernière chose à noter concernant les badges est qu’ils sont attribués via un tâche en arrière-plan exécutée toutes les 4 heures. Cela signifie que vous pouvez vous attendre à un délai d’au maximum 4 heures entre le moment où l’utilisateur a été actif sur GitHub et le moment où le badge lui est attribué.
Les utilisateurs sont identifiés en fonction de l’adresse e-mail du commit GitHub. Dans la plupart des cas, il s’agira de l’adresse e-mail de l’utilisateur. Pour les utilisateurs ayant configuré Git pour utiliser l’adresse e-mail sans réponse de GitHub (<username>@users.noreply.github.com), le plugin tente de trouver l’utilisateur en se basant sur la partie nom d’utilisateur de cette adresse e-mail. Il le fait en recherchant une correspondance de nom d’utilisateur dans la table Discourse GithubUserInfo. Les utilisateurs ne seront trouvés de cette manière que s’ils se sont précédemment connectés à Discourse via GitHub.
Je travaille également sur la fonctionnalité de retour vers le lien du plugin. Je mettrai à jour le README du plugin et le guide du plugin sur Meta très prochainement.
Si vous configurez le plugin sur un site que nous hébergeons, vous pouvez bénéficier d’un support privé en envoyant un e-mail à l’adresse de support indiquée sur le tableau de bord d’administration de votre site.