Coggle Issue Importer
What is it?
Coggle issue importer is a node.js demo application for the Coggle API that imports all the issues from a selected GitHub repository into a Coggle, grouped by their tags.
The user is authenticated for both the Coggle API and the Github API using OAuth. The passport-coggle-oauth2 module used to authorize users with Coggle, and retrieve an access token that can be sent along with requests to prove that your application is allowed to access a user's Coggles.
Get the Code!
First install node.js, then:
git clone email@example.com:Coggle/coggle-issue-importer.gitcd coggle-issue-importernpm install
Running Coggle Issue Importer
To use the Coggle API you need a Client ID, and a Client Secret – which Coggle uses to identify requests to the applications that made them.
A new Client ID and Client Secret can be created at
http://coggle.it/developer. The redirect URL
should be the domain (and optionally port) where you will host the application
localhost:5000 for testing) followed by
/auth/coggle/callback, which is the Coggle oauth authentication callback
route of the app.
Since the app also uses the GitHub API, you also need a github API client ID
and client secret (get one
here). The callback URL for
github authorization is (as you'd expect) the domain followed by
Both these pairs of IDs and secrets then need to be provided as environment variables when you run the app. If they are missing the app will refuse to start – but if they are incorrect you will only find out when you try to use it!
COGGLE_CLIENT_ID=aaaaaaaaaaaaaaaaaaaaaaaa \COGGLE_CLIENT_SECRET=bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb \GITHUB_CLIENT_ID=cccccccccccccccccccc \GITHUB_CLIENT_SECRET=dddddddddddddddddddddddddddddddddddddddd \node app.js