@header@

<table width="100%" cellspacing="0" cellpadding="8" class="item">
  <tr class="itemHeader">
    <td>
      Plugins
    </td>
  </tr>
  <tr class="itemBody">
    <td>

      <p>
      Plugins are a way to extend the functionality of Pebble in a structured way and most of the plugin APIs
      currently available allow you to write Java classes that are notified when particular events occur.
      The plugin APIs available are as follows.
      <ul>
        <li><a href="blog-entry-decorators.html">Blog entry decorators</a></li>
        <li><a href="permalink-providers.html">Permalink providers</a></li>
        <li><a href="blog-listeners.html">Blog listeners</a></li>
        <li><a href="blog-entry-listeners.html">Blog entry listeners</a></li>
        <li><a href="comment-listeners.html">Comment listeners</a></li>
        <li><a href="trackback-listeners.html">TrackBack listeners</a></li>
      </ul>
      </p>

      <p>
      With all types of plugins, to use your own implementation you must add your compiled class(es) to the classpath of the Pebble web application. To do this,
      either place the class file(s) underneath the <code>/WEB-INF/classes</code> directory or inside a JAR file
      placed underneath the <code>/WEB-INF/lib</code> directory.
      <blockquote>If you've added
      new classes to the web application classpath, you may need to restart the web application so that they are
      picked up by the servlet container.</blockquote>
      </p>

      <p>
      Next, login to your blog, click the <b>Plugins</b> link
      and enter the fully qualified class name in the appropriate place. This will either be a textfield in which a single class name
      can be specified, or a textarea containing a whitespace (i.e. space or carriage return) separated list of class
      names.
      </p>

      <p>
      After saving, click the <b>Reload blog</b> link so that the plugins are registered with your blog and started.
      </p>

    </td>
  </tr>
</table>

@footer@