Plugin / SoloMail

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:

   {{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.