Acorn Mail

Acorn Mail is a simple package handling WordPress SMTP using Acorn's mail configuration.

Support us

Roots is an independent open source org, supported only by developers like you. Your sponsorship funds WP Packages and the entire Roots ecosystem, and keeps them independent. Support us by purchasing Radicle or sponsoring us on GitHub — sponsors get access to our private Discord.

Requirements

• PHP >= 8.1
• Acorn >= 3.0

Installation

Install via Composer:

$ composer require roots/acorn-mail

Getting Started

Start by optionally publishing Acorn's mail config:

$ wp acorn mail:config

SMTP credentials can be found in the published mail.php config file and default to environment variables.

Usage

For most configurations, you can simply set the following variables in your environment:

MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_FROM_ADDRESS=
MAIL_FROM_NAME=

If you need to change the default encryption from tls, you can set the encryption variable:

MAIL_ENCRYPTION=ssl

Once the credentials are properly configured, you can send a test email using Acorn's CLI:

$ wp acorn mail:test [--to=] [--subject=] [--body=]

You can customize the test email subject and body:

# Test with custom subject and body
$ wp acorn mail:test --subject="Deploy Test" --body="Deployment successful"

# Test with custom recipient
$ wp acorn mail:test --to=admin@example.com

If any errors are detected, they will be printed to console.

Community

Keep track of development and community news.

• Join us on Discord by sponsoring us on GitHub
• Join us on Roots Discourse
• Follow @rootswp on Twitter
• Follow the Roots Blog
• Subscribe to the Roots Newsletter