Create and send mail templates in plone.
Project description
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
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for zettwerk.mailtemplates-0.2.2.zip
Algorithm | Hash digest | |
---|---|---|
SHA256 | a5744b4cd2ec6a3931666851c80f3722ea4596f5d0f41bfe35fbb5729c331fee |
|
MD5 | cc2069f6f951aeedfdb428bac6237f68 |
|
BLAKE2b-256 | 9ebda75d1f4fb8fe56471e767b767e3ea1fa9362d880cf931a6326bea1e95c53 |