Skip to content
A plugin for SwiftMailer and Symfony that sets default properties for email Messages
PHP
Branch: master
Clone or download
Pull request Compare This branch is 1 commit ahead, 1 commit behind Finesse:master.
davehenton Update test.yml
add CC test reporter ID
Latest commit c0747b9 Nov 13, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update test.yml Nov 13, 2019
src fix: The plugin doesn’t work with SwiftMailer 4 May 1, 2018
tests Fixed PHP 7.2 tests with PHPUnit 5 May 1, 2018
.gitattributes
.gitignore Start building the plugin Oct 7, 2017
CONTRIBUTING.md Added something to read Oct 7, 2017
LICENSE Updated the licence year Mar 13, 2018
README.md Add a Symfony 4 configuration example Oct 25, 2019
composer.json Changed the repository address May 10, 2018
phpunit.xml ... Oct 20, 2017

README.md

Swift Mailer Defaults Plugin

Latest Stable Version Total Downloads PHP from Packagist Test Status Maintainability Test Coverage

This plugin adds a possibility to set default properties for the sent Messages (default from address, reply to, subject and so on).

// Set up a Mailer
$transport = new Swift_SmtpTransport();
$mailer = new Swift_Mailer($transport);
$mailer->registerPlugin(new Finesse\SwiftMailerDefaultsPlugin\SwiftMailerDefaultsPlugin([
    'from' => ['johndoe@example.com' => 'John Doe'],
    'replyTo' => 'jackdoe@example.com'
]));

// Use the Mailer many times
$mailer->send(
    (new Swift_Message())
        ->setTo('bjohnson@example.com', 'Bill Johnson')
        ->setSubject('Hi')
        ->setBody('This is awesome, I don\'t need to specify the from address!')
);

How to install

Using composer

Run in a console

composer require finesse/swiftmailer-defaults-plugin

How to use

Create and register a plugin instance when you setup a Swift_Mailer instance.

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 4 you can register the plugin this way:

services:
    # Swift Mailer plugins
    Finesse\SwiftMailerDefaultsPlugin\SwiftMailerDefaultsPlugin:
        tags:
              - { name: swiftmailer.default.plugin }
        arguments:
              $defaults:
                  from:
                      johndoe@example.com: John Doe
                  replyTo: jackdoe@example.com
     
Symfony 3 example
services:
    # Swift Mailer plugins
    app.swiftmailer.defaults_plugin:
        class: Finesse\SwiftMailerDefaultsPlugin\SwiftMailerDefaultsPlugin
        tags:
              - { name: swiftmailer.default.plugin }
        arguments:
              $defaults:
                  from:
                      johndoe@example.com: John Doe
                  replyTo: jackdoe@example.com
     

When you need to send an email, just send it without specifying the parameters you set to the plugin instance.

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:

$defaultsPlugin = new SwiftMailerDefaultsPlugin([
    'from' => 'johndoe@example.com',
    '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.

$defaultsPlugin->setDefault('sender', 'chasy@example.com', 'Chasy');

The first argument is the property name (see __constructor for reference). The rest arguments are the corresponding method arguments.

unsetDefault

Removes a default value

$defaultsPlugin->unsetDefault('sender');

The only argument is the property name (see __constructor for reference).

Versions compatibility

The project follows the Semantic Versioning.

License

MIT. See the LICENSE file for details.

You can’t perform that action at this time.