Discourse Plugins (this forum)

Documentation Web Dev Documentation
, , , ,
#1

Quick Install

If you already know what you’re doing here’s the code you need to install the currently used plugins:

cd /var/discourse
nano containers/app.yml


hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
            - git clone https://github.com/discourse/docker_manager.git
            - git clone https://github.com/discourse/docker_manager.git
            - git clone https://github.com/vinkas0/discourse-navigation.git
		- git clone https://github.com/discourse/discourse-voting
		- git clone https://github.com/davidtaylorhq/discourse-whos-online
		- git clone https://github.com/vinkas0/discourse-navigation
		- git clone https://github.com/discourse/discourse-kanban-theme
		- git clone https://github.com/sylque/docuss
		- git clone https://github.com/discourse/discourse-assign
		- git clone https://github.com/discourse/discourse-calendar
		- git clone https://github.com/paviliondev/discourse-custom-wizard
		- git clone https://github.com/paviliondev/discourse-events
		- git clone https://github.com/pmusaraj/discourse-onesignal
 		- git clone https://github.com/paviliondev/discourse-quick-messages

cd /var/discourse
./launcher rebuild app

From the Discourse Plugin Library

Support available in the Discourse Plugin Library

Format:

  1. Title
  2. Short overview explaining how and why we use it
  3. Plugin discussion url on https://meta.discourse.com
  4. Github url

Menu Links

git clone:
https://github.com/discourse/docker_manager.git
https://github.com/vinkas0/discourse-navigation.git

.

Voting

.

Who’s Online

.

Kanban Boards

.

Chat Room Plugin (our Slack sync)

Discourse Library Plugins which have been edited by our Community

Custom Builds

Docuss

  • The integration which allows this forum to interact with, and power our community building, communications, and much of our admin area.
  • https://github.com/sylque/docuss
    note: Sylvain ( @syl ) is both an independent, and an important part of our community. He founded Docuss and operates closely with us as we partnered and are the 1st website bringing his independent vision of Docuss to life.

Plugins under Consideration

Calendar

  • Pros: This could be used in each team category to help teams organise meetings, collaborate work sessions, and schedule their desired commitment which is a big help in helping people keep to the commitment they want to make. Currently served just about adequately by external Timetree.
  • Cons: Looks to be lacking in user friendly features, so would be confusing to those not comfortable with tech.
  • Library link: https://meta.discourse.org/t/discourse-calendar/97376/
  • Github: https://github.com/discourse/discourse-calendar

.

Linkedin Oauth

.

Add buttons at the bottom of posts

.

Add buttons at the bottom of a post ONLY visible to a specific group

.

Staff Notes

  • Allows staff to tag notes and comment on specific users
  • Pros: allows experienced users to better keep tabs on anyone behaving in a suspicious manner they suspect to be operating against the community values they agreed to
  • Cons: communication out in the open is in line with our community values. we don’t want miscommunication by discussions happening behind closed doors. A culture of asking people what they are doing and why to understand - or remove them if its not inline with why we are here, would be better
  • https://meta.discourse.org/t/staff-notes-plugin/41026

.

The Discourse Plugin Library

Official: https://meta.discourse.org/tags/c/plugin/official
All: https://meta.discourse.org/c/plugin
note: clicking on ‘views’ or ‘replies’ to order the forum posts is a fairly good way of bringing the most popular plugins to the top

How to Install a New Plugin

Ask someone from the Dev team who has access to our Digital Ocean server to add a plugin and share this guide with them. Its a very quick (2 min) process so they shouldn’t mind.

Current Devs with Access:

You then need any forum admin to navigate to plugins and turn it on

A few admins:

Plugin installation tutorial

So you want to install a plugin on your Discourse instance? Great, let’s get started!

In this tutorial, we’ll install Discourse Spoiler Alert plugin.

  • Get the plugin’s GitHub or Bitbucket git clone url.
  • Access your container’s app.yml file (present in /var/discourse/containers/ )
cd /var/discourse
nano containers/app.yml
  • Add the plugin’s repository URL to your container’s app.yml file:
hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/docker_manager.git
          - git clone https://github.com/discourse/discourse-spoiler-alert.git

(Add the plugin’s git clone url just below git clone https://github.com/discourse/docker_manager.git )

  • Rebuild the container:
cd /var/discourse
./launcher rebuild app

That’s it, you’ve successfully installed the Discourse Spoiler Alert plugin on your Discourse instance!

Note: I think our app.yml file (and other files) are inside Docker. Please let me know if that’s correct so I can update this tutorial.

Setting up Discourse via the admin section after launching a new site
Getting Started: Making a PR or Commit via Github
#2

@danyalamriben i began some documentation. I didn’t dig too deep, don’t worry i haven’t taken all the fun out of the search, i just found a few.

I wanted to ask Tom to install the Kanban as you’ve been waiting ages. It’s about 5 secs extra to add more than one plugin, so i looked through for the ones we’ve talked about before.