🐙GitHub

How to configure the GitHub connector for Meeds as an administrator

If your organization uses GitHub to manage code or documentation and wants to foster open contributions and collaboration, the GitHub connector for Meeds is for you!

You can activate it to allow contributors to earn points by interacting with your repositories.

Events that the GitHub connector can capture include:

• Issues

• Pull Requests

• Code

To start configuring the GitHub connector for Meeds go to Administration > Recognition > Connectors > GitHub

GitHub connector card

List of events of the GitHub connector

Next, Click Configure

GitHub configuration

👉 Allow users to connect their GitHub account

Click on Allow connection and follow the instructions in the form:

Connect GitHub profile config 1/3

Step 1: Go to your Developer Settings in your GitHub account

Click on OAuthApps > Register new application

OAuth Apps tab in GitHub's Developer Settings

Fill in the Application name and description,

OAuth app form in GitHub

Now head back to Meeds to retrieve the URLs

Step 2: Click Next and copy the Homepage URL and Authorization callback URL from Meeds

oAuth apps URLs in Meeds

Now paste the URLs into the oAuth application form on GitHub and create the app.

Client ID in GitHub

Click on Generate a new client secret and authenticate

Client secret in GitHub

Head back to Meeds

Step 2: Click Next and copy-paste the Client ID and Client secret from GitHub to Meeds

Connect GitHub profile config 3/3

Click Save

Connect GitHub profile configured in Meeds

You can click on the toggle button to temporarily disable profile connections, or you can ✏️ Edit or 🗑️ Delete the configuration to start over.

At this stage, your users can connect their GitHub profile.

👉 Add a GitHub organization to watch

Now, you must add one or more organizations that Meeds will watch to track events your contributors perform.

Connect GitHub organizations to watch

Click on Add Organization

Personal access token field in Meeds

On GitHub, head back to your Developer Settings > Personal access tokens (classic)

Personal acess tokens in GitHub

Click Generate new token > Personal access token (classic)

Personal access token form in GitHub

Fill out the form by selecting scopes :

• repo

• admin:org_hook

Then click the Generate token button

Copy the personal access token in GitHub

Copy the token and head back to Meeds to paste it, then click the ✅ checkmark to validate.

Paste the personal access token in Meeds

Click Next and enter your GitHub organization name.

Enter GitHub organization name

Click Save, and the organization should be listed:

You may add ➕ more organizations to watch, ✏️ Edit, or 🗑️ Delete to start over

Click on the organization's name

List of events enabled for an organizaton

In the Events tab, you may restrict what events to watch for that particular organization.

Click on Repositories

List of repositories to watch

From there, you can restrict which repositories to watch on that particular organization.

🎉 Congratulations! Your Meeds Hub is now ready to incentivize contributions on GitHub! Your program owner can now start designing incentives to Foster open collaboration on GitHub.