#
Version 5.2.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 3.3 or higher.

MailPress 5.2.1 is using swiftmailer 4.1.4.

# Installation

1. Make sure you have already installed WordPress 3.3 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 !

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.