Components - Docuss

Our community building and discussion forum uses a pretty slick integration with Discourse the worlds largest opensource forum software. This sync enables us to use Discourse to handling the community building, communications, admin functions, and backend of the most of the platform.

Settings in our Github

Docuss Project Github

Plugin

In our Discourse settings you’ll find a plugin called: dcs-discourse-plugin. This is where the default category is set among other functions

Connecting Docuss to Specific Pages

Discourse Categories for Each Page

The category posts are created in on each page can be edited here:

File Format

Admin Controls

When composing or editing a post an admin can press ‘Alt+A’ at the same time to reveal and edit the category the post will be placed, and to see and edit the hidden tags Docuss puts in to allow it to find threads.

Known Docuss Bugs and Bug Fixes

You need to select a category before posting:
Docuss automatically selects a category from the category names on our platform. If it can’t find a category then it won’t select one accurately.
The category names at line 173 here have to exactly match a category name in our platform (the url string is unimportant, just the name). If you want more information you can see this issue being explored and resolved here

Url links open inside of our platform when not intended:
If the link is internal this behaviour looks as if our platform is open inside itself and you’ll see a double menu at the top of the page. If the link is external you’ll see the internet page users wanted to visit when clicking, but loaded inside public happinessmovement.com, so our platforms main menu appears as a frame around it.

The solution is to add this code: <CardLink href={item.url} target="_top"> to the link. You should find a working example on line 30 here