EZMM -EZ Mass Mailer

Getting Started with the EZMM Open Source Edition

This guide is intended to help you get up and running with the Open Source Edition of EZMM.

Basic Information

EZMM (Ezmassmailer.com) PHP mass mailer is a compact and easy to use server-based mass mailer and newsletter campaign management software. It is specifically designed for mass mailing. Full double-opt in functionality ensures your emails will reach their intended destination! It is essentially a PHP script that runs in a web server environment.

Try Out The Online Demo!

If you would like to play around with EZMM or you are evaluating EZMM, please take the time to try out the demo at (...demo site location here...)

Preparing for Installation

Getting started with EZMM is easy to do. All you need is a Web server with PHP and MySQL. make sure your system satisfies the basic prerequisites specified in the Technical Requirements section below. Then download a copy of EZMM. Once you have downloaded a copy of the latest EZMM package you can actually install the script.

Minimum System And Software Requirements

Requirements for EZMM Installation:

• PHP 5.2 - Installation instructions

• MySQL 5.1 - Installation instructions

• Apache 2.2 - Installation instructions

• Microsoft URL Rewrite Module - Required for SEO URLs only. For more information, click here. For information about using ISAPI, click here.

• FastCGI - Download for IIS6. Download for IIS7.
  

Configuration Options

If installing on a local computer, there are a number of packages that will help you get set up quicker than individual installations:

• LAMP (Linux) - Most Linux distributions come with a pre-configured LAMP server.

• WAMP (Windows) - For more information, visit http://www.wampserver.com

• MAMP (Macintosh) - For more information, visit http://www.mamp.info

• XAMPP (Multi-platform) - Not for live sites. For more information, visit http://www.apachefriends.org/en/xampp.html

PHP Mail Configuration

In to the minimum software and hardware requirements mentioned in the sections above be aware of the following requirements for PHP mail functionality:

1. For the Mail functions to be available, PHP must have access to the sendmail binary on your system during compile time. If you use another mail program, such as qmail or postfix, be sure to use the appropriate sendmail wrappers that come with them. PHP will first look for sendmail in your PATH, and then in the following: /usr/bin:/usr/sbin:/usr/etc:/etc:/usr/ucblib:/usr/lib. It's highly recommended to have sendmail available from your PATH. Also, the user that compiled PHP must have permission to access the sendmail binary.
2. The sendmail binary requirement only applies to Unix-like platforms (e.g. Linux). In Windows you need to specify a mail server that accepts mail through a network connection. Find these lines in your php.ini file:

[mail function]
; For Win32 only.
SMTP = localhost
smtp_port = 25
; For Win32 only. ;sendmail_from = This e-mail address is being protected from spambots. You need JavaScript enabled to view it

And modify them accordingly.

Download The EZMM Open Source Edition Package

Obtain Most Recent Developer Build Through SVN

Warning!: This is not recommended for novice and/or normal Users. It is a code Development tool and has the complexities to match! It should not be used for live sites. SVN gives you the absolute latest download at the precise moment you request it. But that could theoretically be at the point that someone is uploading files for example! If you are looking to develop EZMM Extensions, learn the ins-and-outs of precisely how EZMM is put together, or are working on a particular project that demands the absolute latest version of EZMM, and for those helping test EZMM to assist with the development and Quality and Testing process then we recommend using Subversion (SVN). You will find full details of the setting up of your local repository and access to the SVN downloads on the Developer Site and accordingly we shall not repeat them here.

Installation Instructions

1. Extract the sentire contents of the downloaded archive file to the root directory of your web site.
2. Prepare the MySQL database: You will first need to create a MySQL database for use as the back-end storage for EZMM. Create a new database. Make sure that the database is configured with the UTF-8 MySQL collation and that any changes you make to files is also saved as UTF-8 No BOM encoding. Take note of the host name for your database, the name of the database and also the username and password of a user that has full permissions for the database.
3. Run the database setup script: Now run the Database_Setup.sql database set up script found in the "database" folder of the downloaded EZMM package in the database you created in step 2. This will create the required tables for the EZMM application.
4. Edit the main config file to match your database settings: First of all get into "common" folder and open "config.php" and make changes to reflect your current database configuration.
5. You are now ready to go! Simply navigate the the index.php page in your web browser.