zettwerk.mailtemplates 0.2.2

Create and send mail templates in plone.

Introduction

Create mail templates in plone.

If you want to send emails out of plone, you need to create a custom template or method. With this extension it is possible to create mail templates and send them without the need of programming. Nevertheless there is an api to send such created templates by code. For choosing the recipients you can filter by users or groups. In addition there are also extensible user filter, queried through the zca.

Installation

Add zettwerk.mailtemplates to your buildout eggs:

eggs = ..
       zettwerk.mailtemplates

After running buildout and starting the instance, you can install Zettwerk Mailtemplates via portal_quickinstaller to your instance.

Use-Case

Go to the plone configuration and click on the Zettwerk Mailtemplates link, listed under the custom extensions. Use plone’s add menu to add a template. Enter a title (which results in the mail subject) and a mail body text. Also set the template-id.

Click on “portal_mail_templates” on the breadcrumb. Now you can filter the recipients by username or group selection. Try the simulate button the get a list of the selected recipients. Hit the send button to send the mail(s).

By filtering a group, you can provide an additional filter. These are registered utilities for zettwerk.mailtemplates.interfaces.IMessageTemplateUserFilter - see the configure.zcml and the utility with the name “registration_reminder” for an example. This on returns only users which have never logged in to your plone site.

Recursive Groups

By selecting a group only the toplevel group members are used. If the group contains other groups, there members are not used.

Override Plone’s default templates

It is common to customize Plone’s default templates for registration and password reset. zettwerk.mailtemplates supports this through the web - no need to add custom template overrides via code. Just add a template with id ‘registration’ or ‘password_reset’ and it is used - that’s all.

Todos

• Tests and api documentation needed.

Changelog

0.2.2 (2014-10-01)

• Filter out recursive group members

0.2.1 (2014-07-14)

• Fixed bug in send_emailview

0.2.0 (2014-07-11)

• Added support to override Plone’s default templates: registration and password reset.

0.1.2 (2014-06-06)

• changed uninstall: keep the tool object, otherwise existing templates gets removed on reinstall

• added default template on fresh install

0.1.1 (2014-06-04)

• fixed packaging

0.1 (2014-05-02)

• Inital release (prototype)

• Added uninstall profile

Contributors

Jörg Kubaile

Download