2017 © Pedro Peláez
 

library mailman

Easier email sending for Laravel 5 with CSS inlining.

image

waavi/mailman

Easier email sending for Laravel 5 with CSS inlining.

  • Friday, October 6, 2017
  • by sildraug
  • Repository
  • 10 Watchers
  • 2 Stars
  • 2,331 Installations
  • HTML
  • 0 Dependents
  • 0 Suggesters
  • 6 Forks
  • 1 Open issues
  • 13 Versions
  • 5 % Grown

The README.md

Better email for Laravel 5

Latest Version on Packagist Software License Build Status Total Downloads, (*1)

Introduction

Mailman has all of Laravel's Mail features, plus allows you to:, (*2)

- Keep your email css files in an external file, and automatically inline them when sending an email.
- Set the language in which the email should be sent, without affecting the rest of your application.
- Avoid the annoying use of callbacks.

WAAVI is a web development studio based in Madrid, Spain. You can learn more about us at waavi.com, (*3)

Laravel compatibility

Laravel translation
4.x 1.2.x
5.0.x 2.0.x
5.1.x 2.0.x
5.2.x 2.0.2 and up
5.3.x 2.0.3 and up

Installation

Require through composer, (*4)

composer require waavi/mailman 2.0.x

Or manually edit your composer.json file:, (*5)

"require": {
    "waavi/mailman": "2.0.x"
}

Publish the configuration file:, (*6)

php artisan vendor:publish

In config/app.php, add the following entry to the end of the providers array:, (*7)

\Waavi\Mailman\MailmanServiceProvider::class,

And edit the aliases array to include:, (*8)

'Mailman' => \Waavi\Mailman\Facades\Mailman::class,

Usage

Basic example

Usage is very similar to Laravel's Mail, with no callbacks needed. In fact, Mailman is expected to be used just like you use Views. Say you have an email view in views/emails/email. You may send the email by:, (*9)

Mailman::make('emails.email')->to('info@example.com')->subject('test')->send();

The from address and general email configuration will be loaded from app/mail.php, whereas email stylesheet configuration is done through the mailman.php config file., (*10)

Passing data to an email's view

Say you want to pass data to the view, you may do so in two ways: through the make method and the with method, just like in Views:, (*11)

Mailman::make('emails.welcome', array('user' => $user))->to('user@example.com')->subject('welcome')->send();
Mailman::make('emails.welcome')->with(['user', $user])->to('user@example.com')->subject('welcome')->send();
Mailman::make('emails.welcome')->with('user', $user)->to('user@example.com')->subject('welcome')->send();

Setting the locale

To set the locale in which the email should be sent, you may use the set locale method:, (*12)

Mailman::make('emails.basic')->setLocale('es')->to('user@example.com')->subject('hello')->send();

Setting the css file to use

You may set a different css file than default. The parameter must be the full path relative to the base folder:, (*13)

Mailman::make('emails.basic')->setCss('resources/assets/css/private.css')

Queue emails

You may queue emails just like with Laravel's Mail. To send an email through a queue:, (*14)

Mailman::make('emails.basic')->to...->queue()                  // Queue in default queue.
Mailman::make('emails.basic')->to...->queue('queue_name')      // Queue in queue_name queue.
Mailman::make('emails.basic')->to...->later(5)                 // Send email after 5 seconds.
Mailman::make('emails.basic')->to...->laterOn(5, 'queue_name')

Fake sending email

If you are using Laravel's Homestead, the recommend way would be to install MailCatcher., (*15)

Get the email as a string

For debugging, it is often useful to be able to print the contents of an email. With Mailman you may get the body of the email using Mailman::show(), (*16)

Mailman::make('emails.basic')->to('user@example.com')->subject('hello')->show();

Common methods (Illuminate\Mail\Message)

All methods in Illuminate\Mail\Message are available through Mailman:, (*17)

Mailman::make('emails.basic')->to('john@doe.it')
Mailman::make('emails.basic')->to('john@doe.it', 'John Doe')      // Set the recipient.

Mailman::make('emails.basic')->from('john@doe.it')
Mailman::make('emails.basic')->from('john@doe.it', 'John Doe')    // Set from field.

Mailman::make('emails.basic')->sender('john@doe.it')
Mailman::make('emails.basic')->sender('john@doe.it', 'John Doe')  // Set sender.

Mailman::make('emails.basic')->returnPath('john@doe.it')          // Set return path.

Mailman::make('emails.basic')->cc('john@doe.it')
Mailman::make('emails.basic')->cc('john@doe.it', 'John Doe')      // Add carbon copy.

Mailman::make('emails.basic')->bcc('john@doe.it')
Mailman::make('emails.basic')->bcc('john@doe.it', 'John Doe')     // Add blind carbon copy.

Mailman::make('emails.basic')->replyTo('john@doe.it')
Mailman::make('emails.basic')->replyTo('john@doe.it', 'John Doe') // Add reply to.

Mailman::make('emails.basic')->subject('Subject text')            // Add subject

Mailman::make('emails.basic')->priority(5)                        // Set priority level

Mailman::make('emails.basic')->attach('file/test.pdf', $options)  // Attach file

Mailman::make('emails.basic')->attachData($data, $name, $options) // Attach in-memory data

Mailman::make('emails.basic')->embed('file/test.jpg')             // Embed file and get cid

Mailman::make('emails.basic')->embedData($data, $name, $contentType)  // Embed data

The Versions

06/10 2017

dev-master

9999999-dev

Easier email sending for Laravel 5 with CSS inlining.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Waavi

laravel email mailer waavi mailman

06/10 2017

2.0.7

2.0.7.0

Easier email sending for Laravel 5 with CSS inlining.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Waavi

laravel email mailer waavi mailman

05/09 2017

2.0.6

2.0.6.0

Easier email sending for Laravel 5 with CSS inlining.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Waavi

laravel email mailer waavi mailman

10/08 2017

2.0.5

2.0.5.0

Easier email sending for Laravel 5 with CSS inlining.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Waavi

laravel email mailer waavi mailman

23/11 2016

2.0.4

2.0.4.0

Easier email sending for Laravel 5 with CSS inlining.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Waavi

laravel email mailer waavi mailman

24/08 2016

2.0.3

2.0.3.0

Easier email sending for Laravel 5 with CSS inlining.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Waavi

laravel email mailer waavi mailman

16/03 2016

2.0.2

2.0.2.0

Easier email sending for Laravel 5 with CSS inlining.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Waavi

laravel email mailer waavi mailman

23/12 2015

2.0.0.1

2.0.0.1

Easier email sending for Laravel 5 with CSS inlining.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Waavi

laravel email mailer waavi mailman

23/12 2015

dev-dev

dev-dev

Easier email sending for Laravel 5 with CSS inlining.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Waavi

laravel email mailer waavi mailman

23/12 2015

2.0

2.0.0.0

Easier email sending for Laravel 5 with CSS inlining.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Waavi

laravel email mailer waavi mailman

11/12 2015

1.2

1.2.0.0

Easier email sending for Laravel

  Sources   Download

The Requires

 

by Waavi

07/05 2014

1.0.x-dev

1.0.9999999.9999999-dev

Easier email sending for Laravel

  Sources   Download

The Requires

 

by Waavi

07/05 2014

1.0

1.0.0.0

Easier email sending for Laravel

  Sources   Download

The Requires

 

by Waavi