Title: SoloMail
Author: shacker
Published: <strong>February 1, 2011</strong>
Last modified: February 2, 2011

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/solomail.svg)

# SoloMail

 By [shacker](https://profiles.wordpress.org/shacker/)

[Download](https://downloads.wordpress.org/plugin/solomail.1.3.zip)

 * [Details](https://wordpress.org/plugins/solomail/#description)
 * [Reviews](https://wordpress.org/plugins/solomail/#reviews)
 *  [Installation](https://wordpress.org/plugins/solomail/#installation)
 * [Development](https://wordpress.org/plugins/solomail/#developers)

 [Support](https://wordpress.org/support/plugin/solomail/)

## Description

SoloMail is a WordPress plugin designed to email an HTML-formatted copy of a single
post to site subscribers or a mailing list. There are quite a few solutions out 
there designed to send batch digests of recent posts to subscribers on a scheduled
basis. SoloMail solves a different problem – you may want to cherry pick just certain
posts to go out via email, and you may want the ability to “send now.”

The subscriber list can EITHER be the group of all registered users on a site OR
a single address, such as a mailing list. Though you can use SoloMail either way,
I recommend sending through a proper mailing list, which provides advantages such
as handling and unsubscribing bounced/dead addresses, and metered sending for large
lists.

Please send bug reports / requests via
 http://hosting.birdhouse.org/contact/

## Installation

 1. Upload to wp-content/plugins and activate.
 2. Move the two provided templates and one provided stylesheet into your current theme
    directory: solomail.html solomail.txt solomail-styles.css
 3. Visit the Settings | SoloMail section in your Dashboard. During testing, set it
    to send to a single address (your own). After testing, change that address to that
    of a mailing list to which your site administrator’s address has permission to 
    post (SoloMail emails will be sent FROM the site administrator’s email address).
    Or select Registered Users for the Subscription Group Type.
 4. Edit the provided templates and stylesheet as needed. Don’t forget the .txt version–
    you can test it by selecting the “text only” view in your mail client (if you use
    Apple Mail, use Cmd-[ and Cmd-] to cycle through the available multipart formats).
    SquirrelMail is another good way to test the text version. The following set of
    template variables are available to both versions:
 5. {{stylesheet_url}} {{site_url}} {{site_title}} {{post_title}} {{post_author}} {{
    post_date}} {{post_body}} {{post_permalink}} {{newsletter_title}}

Yes, these are Django-style template variables 🙂

SoloMail sends multi-part email, with HTML format primary and text as a fallback.
The templates are stored in your theme directory rather than in the plugin directory
so that A) Your customizations won’t be overridden by a plugin update and B) you
can edit them the same way you edit theme files.

Feel free to use the provided templates as-is or create your own. Note that SoloMail
intentionally does not attempt to use the standard WP template system. That’s because
HTML email has unique needs, and shouldn’t have all the header crap and extras that
appear on your site. If you’ve never sent HTML email before, see a tutorial such
as http://articles.sitepoint.com/article/code-html-email-newsletters

Note that if you modify a post and send it via SoloMail _in the same step_, the 
modifications will not be in the email. I’m not sure why this is, but you must save
your changes first, _then_ send it.

## FAQ

#### How do I use SoloMail?

Select a post that’s _already been edited and saved_, and that you consider finished.
At the top right of the sidebar, you’ll see a SoloMail checkbox. Select the checkbox
and click the usual Update button on the post page. The email will be sent immediately
to the group chosen in SoloMail options.

The checkbox will not remain checked – it’s safe to edit the post again without 
risk of sending out mail again accidentally.

Only site administrators can send email with SoloMail. On multi-author sites, administrators
can send other authors’ posts out, as well as their own.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“SoloMail” is open source software. The following people have contributed to this
plugin.

Contributors

 *   [ shacker ](https://profiles.wordpress.org/shacker/)

[Translate “SoloMail” into your language.](https://translate.wordpress.org/projects/wp-plugins/solomail)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/solomail/), check out
the [SVN repository](https://plugins.svn.wordpress.org/solomail/), or subscribe 
to the [development log](https://plugins.trac.wordpress.org/log/solomail/) by [RSS](https://plugins.trac.wordpress.org/log/solomail/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.3

 * Added option to send either full posts or excerpts.

#### 1.2

 * Fixed bug that caused emails to be sent twice. This was because the WordPress
   post_save action actually runs twice, so needed to wrap our function in a test
   for presence of a global var.

#### 1.1

 * Initial release.

## Meta

 *  Version **1.3.0**
 *  Last updated **15 years ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 3.0 or higher **
 *  Tested up to **3.0.5**
 * Tag
 * [email](https://wordpress.org/plugins/tags/email/)
 *  [Advanced View](https://wordpress.org/plugins/solomail/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/solomail/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/solomail/reviews/)

## Contributors

 *   [ shacker ](https://profiles.wordpress.org/shacker/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/solomail/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](http://birdhouse.org/software)