Previous tutorial: Developing Discourse Plugins - Part 1 - Create a basic plugin
Many plugins need to add and extend the Discourse web interface. We provide a mechanism to do this called plugin outlets in handlebars templates.
If you browse the discourse handlebars templates, you’ll often see the following markup:
<PluginOutlet @name="edit-topic" />
This is declaring a plugin outlet called “edit-topic”. It’s an extension point in the template that plugin authors can leverage to add their own handlebars markup.
When authoring your plugin, look in the discourse handlebars templates (in
.hbs files) you want to change for a
<PluginOutlet />. If there isn’t one, just ask us to extend it! We’ll happily add them if you have a good use case. If you want to make it easier and faster for us to do that, please submit a pull request on github!
If you want to see some of the places where plugin outlets exist, you can run the following command if you’re on OSX or Linux:
$ git grep "<PluginOutlet" -- "*.hbs"
Once you’ve found the plugin outlet you want to add to, you have to write a
connector for it. A connector is really just a handlebars template whose filename includes
connectors/<outlet name> in it.
For example, if the Discourse handlebars template has:
<PluginOutlet @name="evil-trout" />
Then any handlebars files you create in the
will automatically be appended. So if you created the file:
With the contents:
Discourse would insert
<b>Hello World</b> at that point in the template.
Note that we called the file
hello.hbs – The final part of the filename does not matter, but it must be unique across every plugin. It’s useful to name it something descriptive of what you are extending it to do. This will make debugging easier in the future.
- Double check the name of the connector and make sure it matches the plugin name perfectly.