Quick Mail WordPress Plugin

Send text or html email with attachments and shortcodes from WP Dashboard or command line. Send private replies to comments. Select recipient from users or commenters. Compatible with multisite. Includes WP-CLI command.

• Requires: WordPress 4.6
• Tested up to: WordPress 6.5
• Stable version: 4.1.9

Description

Quick Mail is the easiest way to send emails with attachments to WordPress users on your site, or to send private replies to comments.

Features

• Send email with attachments and shortcodes from the WordPress dashboard or command line.

• Send private replies to comments.

• Select recipients from users or commenters.

• Compatible with multisite.

• Adds Quick Mail to the Tools menu and comment replies.

• Send a web page, file, or message from the command line with the quick-mail command for WP-CLI.

• Does not require the Gutenberg editor or REST API.

• Edit messages with TinyMCE to add images, rich text, and shortcodes.

• Uses the sender's name and sets the reply-to address to the sender's address.

• Recognizes settings from Mailgun, SparkPost and Sendgrid plugins.

• Attach multiple files from up to six directories (folders) to a message.

• Includes privacy options to help comply with General Data Protection Regulation.

• Banned domains: administrators can prevent users from sending mail to arbitrary domains.

Installation

Legacy

1. Download the latest release and unpack in your /wp-content/plugins directory.

2. Activate the plugin through the WordPress Plugins menu.

WP-CLI

• How to install and activate the latest version of Quick Mail with WP-CLI :

  wp plugin install https://github.com/mitchelldmiller/quick-mail-wp-plugin/archive/master.zip --activate

Configuration

• Visit the settings page at Settings -> Quick Mail to configure the plugin for your site.

• Optional: Install WP-CLI to send mail from the command line.

• Optional: Install Mailgun, SparkPost or Sendgrid plugin to send reliable email.

• Optional: Install experimental Replace Quick Mail Sender plugin, to change administrator's credentials.

Updates

• Install Git Updater plugin to update Quick Mail from Github.

Translators / Translations

• Quick Mail is not distributed with translations.

• A .pot file is included for new translators.

Frequently Asked Questions

Who can send mail?

• Users must be able to publish a post to send an email.

• WP-CLI: By default, only administrators can send mail with the quick-mail WP-CLI command. Use the quick_mail_cli_admin_only filter to let other users send mail.

Who can send rich text messages?

• User must have Visual Editor enabled on their profile, to compose messages with the Visual Editor.

• Anyone can send HTML by pasting it into a message.

Where Do I Find Sent Emails?

• You should be able to find sent emails in your email account's Sent Mail folder.

• Delivery services like Mailgun, SparkPost and Sendgrid also provide this information.

Selecting Recipients

• Options to send mail to any user, or limit to users with first and last names on their profile.

• Users need permission to list users, to view user list or change options. Minimum permission can be changed with an option or filter.

Mail Delivery Services

• Uses Mailgun plugin settings for Administrators, if the plugin is activated, using Override "From" Details and Mailgun API.

• Uses SparkPost plugin settings for Administrator name and email address, if plugin is activated and Overrides for name and email are set.

• Option for administrators to use Sendgrid API.

• Replace Quick Mail Sender is an experimental plugin that changes the Quick Mail sender's name and email address.

• Programmers can replace their credentials by adding a filter to replace_quick_mail_sender. This only works if you are not using another mail plugin's credentials.

Sending Mail from Other Addresses

• Install the [Replace Quick Mail Sender](https://github.com/mitchelldmiller/replace-quick-mail-sender/ releases/latest) plugin, to change the Quick Mail sender's name and email address.

• Programmers can replace their credentials by adding a filter to replace_quick_mail_sender.

• NOTE: Other email plugins can change these settings.

Privacy

• Requires permission to use your email address.

• Requires permission to save email addresses. Saved addresses are cleared if permission option is changed.

Limitations

• Up to 12 manually entered recipients are saved in HTML Storage.

• Additional recipients can be either CC or BCC but not both.

• Up to 99 recipients for Gmail, others.

• Multiple files can be uploaded from up to 6 folders (directories).

• "Uploads are disabled" on mobile devices.

Some devices cannot upload files. According to Modernizr :

iOS < 6 and some android version don't support this

• File uploads are disabled for ancient IOS 5 devices. Please add a support message if uploads are disabled on your phone or tablet.

Address Validation

• Check recipient domain on manually entered addresses.

• International (non-ASCII) domains must be converted to Punycode with idn_to_ascii.

  Unfortunately, idn_to_ascii is not available on all systems.

• "Cannot verify international domains because idn_to_ascii function not found"

  This is displayed when Quick Mail cannot verify domains containing non-ASCII characters.

• checkdnsrr is used to check a domain for an MX record.

  An MX record tells senders how to send mail to the domain.

  This is not always accurate. Turn verification off if Quick Mail rejects a valid address.

Mail Errors

• Quick Mail sends email with wp_mail.

  wp_mail error messages are displayed, if there is a problem.

• "You must provide at least one recipient email address."

  wp_mail rejected an address. Seen when Quick Mail verification is off.

• "Invalid or blocked mail address."

  You tried sending mail to a Banned Domain.

• Error: Invalid Role (WP-CLI error)

  You tried sending mail to an unknown WordPress role. Use wp list roles to get role names.

Incompatible Plugins

• Stop Emails

Stop Emails displays:

To send emails, disable the plugin.

If you are using an email delivery service, you can ignore this message.

Customizing Quick Mail

• Add a filter to modify Quick Mail.

• What filters are available to modify Quick Mail?

replace_quick_mail_sender

Replace sender credentials. Expects associative array with values for name and email.

See Replace Quick Mail Sender plugin for examples.

quick_mail_cli_attachment_message

Replace default CLI attachment message.

quick_mail_cli_attachment_subject

Replace default CLI attachment subject.

quick_mail_comment_style

Replace quick mail comment style.

quick_mail_reply_title

Replace title for private comment reply on comments list.

quick_mail_user_capability

Replace minimum user capability.

quick_mail_cli_admin_only

Allow non-admin users to send mail with WP-CLI.

Additional Information

• 42 articles about Quick Mail

Translators and Programmers

• A .pot file is included for translators.

License

Quick Mail is licensed under the MIT License. Encourage future development with a donation.

Credits

Banner image by Tumisu.