hl.plone.boardnotifications 1.1

Subject and Signature

If 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 here

on the first line of the mail template, followed by a blank line.

Variables

You 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 in portal_memberdata;

• conversation title: use %(threadtitle)s to reference the conversation’s title;

• conversation URL: use %(threadurl)s to reference the conversation’s URL;

• forum title: use %(boardtitle)s to reference the forum’s title;

• comment URL: use %(commenturl)s to reference the comment’s URL.

• comment text: use %(commenttext)s to reference the comment’s text.

Personalized Mail Salutations

The 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)s to address the recipient.

If you want personalized salutations, hl.plone.boardnotifications defines 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 texts

A 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)s

1.1 (2015-10-19)

• do not try to send notification e-mail if destination address is not available (rafaelbco)

• use an OOBTree for storing subscriptions

1.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 well

• notify subscribers when a thread is moved

0.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 names

0.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)

• fix https://github.com/Haufe-Lexware/hl.plone.boardnotifications/issues/1 (erral)

0.3 (2012-12-13)

• added documentation

• do not try to send emails to users that have been deleted

• do not send email when a template contains only whitespace

0.2 (2012-08-23)

• working MANIFEST.in

0.1 (2012-08-23)

• initial release