README

一个用于简化发送邮件的WordPress库。

功能介绍

尽管WordPress有wp_mail()函数，但在发送邮件时仍有许多需要注意的事项。例如

• 您需要添加一个特殊过滤器来发送HTML邮件。
• 您需要添加一个特殊过滤器来设置发件人名称和/或邮箱。
• 如果未正确解码，邮件主题行或发件人名称中的特殊字符可能无法正确显示。
• 要向邮件中添加CC或BCC收件人，您需要添加特殊头信息。
• 如果您想包含姓名，则邮件收件人格式必须正确。
• 添加过滤器可能会影响通过系统发送的其他邮件。

此库消除了这些担忧，并使得设置和发送邮件变得简单，而不会影响从系统中发送的其他邮件。

如何使用它

1. 通过 Composer 添加到您的项目中

$ composer require wpscholar/wp-email

1. 确保您已将Composer自动加载器添加到项目中

<?php

require __DIR__ . '/vendor/autoload.php';

1. 创建一个新的邮件

<?php

use wpscholar\WordPress\Email;

// Create new email instance
$email = new Email();

// Set subject and message
$email->subject = 'Welcome!';
$email->message = '<p>Lorem ipsum dolor sit amet...</p>';

// Customize the from name and email
$email->from( 'John Doe <john@email.com>' );

// Add any recipients
$email->addRecipient( 'Jane Doe <jane@email.com>' );
$email->addCcRecipient( 'James Doe <james@email.com>' );
$email->addBccRecipient( 'Super Spy <topsecret@email.com>' );

// Add any attachments
$email->addAttachment( '/wp-content/uploads/attachment.pdf' );

// Send email
$email->send();

或

<?php

use wpscholar\WordPress\Email;

$email = new Email( [
	'subject'     => 'Welcome!',
	'message'     => '<p>Lorem ipsum dolor sit amet...</p>',
	'from'        => 'John Doe <john@email.com>',
	'to'          => [ 'Jane Doe <jane@email.com>' ],
	'cc'          => [ 'James Doe <james@email.com>' ],
	'bcc'         => [ 'Super Spy <topsecret@email.com>' ],
	'attachments' => [ '/wp-content/uploads/attachment.pdf' ],
] );

$email->send();