PHPackages                             discourse/wp-discourse - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication & Authorization](/categories/authentication)
4. /
5. discourse/wp-discourse

ActiveWordpress-plugin[Authentication & Authorization](/categories/authentication)

discourse/wp-discourse
======================

WordPress plugin that allows you to use Discourse as a community engine for your WordPress blog.

2.6.1(3mo ago)5419.5k113[13 issues](https://github.com/discourse/wp-discourse/issues)[20 PRs](https://github.com/discourse/wp-discourse/pulls)GPL-3.0-onlyPHPPHP >=5.4CI passing

Since Jan 31Pushed 2mo ago46 watchersCompare

[ Source](https://github.com/discourse/wp-discourse)[ Packagist](https://packagist.org/packages/discourse/wp-discourse)[ Docs](https://github.com/discourse/wp-discourse)[ RSS](/packages/discourse-wp-discourse/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (11)Versions (177)Used By (0)

WP Discourse
============

[](#wp-discourse)

[![OpenCollective](https://camo.githubusercontent.com/d6f05728961e9939f4193c7cad327805bd9a97a1ee7bf849dfa9abef9ca354e8/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f77702d646973636f757273652f6261636b6572732f62616467652e737667)](#backers)[![OpenCollective](https://camo.githubusercontent.com/0d276955ef908c123e9ece65d1081b7488fa449b11c3130419c2691a4431a435/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f77702d646973636f757273652f73706f6e736f72732f62616467652e737667)](#sponsors)

**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](http://www.discourse.org/) community.

The plugin is not a substitute for Disqus-like commenting systems.

### Use Discourse for Comments:

[](#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 DiscourseConnect.
- 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

[](#see-it-live)

- [blog.discourse.org](http://blog.discourse.org/)
- [boingboing.net](http://boingboing.net/)

### DiscourseConnect

[](#discourseconnect)

The plugin also comes with optional DiscourseConnect functionality which lets you use your WordPress site as the DiscourseConnect 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.

### Contact

[](#contact)

Please post bug reports, support requests and all other inquiries in our [dedicated support forum](https://meta.discourse.org/c/support/wordpress)

### Installation

[](#installation)

#### From your WordPress dashboard

[](#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

[](#from-wordpressorg)

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

[](#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 [WP Discourse plugin installation and setup](https://meta.discourse.org/t/wp-discourse-plugin-installation-and-setup/50752).

### Frequently Asked Questions

[](#frequently-asked-questions)

#### Does this plugin install Discourse for me?

[](#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:

- [Install Discourse in Under 30 Minutes](https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md)
- [How to use the Discourse One-Click Application on DigitalOcean](https://www.digitalocean.com/community/tutorials/how-to-use-the-discourse-one-click-application-on-digitalocean)

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

[](#can-i-import-old-wordpress-comments-as-discourse-comments-ie-replies)

No.

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

[](#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?

[](#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, see: [WP Discourse template customization](https://meta.discourse.org/t/wp-discourse-template-customization/50754)

#### Contributing

[](#contributing)

Before you start contributing or developing this plugin please read the documentation in `docs/`, starting with [contributing.md](https://github.com/discourse/wp-discourse/blob/main/docs/contributing.md). If you have any questions about those process, please post in [\#dev](https://meta.discourse.org/c/dev/7) for assistance.

###  Health Score

62

—

FairBetter than 99% of packages

Maintenance82

Actively maintained with recent releases

Popularity44

Moderate usage in the ecosystem

Community36

Small or concentrated contributor base

Maturity77

Established project with proven stability

 Bus Factor1

Top contributor holds 80.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~26 days

Recently: every ~72 days

Total

151

Last Release

109d ago

Major Versions

0.9.9 → 1.0.02016-09-21

1.9.9 → 2.0.02020-03-30

PHP version history (2 changes)0.6.3PHP >=5.3

1.2.1PHP >=5.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/f3f71fa88954b93f55af5e121f1d8c38d240a0d17712c092a389bcccffa34415?d=identicon)[retlehs](/maintainers/retlehs)

![](https://www.gravatar.com/avatar/cee88e66996739c7b6c142648cc403f8d9c435b98ff4fe0fde016853c1a0d767?d=identicon)[techAPJ](/maintainers/techAPJ)

![](https://www.gravatar.com/avatar/bb70de721e4d9d6bd759d4073d3a08704c48ce98eb66b3e5e3e475e46ad39af5?d=identicon)[scossar](/maintainers/scossar)

---

Top Contributors

[![scossar](https://avatars.githubusercontent.com/u/2975917?v=4)](https://github.com/scossar "scossar (1744 commits)")[![angusmcleod](https://avatars.githubusercontent.com/u/5931623?v=4)](https://github.com/angusmcleod "angusmcleod (63 commits)")[![retlehs](https://avatars.githubusercontent.com/u/115911?v=4)](https://github.com/retlehs "retlehs (51 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (49 commits)")[![arpitjalan](https://avatars.githubusercontent.com/u/5732281?v=4)](https://github.com/arpitjalan "arpitjalan (47 commits)")[![SamSaffron](https://avatars.githubusercontent.com/u/5213?v=4)](https://github.com/SamSaffron "SamSaffron (44 commits)")[![iamntz](https://avatars.githubusercontent.com/u/132062?v=4)](https://github.com/iamntz "iamntz (35 commits)")[![adamcapriola](https://avatars.githubusercontent.com/u/279928?v=4)](https://github.com/adamcapriola "adamcapriola (21 commits)")[![eviltrout](https://avatars.githubusercontent.com/u/17538?v=4)](https://github.com/eviltrout "eviltrout (18 commits)")[![coding-horror](https://avatars.githubusercontent.com/u/1522517?v=4)](https://github.com/coding-horror "coding-horror (17 commits)")[![pjv](https://avatars.githubusercontent.com/u/327716?v=4)](https://github.com/pjv "pjv (13 commits)")[![surrealroad](https://avatars.githubusercontent.com/u/61921?v=4)](https://github.com/surrealroad "surrealroad (10 commits)")[![sanislav](https://avatars.githubusercontent.com/u/655643?v=4)](https://github.com/sanislav "sanislav (8 commits)")[![henrynet](https://avatars.githubusercontent.com/u/2919791?v=4)](https://github.com/henrynet "henrynet (7 commits)")[![santouras](https://avatars.githubusercontent.com/u/358368?v=4)](https://github.com/santouras "santouras (5 commits)")[![erlend-sh](https://avatars.githubusercontent.com/u/583842?v=4)](https://github.com/erlend-sh "erlend-sh (4 commits)")[![ZogStriP](https://avatars.githubusercontent.com/u/362783?v=4)](https://github.com/ZogStriP "ZogStriP (3 commits)")[![nylen](https://avatars.githubusercontent.com/u/227022?v=4)](https://github.com/nylen "nylen (3 commits)")[![ahmader](https://avatars.githubusercontent.com/u/2225278?v=4)](https://github.com/ahmader "ahmader (2 commits)")[![nigelbabu](https://avatars.githubusercontent.com/u/373438?v=4)](https://github.com/nigelbabu "nigelbabu (2 commits)")

---

Tags

authenticationcommentsdiscussionssingle-sign-onwordpress-pluginwordpressdiscourse

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/discourse-wp-discourse/health.svg)

```
[![Health](https://phpackages.com/badges/discourse-wp-discourse/health.svg)](https://phpackages.com/packages/discourse-wp-discourse)
```

###  Alternatives

[daggerhart/openid-connect-generic

OpenID Connect generic WordPress plugin.

30481.2k1](/packages/daggerhart-openid-connect-generic)[devgeniem/wp-geniem-roles

Wrapper class for WordPress role creation and manipulation.

1857.0k](/packages/devgeniem-wp-geniem-roles)[forumone/openid-connect-wp

OpenID Connect generic WordPress plugin.

204.3k](/packages/forumone-openid-connect-wp)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)