roots / acorn-mail
Simple WordPress SMTP using Acorn's mail configuration.
Maintainers
Fund package maintenance!
Requires
- php: >=8.1
Requires (Dev)
- laravel/pint: ^1.13
- roots/acorn: ^4.0
README
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
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