README

#MailHub

Language: Chinese

MailHub is an email package for Laravel.

It integrates third-party email services with Laravel's SwiftMail, providing a unified protocol for email routines. A rule engine is employed to post emails to different domains by corresponding senders.

Provides elegant email interface instead of SwiftMail
Connects to third-party email services beyond SwiftMail
Currently implements email sending by SendCloud
Tags and queues planned in next versions
Discussions and PRs are welcome

##How to install:

# The introduction of dependent libraries
composer require mrvokia/mailhub:"dev-master@dev" -vvv

# Added service provider in the providers
MrVokia\MailHub\MailHubServiceProvider::class

# Add the aliases facade
'MailHub' => MrVokia\MailHub\MailHubFacade::class

# Composer auto load
composer dump

# Push Profile mailhub
php artisan vendor:publish

##How to use:

use MrVokia\MailHub\MailHub;

/**
 * Send mail
 */
public function example(MailHub $mailhub)
{
	$mailhub->send()
        	->to(['1@test.com', '2@test.com'])
        	->cc(['3@test.com'])
        	->subject('example')
        	->html('example content')
        	->start()
	//or
	MailHub::send()
			->to(['1@test.com', '2@test.com'])
			->cc(['3@test.com'])
			->subject('example')
			->html('example content')
			->start()
}

/**
 * Send template mail
 */
public function exampleTemplate(MailHub $mailhub)
{
	$mailhub->send()
        	->to(['1@test.com', '2@test.com'])
        	->subject('example')
        	->xsmtpapi([
				'active' => ['test', 'test2']
			])
        	->templateInvokeName('mail.register')
        	->start()
	//or
	MailHub::send()
       		->to(['1@test.com', '2@test.com'])
       		->cc(['3@test.com'])
       		->subject('example')
        	->xsmtpapi([
				'active' => ['test', 'test2']
			])
        	->templateInvokeName('mail.register')
       		->start()
}

##Params：

params	defaule	other	description
`gateway`	`''`	`swiftmail / sendcloud`	Specifies the gateway to send
`async`	`false`	`true`	Specify whether third-party mail (SendCloud) needs to use async send, reduce client response time after opening
`env`	`false`	`true`	Specifies whether to display APP_ENV at the bottom of the message template. When enabled, add the `{` {{$ env or ''}} `` to the current APP_ENV name in the mail template (to keep the production environment clean, APP_ENV = product will not be shown)
`pretend`	`false`	`true`	Specify whether to intercept the message, so that the message sent to the specified mailbox, mail address in the mailhub configuration file `mail_testname configuration
`queue`	`false`	`true`	Specify whether to enable SMTP mail queues. Refer to the Laravel documentation for queue configuration
`queueTarget`	`mailer`	`''`	Specifies the SMTP mail queue pipe name

##Thx

mrvokia / mailhub

Maintainers

Details

README

Language: Chinese

MailHub is an email package for Laravel.