# Components - Docuss

**URL:** https://publichappinessmovement.com/t/topic/1144
**Category:** Front End - Documentation
**Tags:** documentation, dcs, ruby-on-rails, discourse, webdev, reactjs, docuss
**Created:** [26 March 2019 14:37 UTC](https://publichappinessmovement.com/t/topic/1144 "2019-03-26T14:37:21Z")
**Posts on this page:** 4
**Page:** 1

<div class="post-metadata">

### Author: ![AndyatFocallocal](https://publichappinessmovement.com/user_avatar/publichappinessmovement.com/andyatfocallocal/32/651_2.png) [@AndyatFocallocal](https://publichappinessmovement.com/u/AndyatFocallocal)
#### Post date: [26 March 2019 14:37 UTC](https://publichappinessmovement.com/t/topic/1144/1 "2019-03-26T14:37:21Z")

</div>

Our community building and discussion forum uses a pretty slick integration with [Discourse](https://meta.discourse.com) 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

- [fl-maps/public/dcs-website.json at master · focallocal/fl-maps · GitHub](https://github.com/focallocal/fl-maps/blob/master/public/dcs-website.json)

## Docuss Project Github

- [Home](https://github.com/sylque/docuss)
- [Client and Libraries](https://github.com/sylque/dcs-client)
- [schema](https://github.com/sylque/dcs-website-schema)
- [Discourse Plugin](https://github.com/sylque/dcs-discourse-plugin2)

## 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

- [Adding urls](https://publichappinessmovement.com/admin/site_settings/category/all_results?filter=docus)
- [Pages where the url is set](https://github.com/focallocal/fl-maps/tree/master/public)
- [Connecting pages you created with the main site](https://publichappinessmovement.com/t/topic/1274)

## Discourse Categories for Each Page

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

- [Brighter Tomorrow Map](https://github.com/focallocal/fl-maps/blob/fl-sleeper/imports/client/ui/app.js#L12)
- [Public Happiness Movement](https://github.com/focallocal/fl-maps/blob/master/imports/client/ui/app.js)

## File Format

- [GitHub - sylque/dcs-website-schema](https://github.com/sylque/dcs-website-schema#file-format-reference)

## 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](https://github.com/focallocal/fl-maps/blob/master/imports/client/ui/app.js#L181) 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](https://publichappinessmovement.com/t/topic/2622/)

**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](http://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](https://github.com/focallocal/fl-maps/blob/deploy-phm/imports/client/ui/pages/Home/ProjectsSection/Item/index.js)

---

<div class="post-metadata">

### Author: ![AndyatFocallocal](https://publichappinessmovement.com/user_avatar/publichappinessmovement.com/andyatfocallocal/32/651_2.png) [@AndyatFocallocal](https://publichappinessmovement.com/u/AndyatFocallocal)
#### Post date: [26 August 2019 13:50 UTC](https://publichappinessmovement.com/t/topic/1144/2 "2019-08-26T13:50:45Z")

</div>

40 posts were split to a new topic: [Archive: Discussion on Docus](https://publichappinessmovement.com/t/topic/1574)

---

<div class="post-metadata">

### Author: ![gastonsk](https://publichappinessmovement.com/letter_avatar_proxy/v4/letter/g/a8b319/32.png) [@gastonsk](https://publichappinessmovement.com/u/gastonsk)
#### Post date: [19 May 2023 11:57 UTC](https://publichappinessmovement.com/t/topic/1144/40 "2023-05-19T11:57:05Z")

</div>

Hello everyone, sorry for the absence I got a job recently as IT support, I have some free time and I’m able to program so I been setting up the local environment again. There is a few things I don’t have clear yet.

1. Do I need to connect the meteor and discourse app if I’m gonna be working on the back-end? if so how do I do it? I tried running the script for discourse on the meteor app but I think I’m still missing something because I can only see the home page and as soon as I click something like the local forum it doesn’t work
2. As soon as I add the docuss plugin and enable it on my localhost it stops rendering the page completely. The “Adding Urls” link on this page is not working, is that relevant to this? I saw there is a setting on the Docuss plugin that lets you add a JSON with Urls, perhaps that’s what I’m missing?

Thank you in advance 🙂

---

<div class="post-metadata">

### Author: ![AndyatFocallocal](https://publichappinessmovement.com/user_avatar/publichappinessmovement.com/andyatfocallocal/32/651_2.png) [@AndyatFocallocal](https://publichappinessmovement.com/u/AndyatFocallocal)
#### Post date: [19 May 2023 16:41 UTC](https://publichappinessmovement.com/t/topic/1144/41 "2023-05-19T16:41:04Z")

</div>

@gastonsk Congrats on your job.

If you’re working on the backend you’ll probably want local host running so you can try things out, but its not necessary if you don’t want it.

We’ve got Teleport set up so you can access the servers. Right now its only set up on the deploy-[btm](https://brightertomorrowmap.com) branch, but one task we have now is to set Teleport up on master and deploy-phm so the backend team have access to everything.

1. The local side is a little broken with the update to the latest version of MeteorJS although you should be able to see the map. Can you share a screenshot of what you see when you click it. @zhna123 mentioned there was an issue with links right now, i think that might be what you are seeing.

2. Can you expand this as i’m not sure what’s going on. Taking a guess, you need to tell Docuss which pages to operate on. Did you follow this guide for discourse and Docuss: [Setting up Discourse for Local Development (Local Host)](https://publichappinessmovement.com/t/topic/2630)

also connecting Docuss to specific pages here: [Components - Docuss](https://publichappinessmovement.com/t/topic/1144)

The Master branch you downloaded should already have those pages set up.
