<p>Stream of Consciousness supports plugins to extend it’s functionality</p>
<p>To enable, make sure the “plugindir” option is set and points to a valid directory.</p>
<p>In this dir, add files with the “.rb” extension, a plugin as the following format:</p>
<pre>
plugin_name="A test plugin"
plugin_hook="sidebar"
code=lambda {
puts "Hello World!"
}
</pre>
<p>the plugin_hook specifies when the code will execute. The following hooks are defined:</p>
<ol>
<li>sideitems – Executes when the side bar is rendered, useful for adding new items</li>
<li>html_head – Executes in the template in the <head></head> section. Good for adding any additional headers you want such as loading a new css or js file</li>
<li>load_entries – Executes after entries are loaded. Useful for altering the content of entries. This can be used to fo text filters, add textile support, etc. the instance variable @entries will hold all the posts.</li>
<li>before_single_entry – executes before viewing a single entry</li>
<li>after_single_entry – executes after viewing a single entry</li>
</ol>
<p>New hooks can be added on the fly by calling the do_hook method, For example, the code do_hook(‘my_new_hook’) will call any plugin with “my_new_hook” defined.</p>
<p>Since plugins are eval’d inside the instanced class, you have access to all the internals of the software from your plugin, it is therefore possible to do other neat things, it should even be possible to redefine methods so that posts are loaded from a database, new templates are loaded file files, etc.</p>
2009-11-26T08:09:28-08:00
122074
plugins
93145
Plugins
2009-02-18T11:27:52-08:00
41378