Package: hl.plone.boardnotifications
IntroductionContentsIntroductionInstallationUpgrading from previous versionsConfiguration of Mail TemplatesSubject and SignatureVariablesPersonalized Mail SalutationsExamples of mailing textsChangelog1.1 (2015-10-19)1.0 (2015-01-13)0.9 (2014-12-10)0.8 (2014-03-19)0.7 (2013-08-01)0.6 (2013-07-22)0.5 (2013-02-11)0.4 (2013-02-05)0.3 (2012-12-13)0.2 (2012-08-23)0.1 (2012-08-23)hl.plone.boardnotificationsprovides email notifications forPloneboardfor several
purposes. It allows you to:let users subscribe/unsubscribe to forum threads;notify conversation/comment owners when their content has been edited,
deleted, or moved to a different forum by a moderator;configure a specific mail text for each purpose. Leave the mail text empty
for notification types you don’t want to use;personalize mails using memberdata properties;use conversation/comment URL and title in the notifications.InstallationAdd the package to your buildout.Run buildout.Restart Zope.Installhl.plone.boardnotificationsusing the Plone Control Panel.Visit “Board Notifications” in the site control panel (go to@@boardnotifier-settings) and configure the mail templates (seeConfiguration of Mail Templatesbelow).Upgrading from previous versionsIn version 1.1, storing subscriptions has changed. To migrate existing subscriptions:Backup your databasego to Plone Control Panel -> Add-onsscroll down to Activated add-ons, search for Board Email Notifications and click UpgradeIf anything goes wrong feel free to submit abug reportConfiguration of Mail TemplatesSubject and SignatureIf you choose to configure subject and signature, those will be used in all
templates. If you want to use subjects and signature on a per-template basis,
leave these fields blank. You can then add the signature to each template as
appropriate. For a per-template subject, enter:Subject:your subject hereon the first line of the mail template, followed by a blank line.VariablesYou can use a number of variables to produce meaningful mail texts using
standard Python string interpolation specifiers with the variable name as
mapping key (i.e.%(variable_name)s). The following variables are available
in the email templates:all member properties as defined inportal_memberdata;conversation title: use%(threadtitle)sto reference the conversation’s
title;conversation URL: use%(threadurl)sto reference the conversation’s URL;forum title: use%(boardtitle)sto reference the forum’s title;comment URL: use%(commenturl)sto reference the comment’s URL.comment text: use%(commenttext)sto reference the comment’s text.Personalized Mail SalutationsThe salutation field can be used to define gender specific salutations. If you
don’t need this feature, just leave it blank. When you save your settings, your
empty string will be replaced by:- simply ignore this. You can still put a
generic salutation in each mail template and use%(fullname)sto address
the recipient.If you want personalized salutations,hl.plone.boardnotificationsdefines a
new member property named ‘salutation’. It is your responsibility to fill
it per member by e.g. customizing@@personal-settings. Then you have to map
the possible contents of the salutation member property to the desired
salutation, e.g.:Mr:Dear Mr. %(fullname)s,

Mrs:Dear Mrs. %(fullname)s,

:Dear Mrs./Mr. %(fullname)s,Examples of mailing textsA comment has been added to a conversation, notify conversation subscribers:Subject:New comment in thread "%(threadtitle)s"

%(salutation)s

There is a new post in thread "%(threadtitle)s", in the forum "%(boardtitle)s".
You are suscribed to this thread.

Here is the comment text:
%(commenttext)s

Go to the latests post:
%(commenturl)s

%(mailsignature)s

If you don't want to be notified: %(threadurl)s/unsubscribe

This e-mail has been sent automatically.A conversation has been moved to another forum:Subject:Conversation "%(threadtitle)s" has been moved

%(salutation)s

The conversation "%(threadtitle)s" has been moved to "%(boardtitle)s".

Go to the moved conversation:
%(threadurl)s

%(mailsignature)sChangelog1.1 (2015-10-19)do not try to send notification e-mail if destination address is not available (rafaelbco)use an OOBTree for storing subscriptions1.0 (2015-01-13)fix event handler (move subscriptions)0.9 (2014-12-10)when a thread is moved to another forum, move the subscriptions as wellnotify subscribers when a thread is moved0.8 (2014-03-19)Make sure commenttext is unicode (jean)Make it not fail when deleting the PloneSite (rafaelbco)0.7 (2013-08-01)meaningful viewlet names0.6 (2013-07-22)add mail-in functionality (jean)forum subscription (jean)add ‘commenttext’ as a notification mail option (jean)0.5 (2013-02-11)added basque and spanish translations (erral)0.4 (2013-02-05)fixhttps://github.com/Haufe-Lexware/hl.plone.boardnotifications/issues/1(erral)0.3 (2012-12-13)added documentationdo not try to send emails to users that have been deleteddo not send email when a template contains only whitespace0.2 (2012-08-23)working MANIFEST.in0.1 (2012-08-23)initial release