Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/finesse/swiftmailerdefaultsplugin
A plugin for SwiftMailer and Symfony that sets default properties for email Messages
https://github.com/finesse/swiftmailerdefaultsplugin
defaults library plugin swiftmailer symfony
Last synced: 3 months ago
JSON representation
A plugin for SwiftMailer and Symfony that sets default properties for email Messages
- Host: GitHub
- URL: https://github.com/finesse/swiftmailerdefaultsplugin
- Owner: Finesse
- License: mit
- Created: 2017-10-07T05:09:42.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-02-01T05:15:39.000Z (almost 5 years ago)
- Last Synced: 2024-10-11T20:16:31.115Z (4 months ago)
- Topics: defaults, library, plugin, swiftmailer, symfony
- Language: PHP
- Homepage:
- Size: 34.2 KB
- Stars: 7
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# [Swift Mailer](https://swiftmailer.symfony.com/) Defaults Plugin
[](https://packagist.org/packages/finesse/swiftmailer-defaults-plugin)
[](https://packagist.org/packages/finesse/swiftmailer-defaults-plugin)
[](https://github.com/Finesse/SwiftMailerDefaultsPlugin/actions?workflow=Test)
[](https://codeclimate.com/github/Finesse/SwiftMailerDefaultsPlugin/maintainability)
[](https://codeclimate.com/github/Finesse/SwiftMailerDefaultsPlugin/test_coverage)
This plugin adds a possibility to set default properties for the sent Messages
(default from address, reply to, subject and so on).
```php
// Set up a Mailer
$transport = new Swift_SmtpTransport();
$mailer = new Swift_Mailer($transport);
$mailer->registerPlugin(new Finesse\SwiftMailerDefaultsPlugin\SwiftMailerDefaultsPlugin([
'from' => ['[email protected]' => 'John Doe'],
'replyTo' => '[email protected]'
]));
// Use the Mailer many times
$mailer->send(
(new Swift_Message())
->setTo('[email protected]', 'Bill Johnson')
->setSubject('Hi')
->setBody('This is awesome, I don\'t need to specify the from address!')
);
```
## How to install
### Using [composer](https://getcomposer.org)
Run in a console
```bash
composer require finesse/swiftmailer-defaults-plugin
```
## How to use
Create and register a plugin instance when you setup a `Swift_Mailer` instance.
```php
use Finesse\SwiftMailerDefaultsPlugin\SwiftMailerDefaultsPlugin;
use Swift_Mailer;
use Swift_SmtpTransport;
// Setup an emails sending transport
$transport = new Swift_SmtpTransport();
// Create a plugin instance
$defaultsPlugin = new SwiftMailerDefaultsPlugin(/* default properties */);
// Assemble them with a mailer
$mailer = new Swift_Mailer($transport);
$mailer->registerPlugin($defaultsPlugin);
```
For [Symfony](https://github.com/symfony/swiftmailer-bundle) 4 you can register the plugin this way:
```yaml
services:
# Swift Mailer plugins
Finesse\SwiftMailerDefaultsPlugin\SwiftMailerDefaultsPlugin:
tags:
- { name: swiftmailer.default.plugin }
arguments:
$defaults:
from:
[email protected]: John Doe
replyTo: [email protected]
```
Symfony 3 example
```yaml
services:
# Swift Mailer plugins
app.swiftmailer.defaults_plugin:
class: Finesse\SwiftMailerDefaultsPlugin\SwiftMailerDefaultsPlugin
tags:
- { name: swiftmailer.default.plugin }
arguments:
$defaults:
from:
[email protected]: John Doe
replyTo: [email protected]
```
When you need to send an email, just send it without specifying the parameters you set to the plugin instance.
```php
use Swift_Message;
$message = new Swift_Message();
$mailer->send($message);
```
If you specify, the specified parameters will override the default properties.
### __constructor
You can pass to the constructor all the properties that you can set to a `Swift_Mime_SimpleMessage` instance using the
`set...` methods. For example:
```php
$defaultsPlugin = new SwiftMailerDefaultsPlugin([
'from' => '[email protected]',
'subject' => 'Notification'
]);
```
The array keys are the names of the properties that are the `Swift_Mime_SimpleMessage` methods names without the `set`
word and with the lowercase first letter. For example, the `body` property corresponds to the `setBody` method,
`readReceiptTo` to `setReadReceiptTo` and so on.
The array values are the first and the only arguments for the corresponding methods. Properties with the `null` value
are ignored.
### setDefault
Sets a default value for a property.
```php
$defaultsPlugin->setDefault('sender', '[email protected]', 'Chasy');
```
The first argument is the property name (see [__constructor](#__constructor) for reference). The rest arguments are the
corresponding method arguments.
### unsetDefault
Removes a default value
```php
$defaultsPlugin->unsetDefault('sender');
```
The only argument is the property name (see [__constructor](#__constructor) for reference).
## Versions compatibility
The project follows the [Semantic Versioning](http://semver.org).
## License
MIT. See [the LICENSE](LICENSE) file for details.