pserver.mailer 1.0.1.dev0

No project description provided

.. contents::

PSERVER.MAILER
==============


Configuration
-------------

config.json can include mailer section::

"applications": ["pserver.mailer"],
"mailer": {
"default_sender": "[e-mail]",
"endpoints": {
"default": {
"type": "smtp",
"host": "localhost",
"port": 25
}
}
}


Printing mailer
---------------

For development/debugging, you can use a console print mailer::

"applications": ["pserver.mailer"],
"mailer": {
"default_sender": "[e-mail]",
"endpoints": {
"default": {
"type": "smtp",
"host": "localhost",
"port": 25
}
},
"utility": "pserver.mailer.utility.PrintingMailerUtility"
}


Sending mail
------------

POST http://localhost:8080/zodb/plone/@mailer

{
"sender": "[e-mail]",
"recipient": "[e-mail]",
"subject": "Some subject",
"text": "Hello"
}


Permissions
-----------

`pserver.mailer` defines a permission `mailer.SendMail` which, by default,
only the `plone.SiteAdmin` role is assigned.


Using the mailer in code
------------------------

You can also directly use the mailer in your code::

from zope.component import queryUtility
from pserver.mailer.interfaces import IMailer
mailer = queryUtility(IMailer)
await mailer.send(recipient='[e-mail]', subject='This is my subject', text='Body of email')

1.0.1 (unreleased)
------------------

- nothing yet...

1.0.0 (2017-02-01)
------------------

- Initial release