Discourse

How it works#

The Discourse connector indexes documents from your Discourse Topics.

Setting up#

Authorization#

Log in to Discourse#

Log into your Discourse account

This Discourse user must have admin privileges

Open API keys#

Click the Admin menu from the home page. Open the Advanced sub-menu and select API keys.

Create API key#

Click New API Key, name it "Nexus". Select "All Users" for User Level and "Read-only" for Scope.

Save and copy key#

Click Save. Copy the key and put it into Nexus.

Set API key username#

For the API Key Username, enter the username of the Discourse account which has access to the information you'd like to index.

Indexing#

Name the connector#

Input a name for a connector (if you plan on creating multiple Discourse connectors, this will be used by you to tell between them)

Provide base URL#

Provide your Discourse's base url.

Enter Topics to index#

Enter the Topics you wish to index. If left blank, all topics available will be indexed.

Start indexing#

Click connector to begin indexing the indicated topics.

Before using this source with students#

Start with approved course material. Check which documents the connector can retrieve and how it maps source permissions. Test with a student account and a teacher account before widening access. A successful sync does not prove that the intended class boundary is correct.

Use source troubleshooting when a document is missing or visible to the wrong audience.