WordPress plugin that lets you use Discourse as the community engine for a WordPress blog
Branch: master
Clone or download
Latest commit e144ff5 Feb 12, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
admin Give each array value its own line Feb 11, 2019
assets Remove fontello icons Jun 15, 2018
bin Merging changes from Git for 0.9.6 release Aug 19, 2016
css Don't load fontello css Jun 15, 2018
js Add around function arg Dec 10, 2017
lib Don't return Discourse comments from Rest Route for password protecte… Feb 13, 2019
templates Add post_id parameter to publish_format_html Jan 10, 2019
tests Remove old test files Apr 3, 2018
.gitignore Fix typo - integration, not integrations Apr 18, 2017
.jscsrc Merging changes from Got for 0.7 release Jul 5, 2016
.jshintignore Changes for WordPress coding standards Dec 8, 2018
.travis.yml Changes for WordPress coding standards Dec 8, 2018
CHANGELOG.md Merging changes from Git for 1.0.0 release Sep 27, 2016
LICENSE license file an fixes Jul 5, 2016
README.md Remove OpenCollective links from readme Nov 22, 2017
codesniffer.ruleset.xml Changes for WordPress coding standards Dec 8, 2018
composer.json Fix license identifier Feb 17, 2018
composer.lock use a less strict version constraint for composer/installers Dec 11, 2017
phpunit-unit-tests.xml Add configuration file for WP_Mock unit tests Apr 11, 2017
phpunit.xml.dist Exclude DisallowSpaceIndent rule to get around issue with travis-ci Apr 11, 2017
readme.txt Bump version to 1.8.7 Feb 13, 2019
uninstall.php Delete wpdc_cached_html_keys option on uninstall Jun 30, 2018
wp-discourse.php Bump version to 1.8.7 Feb 13, 2019


WP Discourse

OpenCollective OpenCollective

Note: the wp-discourse plugin requires >= PHP-5.4.0.

The WP Discourse plugin acts as an interface between your WordPress site and your Discourse community.

Use Discourse for comments:

  • Automatically creates a forum topic for discussion when a new blog post is published.
  • Associates WP author accounts with their respective Discourse accounts. Does not require SSO.
  • Replies from the forum discussion can be embedded in the WP blog post. Select which replies to display based on post score and commenter "trust level" -- see docs.

See it live

Single Sign On

The plugin also comes with optional SSO functionality which lets you use your WordPress site as the Single Sign On provider for your Discourse forum.

This will override Discourse's native (and powerful) login flow and is only recommended for use cases that strictly require such a setup, e.g. a site that is already using WordPress for large scale user management.



From your WordPress dashboard

  1. Visit 'Plugins > Add New'
  2. Search for 'WP Discourse'
  3. Activate WP Discourse from your Plugins page

From wordpress.org

  1. Download WP Discourse
  2. Upload the 'wp-discourse' directory to your '/wp-content/plugins/' directory
  3. Activate WP Discourse from your Plugins page

With Composer

If you're using Composer to manage WordPress, add WP-Discourse to your project's dependencies. Run:

composer require discourse/wp-discourse ~1.3.2

Or manually add it to your composer.json:

  "require": {
    "php": ">=5.4.0",
    "discourse/wp-discourse": "~1.3.2"

For more detailed instructions please see the setup page of the wp-discourse wiki

Frequently Asked Questions

Does this plugin install Discourse for me?

No this plugin acts as an interface between Discourse and WordPress. For it to work you will need to first set up Discourse forum. You can install Discourse for yourself following either of these guides:

Can I import old WordPress comments as Discourse comments (i.e. "replies")?


Do WordPress and Discourse have to be installed on the same server?

The plugin uses the Discourse API, so your forum and blog can be hosted separately and the integration will still work. In fact, we strongly recommend hosting the two applications separately, since their hosting requirements are very different.

Is it possible to customize the comment templates?

Yes, the html templates used for publishing posts on Discourse and for displaying comments on WordPress can be customized in your theme. This is done by hooking into the filters that are applied to each template.

For more details on template customization, take a look at this section of our wiki: Template Customization


  1. Fork this repo
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new pull request