After you’ve installed the WP Discourse Plugin you need to connect it to your Discourse. When you’re ready to go, watch this short video, or follow the instructions below.
Next Step
Once the plugin is connected, head over to the topic describing the feature you want to set up:
- Publish posts to Discourse
- Use Discourse for Wordpress Comments
- Log in to Discourse with Wordpress (DiscourseConnect)
Instructions
Steps
When you’re looking at the Connection
tab of the WP Discourse plugin settings, there will always be a notice at the top of the page which will tell you whether it is connected to your Discourse. To establish a connection, enter:
-
Enter the URL of your forum in the
Discourse URL
settings field -
Review the
Publishing Username
setting. Unless you have a specific reason to change this, keep it as “system”. If you change this it has to be a username of an admin user on your Discourse. -
Create a Discourse API key for Wordpress:
-
Go to your Discourse Admin Panel (in your discourse forum), and click on “API”.
-
Create a new key with the following:
- Description: enter a label that makes it clear what this key is for
- User Level: select “All Users”
- Scope: select “Global”
-
Copy the key that appears on the screen and click “Continue”.
-
-
Paste the API key into the
API Key
setting in WP Discourse.
When you’ve filled out these settings make sure you click the ‘Save Options’ button. If everything is correctly configured, you should see a notice that “You are connected to Discourse” at the top of the page.
Multisite
The WP Discourse plugin has a Multisite Configuration option for the case where one Discourse forum is connected to a network of multiple WordPress. This option is available on the Connection settings tab of the main site of a network.
Selecting it allows some of the plugin’s settings to be used over the entire network (all the connection options, the Webhook options, the DiscourseConnect Secret Key, and Enable DiscourseConnect setting) Enabling this setting will create an extra database table that’s used for associating Discourse topic_ids with WordPress blog_ids when posts are published from WordPress to Discourse.
Features not supported in Multisite
Using WordPress as a DiscourseConnect Client is not supported on Wordpress Multisite.