 |
Résumé | Discourse GitHub permet au personnel d’attribuer des badges aux utilisateurs en fonction de leurs contributions sur GitHub. Permet également aux utilisateurs de créer des liens vers GitHub et des liens permanents |
 |
Guide d’installation | Ce plugin est inclus dans le noyau de Discourse. Il n’est pas nécessaire de l’installer séparément. |
Fonctionnalités
Badges GitHub
Attribuez des badges à vos utilisateurs en fonction de leurs contributions sur GitHub.
Comment utiliser :
- Activez
github badges enableddans Paramètres → Plugins. - Générez un jeton d’accès GitHub et collez-le dans le paramètre
github linkback access token. Voir ci-dessous pour les instructions. - Ajoutez une ou plusieurs URL des dépôts GitHub à scanner pour les contributions dans le paramètre du site
github badges repos.
Fonctionnement du comptage des badges :
Les badges comptent les commits sur tous les dépôts, et lorsque l’utilisateur contribue à plusieurs dépôts, tous ses commits sont additionnés pour former un total.
Badges de contributeur :
- Bronze : 1 commit
- Argent : 25 commits
- Or : 1000 commits
Progression des badges : À mesure que les utilisateurs accumulent plus de contributions dans l’un quelconque des dépôts suivis, ils progressent automatiquement à travers les niveaux de badges. Par exemple, si un utilisateur contribue au dépôt A puis au dépôt B, toutes les contributions comptent pour son total, lui permettant de passer du bronze à l’argent puis à l’or.
Lien retour GitHub
Créez un lien depuis une demande de tirage (pull request) ou un commit GitHub vers un message Discourse où il est mentionné.
Comment utiliser :
- Activez
github linkback enableddans Paramètres → Plugins. - Générez un jeton d’accès GitHub et collez-le dans le paramètre
github linkback access token. Voir ci-dessous pour les instructions. - Enfin, ajoutez les projets que vous souhaitez publier dans le paramètre du site
github linkback projectsdans les formats suivants :username/repositorypour des dépôts spécifiquesusername/*pour tous les dépôts d’un utilisateur donné
Lien permanent GitHub
Remplacez les liens non permanents de GitHub par des liens permanents.
Comment utiliser :
- Activez
github permalinks enableddans Paramètres → Plugins.
Configuration
Jeton d’accès GitHub
Pour que la fonctionnalité de lien retour fonctionne et que les badges soient attribués à vos utilisateurs, vous devez fournir un jeton d’accès GitHub. Vous pouvez générer votre jeton ici : Sign in to GitHub · GitHub.
La fonctionnalité de lien retour nécessite la portée public_repo, et l’attribution de badges ne nécessite aucune portée (laissez tout désactivé si vous voulez uniquement des badges). Étant donné que la portée public_repo accorde un accès en écriture aux dépôts, nous vous recommandons de créer un compte GitHub jetable qui n’a accès à aucun dépôt et de l’utiliser uniquement pour générer un jeton.