基本要求
1.声明您的电子邮件模板
声明自定义电子邮件模板,请创建文件/etc/email_templates.xml
<config
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Email:etc/email_templates.xsd">
<template id="abandonedcart_item1"
label="Abandoned Cart Item 1"
file="abandonedcart_item1.html"
type="html"
module="Magenest_AbandonedCart"
area="frontend"
/>
</config>
Template id:您的模板id
Label:您的标签将显示在下拉电子邮件中。
file:您的电子邮件模板文件。
type:电子邮件的类型。
module:您的模块。
area:将电子邮件放在模块目录view/frontend或view/adminhtml中
2.定义电子邮件模板
在步骤1中,基于文件和区域创建一个HTML文件。在我们的示例中,自定义模板有file=“undervedcart_item1.html”和area=“frontend”,因此该模板的路径是/view/frondend/email/endervedcart_item1.html。
<!--@subject {{trans "Did you forget something?"}} @-->
{{template config_path="design/email/header_template"}}
<table style="float:left; margin-right: 10px" class="fue-abc-items">
<tr>
<td>
<div class="greeting">Hi {{var customerName}},</div>
<!-- Custom Image with your email-->
<img src="{{view url='Magenest_AbandonedCart::images/customimage.png'}}"/>
<div>
{{trans "I’m from %store_name. " store_name=$store.getFrontendName()}},
{{trans "you haven’t forgotten us as well as the shopping cart you left in our store recently. "}}
{{trans "Thus, we would love to be sure that below items will catch your attention again."}}
</div>
</td>
</tr>
<tr>
<td>
{{var cart_items}}
</td>
</tr>
<tr>
<td style="text-align: center;">
<div style="margin-top: 30px;">
{{trans "Use coupon code "}}
<span style="font-weight: bold">{{var coupon.code}}</span>
{{trans "at checkout!"}}
</div>
<div>{{var checkOpened}}</div>
</td>
</tr>
<tr>
<td style="text-align: center;">
{{trans "If you want to complete your purchase just click the link below."}}
</td>
</tr>
<tr>
<td style="text-align: center;">
<a style="color: #fff;border: 1px solid transparent; padding: 16px 32px; outline: none; text-decoration: none; cursor: pointer; text-align: center;border-radius: 4px;"
href="{{var resumeLink}}" target="_blank">
<button style="color: white; margin-top: 10px;margin-bottom: 30px;border: 0; -webkit-box-shadow: none; -moz-box-shadow: none; box-shadow: none; background: #000; padding: 10px 15px; -webkit-border-radius:5px; -moz-border-radius:5px; border-radius:5px;">
{{trans "Checkout Now"}}
</button>
</a>
</td>
</tr>
<tr>
<td>
<div>
{{trans "Or if anything got you confused in shopping process?"}}
{{trans "Feel free to contact again to discuss problems you may have."}}
{{trans "Your satisfaction is the best product we desire to deliver."}}
</div>
</td>
</tr>
<tr>
<td>
<div>
{{trans "Looking forward to seeing you around!"}}
</div>
</td>
</tr>
<tr>
<td>
<div style="font-size: 9px;text-align: center;">No longer want to receive these email ? You can
<a href="{{var unsubscribeLink}}" style="text-decoration-line: underline;font-weight: 400;">unsubscribe
here</a>
</div>
</td>
</tr>
</table>
{{template config_path="design/email/footer_template"}}
trans用于支持翻译的文本(如果由扩展的i18n提供)。您可以使用默认变量,即$store。getFrontendName()以获取电子邮件上的店铺名称。
var表示电子邮件控制器提供的变量。
template ,根据config_path自动插入其他模板(即页眉/页脚)
注意:一些电子邮件客户端仅支持CSS样式作为HTML标记的样式属性的内联样式。您可以转到“Marketing -> Email templates -> Add New Template”来查看您的自定义电子邮件模板
3.创建运输生成器
要定制Magento的电子邮件功能,我们需要创建一个传输构建器类,扩展“Magento\Framework\Mail\Template\TransportBuilder”。
在我们的示例中,我们将添加向电子邮件发送pdf和图像附件的功能
文件名:Magenest/AbandonedCart/Model/Mail/TransportBuilder.php
class TransportBuilder extends
\Magento\Framework\Mail\Template\TransportBuilder
{
public function getMessage()
{
return $this->message;
}
//create attachment items for email based on parameters
public function createAttachment($params, $transport = false)
{
$type = isset($params['cat']) ? $params['cat'] : \Zend_Mime::TYPE_OCTETSTREAM;
if ($transport === false) {
if ($type == 'pdf') {
$this->message->createAttachment(
$params['body'],
'application/pdf',
\Zend_Mime::DISPOSITION_ATTACHMENT,
\Zend_Mime::ENCODING_BASE64,
$params['name']
);
} elseif ($type == 'png') {
$this->message->createAttachment(
$params['body'],
'image/png',
\Zend_Mime::DISPOSITION_ATTACHMENT,
\Zend_Mime::ENCODING_BASE64,
$params['name']
);
} else {
$encoding =
isset($params['encoding']) ? $params['encoding'] : \Zend_Mime::ENCODING_BASE64;
$this->message->createAttachment(
$params['body'],
$type,
\Zend_Mime::DISPOSITION_ATTACHMENT,
$encoding,
$params['name']
);
}
} else {
$this->addAttachment($params, $transport);
}
return $this;
}
public function addAttachment($params, $transport)
{
$zendPart = $this->createZendMimePart($params);
$parts = $transport->getMessage()->getBody()->addPart($zendPart);
$transport->getMessage()->setBody($parts);
}
protected function createZendMimePart($params)
{
if (class_exists('Zend\Mime\Mime') && class_exists('Zend\Mime\Part')) {
$type = isset($params['type']) ? $params['type'] : \Zend\Mime\Mime::TYPE_OCTETSTREAM;
$part = new \Zend\Mime\Part(@$params['body']);
$part->type = $type;
$part->filename = @$params['name'];
$part->disposition = \Zend\Mime\Mime::DISPOSITION_ATTACHMENT;
$part->encoding = \Zend\Mime\Mime::ENCODING_BASE64;
return $part;
} else {
throw new \Exception("Missing Zend Framework Source");
}
}
public function reset()
{
return parent::reset();
}
}
4.发送电子邮件
要从类发送电子邮件,其构造函数需要调用transportbuilder类。您可以使用默认的Magento\Framework\Mail\Template\TransportBuilder。php或自定义的(在我们的示例中是Magenest\AbandonedCart\Model\Mail\TransportBuilder.php)。
下面是sendMail()函数的一个片段,它涵盖了创建电子邮件对象的所有步骤
use Magenest\AbandonedCart\Model\Mail\TransportBuilder
...
public function sendMail()
{
//define variables for the email generate email template with template file and templates variables
$template = 'abandonedcart_item1';
$recipient_address = '[recipient email]';
$recipient_name = ‘[recipient name]’;
$from_address = ‘[
‘Name’ => [sender name],
‘Email’ => [sender email]
]’;
//an array with variables, format is key = variable name, value = variable value
$vars = [
...
];
//several variables in email template, i.e. storeName are generated based on store Id
$storeId = [store Id];
$this->_inlineTranslation->suspend();
$version = $this->_helperData->getVersionMagento();
if(version_compare($version,'2.2.0') < 0){
//create email object for Magento 2.1.x
$this->_transportBuilder->setTemplateIdentifier(
$template
)->setTemplateOptions(
[
'area' => \Magento\Framework\App\Area::AREA_FRONTEND,
'store' => $storeId,
]
)->setTemplateVars(
$vars
)->addTo(
$recipient_address,
$recipient_name
);
}
//create email template for Magento 2.2.x and 2.3.x
else {
$this->_transportBuilder->setTemplateIdentifier(
$template
)->setTemplateOptions(
[
'area' => \Magento\Framework\App\Area::AREA_FRONTEND,
'store' => $storeId,
]
)->setTemplateVars(
$vars
)->setFrom(
$from_address
)->addTo(
$recipient_address,
$recipient_name
);
}
//add bcc email address
$bccMail = ‘[email address]’;
$this->_transportBuilder->addBcc($bccMail);
//add attachments to email object
if ($attachments) {
//check version of Zend Framework in use based on the existence of createAttachment function in Magento 2’s default transportBuiler
if (method_exists($this->_transportBuilder->getMessage(), 'createAttachment')) {
foreach ($attachments as $attachment) {
if ($attachment) {
$this->_transportBuilder->createAttachment($attachment);
}
}
$transport = $this->_transportBuilder->getTransport();
} else {
$transport = $this->_transportBuilder->getTransport();
foreach ($attachments as $attachment) {
if ($attachment) {
$this->_transportBuilder->createAttachment($attachment, $transport);
}
}
}
}
//create the transport
if (!isset($transport)) {
$transport = $this->_transportBuilder->getTransport();
}
//send the email
try {
$transport->sendMessage();
$this->_inlineTranslation->resume();
} catch (\Exception $exception) {
//log failed email send operation
$this->_logger->critical($exception->getMessage());
}
}
5.结果