douglasmariz / email-twig-pdf
Email-Twig-PDF 是一个用于提交电子邮件、生成 PDF 并使用 Twig 渲染模板的抽象类。
1.0.3
2018-08-11 21:59 UTC
Requires
- php: >=7.0.0
- spipu/html2pdf: 5.2.*
- swiftmailer/swiftmailer: 6.1.2
- twig/twig: v2.5.0
Requires (Dev)
- symfony/var-dumper: 3.3.14
This package is not auto-updated.
Last update: 2024-09-27 00:45:50 UTC
README
PHP 邮件类:用于发送邮件的库。包括 "swiftmailer", "twig" 和 "html2pdf"。
Email-Twig-PDF 是一个用于提交电子邮件、生成 PDF 并使用 Twig 渲染模板的抽象类。
如何使用
文件和文件夹配置
Verifique se os modelos existem no diretório base: "{DIRETORIO_BASE}/templates/email/{feature}/{fileName}".
Se não existir, crie o(s) modelo(s) com extensões {.html.twig} para enviar mensagens HTML e {.text.twig} para uma mensagem simples sem tags html.
EmailTwigPdf_Config 类
Você pode configurar um diretório base para armazenar os templates.
Ex: $config = new EmailTwigPdf_Config(['template_path' => __DIR__.'/your-path']);
OBS: Deve seguir a seguinte estrutura:
DIRETORIO_BASE
templates
email
EmailTwigPdf_Auth 类
Classe para colocar suas credenciais de acesso ao email do remetente.
Ex:
$credentials = [
'userName' => 'user_name',
'password' => 'password',
'from' => 'email@gmail.com',
'fromName' => 'from_name',
'smtp' => 'smtp.email.com',
'port' => 465,
'encryption' => 'ssl',
];
$auth = new EmailTwigPdf_Auth($credentials);
示例模板
Já existe uma pasta chamada "templates" com um modelo default, de exemplo.
简单使用类
require_once('vendor/autoload.php');
use \DouglasMariz\Email\Twig\Pdf\EmailTwigPdf_Email;
use \DouglasMariz\Email\Twig\Pdf\EmailTwigPdf_Auth;
use \DouglasMariz\Email\Twig\Pdf\EmailTwigPdf_Config;
try {
$email = new EmailTwigPdf_Email($auth, $config);
$context = [
'nome' => 'Usuário',
'titulo' => 'Título',
'mensagem' => 'Lorem ipsum dolor sit amet, consectetur adipisicing elit.
Blanditiis cum debitis et expedita fugit hic iure laboriosam laudantium.',
];
$result = $email->setTo('email@gmail.com', 'Nome Destinatário')
->setSubject('Assunto do email')
->setTemplateFile('pasta-arquivo', $context)
->setCssFile('pasta-arquivo')
->setDateHour() //Adiciona ao template a data e hora no formato pt_BR, apenas se existir no template as variáveis {{data}} e {{hora}}
->pdf()
->sendMail();
} catch (Exception $e) {
echo $e->getMessage();
}
实用工具
$email->pdf(); // Para gerar um arquivo PDF e enviar como anexo ao email.
$email->setFileNamePdf(); // Define o nome para o arquivo PDF.
$email->setBlock(); // Define o BLOCO que será utilizado no template, caso esteja definido
EX:
{% if block == 'default' %}
{% block default %}
{{ content }}
{% endblock %}
{% endif %}
$email->showTemplateText(); // Renderiza na tela o template.
$email->showTemplateHtml(); // Renderiza na tela o template.