[[PageOutline(2-5,Contents,pullout)]]

= Email Notifications for FullBlogPlugin

== Description

This plugin uses the blog change interface in FullBlogPlugin to send out email notifications for:

 * new posts
 * updated posts
 * comment added
 * deleted posts

Email notifications are sent to the user who made the change.  Notifications can also be sent to other users or a distribution list by specifying the `smtp_always_cc` option.

The emails are sent in plain text using a template that was modeled after Trac's [t:browser:/trunk/trac/ticket/templates/ticket_notify_email.txt ticket_notify_email] template.

If you are using the AnnouncerPlugin, you should use its [AnnouncerPlugin/PluginSupport/FullBlogPlugin FullBlogPlugin] rather than the FullBlogNotificationPlugin.

== Bugs/Feature Requests

Existing bugs and feature requests for FullBlogNotificationPlugin are 
[report:9?COMPONENT=FullBlogNotificationPlugin here].

If you have any issues, create a 
[/newticket?component=FullBlogNotificationPlugin new ticket].

== Download

Download the zipped source from [export:fullblognotificationplugin here].

== Source

You can check out FullBlogNotificationPlugin from [/svn/fullblognotificationplugin here] using Subversion, or [source:fullblognotificationplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Example

You should first configure Trac to send notifications. For details see t:TracNotification.

Once Trac is configured to send notifications, using the `trac.ini` options available below you can get notifications of blog changes:

{{{#!ini
[fullblog-notification]
always_notify_author = False
from_email = tracblog@localhost
from_name = None
reply_to_email = tracadmin@localhost
notification_actions = post_created, post_updated, post_comment_added, post_deleted, post_deleted_version
no_notification_categories = Draft, draft
smtp_always_cc = []
subject_template = $prefix $blog.title ($action)
}}}

== Recent Changes

[[ChangeLog(fullblognotificationplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:trickie] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''