This plugin allows you to submit user discussion and comments as GitHub issues.
What is Github?
GitHub has become one of the most popular code repository services in the world. Developers use it to store source code and it allows developers to contribute code to a common source code.
Integration between Vanilla Forums and Github
Vanilla Forums allows you to create an Issue, in a specific GitHub repository, directly from a comment or discussion in your community.
How does it work?
The first step is to have the Github Add-on enabled in your Vanilla Forums account, and to follow the steps in our integration guide. Once enabled, here is how it works:
To create an Issue, authorized users select ‘GitHub - Create Issue’ from the gear icon drop down in any comment or discussion:
Name and email will be pre-populated. Other required fields will need to be filled out
The Issue will be created in GitHub and an information panel will be displayed (to staff only) under the post.
And the issues will also be displayed on Github:
Please note: The integration works best when using the markdown editor. Also, our GitHub integration uses oAuth, so that means your Github passwords are not stored in Vanilla at any time.
If you already have a Github account, you need to enable API Access for this plugin to work.
- Create a new application in GitHub, and set the callback URL by appending /profile/githubconnect to the end of your forum’s URL. (If your forum is at example.com/forum, your callback URL would be http://example.com/forum/profile/githubconnect).
- Once your application has been set up, you must copy the ClientID and Secret into your Github plugin settings page from your Vanilla dashboard.
- Enter the repositories you want to be allowed into your Github plugin settings page from your Vanilla dashboard.