Version 5.0.1

the WordPress mailing platform

First Things First

Welcome. MailPress is a very special project to me and I'm proud to be a part of it ;-). Lot of hours have gone into MailPress, and I am dedicated to making it better every day. Thank you for making it part of your world.

— André Renaut

System requirements

• PHP version 5.2 or higher.
• MySQL version 5.0 or higher.
• WordPress version 2.9 or higher.

MailPress 5.0.1 is using swiftmailer 4.0.6.

Installation

1. Make sure you have already installed WordPress 3.0 or above.
2. Unzip the MailPress package.
3. Upload the mailpress folder into wp-content/plugins.
4. Make sure the wp-content/plugins/mailpress/tmp folder is writable.
5. Log in to your WordPress admin and point your browser to "Plugins" page.
6. Activate MailPress plugin.
7. Point your browser to "Plugins > MailPress Add-ons" and activate required/desired add-ons.
8. Point your browser to "Settings > MailPress", fill and save the settings for each tab (General, Connection to your mail server, Test, ... add-ons).
9. Once everything is installed, use the Test tab in "Settings > MailPress" to validate your settings.

Upgrading

Never use WordPress automatic upgrade : you will loose the content of mailpress/mp-content and mailpress/tmp folders !

Xml format has changed in 5.0.1, for mp-content/advanced/newsletters files.

1. Point your browser to "Plugins > MailPress Add-ons" page and deactivate all add ons.
2. Point your browser to "Plugins" page and deactivate MailPress plugin.
3. Save mailpress/tmp folder + your MP theme + any customized file in mailpress/mp-content/advanced (since 5.0.1, xml format changed in mp-content/advanced/newsletters).
4. Delete wp-content/plugins/mailpress folder.
5. Unzip the MailPress package.
6. Upload the mailpress folder into wp-content/plugins.
7. Make sure the wp-content/plugins/mailpress/tmp folder is writable.
8. Restore mailpress/tmp folder + your MP theme + any customized file in mailpress/mp-content/advanced (since 5.0.1, xml format changed in mp-content/advanced/newsletters).
9. If you implemented page or category template, upgrade from mailpress/mp-content/xtras folder if necessary.
10. Refresh "Plugins" page and activate MailPress plugin.
11. Activate MailPress previous add-ons (Plugins > MailPress Add-ons) + new ones such as Newsletter or Comment if previously used.

MailPress themes and templates do not need to be changed if customized in a previous MailPress release.

Upgrading from another system

MailPress can import the emails stored in another system.
First you need to get MailPress installed and working as described above.
To finally import your emails into MailPress, you will need to use the Import add-on.
You have developped your own importer and you think it can be useful to the MailPress community, let us know.

Resources

If you have any questions that aren't addressed in this document, please take advantage of MailPress numerous online resources:

Readme.txt

Read the readme.txt of MailPress

Plugin wiki

Bookmark and check often.

MailPress google group

The MailPress google group. See the Welcome page.

Some Add-ons

• Comment

  MailPress' subscribe to comments : Comment.

• Newsletters

  Allow subscription to newsletters. Newsletters are initialized with mailpress/mp-content/advanced/newsletters allowing you to fully customize each newsletter (theme, template, schedule ...) : Newsletter.

• Mailing lists

  Need to organize the emails inserted into MailPress and/or let your users to choose which mailing lists they subscribe to, based on WordPress taxonomy concept (post categories, link categories, tags) : Mailinglist.

• Batch mode

  Your website becomes more and more successful, you have now plenty of subscribers, processing a large number of recipients becomes an issue ! , use the Batch_send add-on.

• Bounce handling

  Process your mail bounces with Bounce_handing add-on.

• Tracking

  Track your mails will report opening rate, clicks generated as well as geolocations of your readers using the MailPress Ip api. Activate Tracking add-on.

• Synchronize with WordPress

  You want to synchronize MailPress with your WordPress registered users, Sync_wordpress_user add on is made for you.

• User Roles

  If you need to set Capabilities in MailPress, use the Roles_and_capabilities add-on.
  You can read more about Roles and Capabilities on the Codex.

• SMTP, Sendmail, PHP mail()

  Natively, MailPress support SMTP connections to your mail server, however you can switch to Sendmail Connection_sendmail or native php mail() Connection_phpmail.

Final notes

• If you have any suggestions, ideas, comments, or if you (gasp!) found a bug, join the MailPress community in the MailPress google group.
• WordPress now has a robust plugin API that makes extending MailPress code easy. If you are a developer interested in utilizing this see the plugin documentation in the Codex. In most all cases you shouldn't modify any of the core code.

Share the Love

MailPress has no multi-million euro marketing campaign or celebrity sponsors, but do have something even better—you. If you enjoy MailPress please consider telling a friend, setting it up for someone less knowledgable than yourself, or writing a post on MailPress.