@header@

<table width="100%" cellspacing="0" cellpadding="8" class="item">
  <tr class="itemHeader">
    <td>
      Blog Entry Listeners
    </td>
  </tr>
  <tr class="itemBody">
    <td>
      <p>
      Blog entry listeners are a type of Pebble plugin that allow you to write code that is called
      whenever a blog entry is added or removed. The following blog entry listeners are included with the Pebble distribution.
      <ul>
      <li><b>pebble.event.blogentry.EmailNotificationListener</b> - sends a notification e-mail when a new blog entry is added.</li>
      <li><b>pebble.event.blogentry.XmlRpcNotificationListener</b> - sends an <a href="update-pings.html">XML-RPC update notification ping</a> when a blog entry is added.</li>
      </ul>
      </p>

      <p>
      To write your own listener, you need to write a Java class that implements the <a href="../javadoc/pebble/event/BlogEntryListener.html">pebble.event.blogentry.BlogEntryListener</a> interface
      as shown below. To gain access to the associated <a href="../javadoc/pebble/blog/BlogEntry.html">blog entry</a>, simply use the <code>getBlogEntry()</code> method on the <a href="../javadoc/pebble/event/BlogEntryEvent.html">pebble.event.blogentry.BlogEntryEvent</a> object
      that is passed to the callback methods.
<pre>  package pebble.event;

  /**
   * Implemented by classes wanting to be notified of blog entry events.
   *
   * @author Simon Brown
   */
  public interface BlogEntryListener {

    /**
     * Called when a blog entry has been added.
     *
     * @param event   a BlogEntryEvent instance
     */
    public void blogEntryAdded(BlogEntryEvent event);

    /**
     * Called when a blog entry has been removed.
     *
     * @param event   a BlogEntryEvent instance
     */
    public void blogEntryRemoved(BlogEntryEvent event);

  }</pre>
      </p>
    </td>
  </tr>
</table>

@footer@