Add Plugins

Every paragraph-like item in the page's story has a type field that says how it should be displayed.

When you Choose Plugins from the factory menu a properly typed item is added in place of the factory.

If you create or copy a paragraph that referes to a plugin you don't have then you can expect it to render as an error message.

When adding new plugins one normally starts this way.

Use the Plugin

Click the [+] at the bottom of a page to create a factory item. This item has one of the simplest representations in the page json.

Find the page on your server in the data/pages directory. Edit this file in a programmer's text editor. Find the factory item at the bottom of the story array.

Change the type field to name some new type that may or may not be present in your plugin directory. Add additional keyword-value pairs that may be required by the plugin.

Install the Plugin

Wiki will load plugin javascript from the client/plugins directory. If you don't have the javascript you need you can snag it elsewhere or write it yourself.

Look to GitHub to find cool plugins. Find the raw javascript you need and save it to your own plugins directory.

Write new plugins by copying the style you find in the standard plugins. You can write in javascript or coffeescript. If you use coffeescript then you will need to launch the coffeescript translator to create the javascript that wiki will try to load.