php-censor/docs/en/plugins/email.md
2016-07-19 22:35:21 +06:00

38 lines
1.1 KiB
Markdown

Plugin Email
------------
Sends a build status email.
Configuration
=============
### Options
* **committer** - Whether or not to send the email to the committer that prompted this build.
* **addresses** - A list of addresses to send to.
* **default_mailto_address** - A default address to send to.
* **cc** - A list of addresses that will receive a copy of every emails sent.
* **template** - The template to use, options are short and long. Default is short on success and long otherwise.
**Note:** _This plugin will only work if you configured email settings during installation or configured them later in Admin Options > Settings > Email Settings_
### Examples
See [Adding PHP Censor Support to Your Projects](../config.md) for more information about how to configure plugins.
Send an email to the committer as well as one@exameple.com if a build fails:
```yml
failure:
email:
committer: true
default_mailto_address: one@example.com
```
Send an email to one@example.com every time a build is run:
```yml
complete:
email:
default_mailto_address: one@example.com
```