Version 3.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

Installation

1. Make sure you have already installed WordPress 2.7 or above.
2. Unzip the MailPress package in an empty directory.
3. Inside mailpress folder, you will find some addons. Make your choice to scale MailPress to your needs.
4. For each selected addon (WordPress plugins interacting with MailPress) :
   • Copy the zip file in the newly created directory.
   • Unzip the package.
5. Upload every unzipped folders in wp-content/plugins.
6. Make sure that the wp-content/plugins/mailpress/tmp folder is writable.
7. Log in to your WordPress admin and point your browser to "Plugins > installed" page.
8. Activate MailPress plugin first, then activate MailPress addons.
9. Point your browser to "Settings > MailPress", fill and save the settings for each tab.
10. Once everything is installed, use the Test tab in "Settings > MailPress" to validate your settings.

Upgrading

Before you upgrade anything, make sure you have backup copies of any files you may have modified such as your MailPress theme.

Upgrading from any previous MailPress to 3.0.x:

1. Repeat the installation process as described above (step 1 to 4).
2. Upload the new files.
3. Point your browser to Plugins > installed page
4. Deactivate/Activate MailPress plugin
5. Deactivate/Activate all MailPress addons
6. You wanted more, perhaps? That's it!

Template Changes

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

Note : MailPress 3.0 is introducing three new features in MailPress themes and templates management :

1. New theme folder optional file 'default.php' : MailPress tries to insert the template called in the current theme, then the optional 'default.php' file from the current theme folder, then default code applies.
2. New theme folder optional folder 'plaintext'. This folder may content some plaintext templates. For plaintext mail part : MailPress tries to insert the template called from the optional 'plaintext' theme folder (if any), then the template from the 'plaintext' theme folder, then default code applies.
3. A new function to call in your templates like this : echo $this->the_content('html' or 'plaintext'); : (see default.php samples in default MailPress theme folder).

Online 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 page

This is where you'll find the latest updates and news related to MailPress. Bookmark and check often.

MailPress google group

The MailPress google group. See the Welcome page.

System Recommendations

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

MailPress is using swiftmailer. If you would like to support MailPress, please consider donating.

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 mailpress_import api and addon.
You have developped your own importer and you think it can be useful to the MailPress community, let us know.

Synchronize with WordPress

You want to synchronize MailPress with your WordPress registered users, mailpress_sync_wordpress_user addon is made for you.

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) : mailpress_mailing_lists.

User Roles

WordPress has eliminated user levels in order to make way for the much more flexible roles system introduced in WordPress 2.0. You can read more about Roles and Capabilities on the Codex. If you need to set Capabilities in MailPress, use the mailpress_roles_and_capabilities addon.

Batch mode

Your website becomes more and more successfull, you have now plenty of subscribers, processing a large number of recipients becomes an issue ! , use the mailpress_batch_send addon.

SMTP, Sendmail, PHP mail()

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

Need more addons ?

• for MailPress mail pages :
  • mailpress_deregister_scripts
  • mailpress_extra_form_mail_new,
  • mailpress_mail_custom_fields,
  • mailpress_upload_media,
  • mailpress_tracking
• for MailPress user pages :
  • mailpress_bulk_import,
  • mailpress_user_custom_fields,
  • bonus add-on available at http://www.mailpress.org !!!
• miscellaneous :
  • mailpress_autoresponder,
  • mailpress_filter_img,
  • mailpress_newsletter_categories,
  • mailpress_reset

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.