- Title
- Short overview explaining how and why we use it
- Plugin discussion url on https://meta.discourse.com
- Github url
From the Discourse Plugin Library
Support available in the Discourse Plugin Library
Menu Links
- Adding links to the main menu and other menus without needing coding
- https://meta.discourse.org/t/navigation-add-custom-menu-items/53124
- https://github.com/vinkas0/discourse-navigation
- also requires docker manager plugin
git clone:
https://github.com/discourse/docker_manager.git
https://github.com/vinkas0/discourse-navigation.git
.
Voting
- Used for where voting will aid decision making, with the intention of using this heavily (with edits) in our community governance model in the future
- https://meta.discourse.org/t/discourse-voting/40121/
- https://github.com/discourse/discourse-voting
.
Who’s Online
- Allows users to see who’s online. Helps the chat app too
- https://meta.discourse.org/t/whos-online-plugin-discourse-whos-online/52345
- https://github.com/davidtaylorhq/discourse-whos-online
.
Kanban Boards
- Allows us to create kanban project management boards in specific threads and categories so teams can coordinate their efforts on projects using Scrum/Agile Methodology
- https://meta.discourse.org/t/kanban-board-theme-component/118164
- https://github.com/discourse/discourse-kanban-theme
.
Chat Room Plugin (our Slack sync)
- Used for integration between main channels for members who need to use other platforms, usually because they are at work and have down time to support a cool project
- https://meta.discourse.org/t/chatroom-integration-plugin-discourse-chat-integration/66522
- https://github.com/discourse/discourse-chat-integration.git
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
- Allows users to login using Linkedin as well as current options
- Pros: Useful to those who use Linked in often
- Cons: Might interfere with our React/Meteor platform which is synced to copy account creation and login from Discourse (this forum).
- https://meta.discourse.org/t/linkedin-oauth2-plugin/46818
- https://github.com/discourse/discourse-plugin-linkedin-auth
.
Add buttons at the bottom of posts
- Could be used to easily expand functionality
- https://meta.discourse.org/t/add-a-button-at-the-bottom-of-a-topic-visible-to-everyone-discourse-custom-topic-button/36217
.
Add buttons at the bottom of a post ONLY visible to a specific group
- Adds ability to incentivise joining groups and expand functionality
- https://meta.discourse.org/t/add-a-button-at-the-bottom-of-a-topic-visible-to-a-specific-group-discourse-topic-group-button/36216
.
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.