Zen Cart Installation Requirements

You will need the following to be able to install and run MailBeez:

• Zen Cart v1.5.0 installed and configured
• PHP 4 or higher, compatibility tested up to PHP 5.3.5
• FTP access to your Zen Cart installation
• An FTP program, such as FileZilla
• A text editing program, such as Notepad++ to customize your email templates, if desired

The installation is straightforward and can be done in a few minutes by following a few easy steps. No Zen Cart core or template files are modified by the MailBeez installation.

Step-by-Step Installation

To begin, please make sure you have the latest MailBeez package. If you are not sure that you have the latest release, please download the quickstart package using the link above.

Prepare & Upload the Fileset

1. Unzip the downloaded MailBeez package to your local drive (i.e. your computer)
2. In the MailBeez fileset, navigate to catalog > admin and rename the admin folder to match your store’s admin folder as it appears on your server (i.e. YOUR_ADMIN)
3. In the MailBeez fileset, navigate to extras_zencart > zencart_1.5.0 > admin and rename the admin folder to match your store’s admin folder as it appears on your server (i.e. YOUR_ADMIN)
4. Using your FTP program, upload the contents of the catalog folder to your store’s root directory. Do not upload the catalog folder itself. The contents to be uploaded to your store’s root directory are as follows:
   • mailhive.php file
   • re-named admin folder and its contents
   • mailhive folder and its contents
5. Using your FTP program, upload the contents of the zencart_1.5.0 folder to your store’s root directory. Do not upload the zencart_1.5.0 folder itself. The contents to be uploaded to your store’s root directory are as follows:
   • re-named admin folder and its contents
   • includes folder and its contents

Install MailBeez in the Admin

1. Log in to your store admin and navigate to Tools > MailBeez. Click the “Install” button:
   
   
2. MailBeez has now been installed into your database and the MailBeez dashboard is now visible:
   
   
3. In the MailBeez dashboard, navigate to the MailBeez Modules tab:
   
   
4. Select the module(s) you wish to install – for example, Birthday Greetings – and click the “install” button:
   
   
5. This completes your MailBeez installation!

Adoption of Zen-Cart

If would like MailBeez to use its own template system to generate MailBeez email (recommended), rather than integrating with and using Zen Cart’s email template system to generate MailBeez email (default), please do the following:

• Using your FTP program, download includes/functions/functions_email.php from your server to your local drive (i.e. your computer)
• Using a text editing program such as Notepad or Notepad++, and change it as described on:
• http://www.zen-cart.com/showthread.php?158085-Mailbeez-After-Sales-Modules&p=1170912#post1170912

This code change tells Zen Cart to check if the content contains a valid html tag, and if not, applies the Zen Cart template system.

Next Steps

Now that your MailBeez installation is complete, you are encouraged to visit our Guide to Getting Started to familiarize yourself with MailBeez features and functionality, and to learn how to configure and customize your MailBeez installation to suit your needs.

No thanks, just take me to the Quick Start Configuration tutorial
No thanks, just take me to the Comprehensive Configuration tutorial