MailHive and MailBeez and their respective installations have been successfully tested with Zen Cart v1.3.8 and v1.3.9f-h, running on PHP 5.2.11

Zen Cart Installation Requirements

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

  • Zen Cart v1.3.8 – 1.3.9h 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.

Short Installation

  1. download the quickstart package and unzip it
  2. navigate to the /catalog/ directory
  3. copy the content into your store-root, but be careful to match your own admin directory:
    the structure should look like this on your server:
    /zencart-shop/zencart-admin-dir/mailbeez.php
    /zencart-shop/mailhive/
    /zencart-shop/mailhive.php
  4. upload the zencart specific hooks located in extras_zencart/zencart_1.3.x so it looks like this on your server (you find a readme.txt with more information):
    /zencart-shop/zencart-admin-dir/includes/*
    /zencart-shop/includes/*
  5. now you should find a new entry “mailbeez” in your “tools” menue

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.3.x > 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
  1. Using your FTP program, upload the contents of the zencart_1.3.x folder to your store’s root directory. Do not upload the zencart_1.3.x 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:
  1. MailBeez has now been installed into your database and the MailBeez dashboard is now visible:
  1. In the MailBeez dashboard, navigate to the MailBeez Modules tab:
  1. Select the module(s) you wish to install – for example, Birthday Greetings – and click the “install” button:
  1. This completes your MailBeez installation!

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

When you’re ready to customize your email templates, have a look at our tutorials: Customizing MailBeez Free Email Templates and Customizing MailBeez Premium Email Templates

Adoption of Zen-Cart

Quick Solution: configure a SMTP Email Server in MailBeez > Configuration > Email Engine. This will bypass the zencart email function and give MailBeez full control for sending emails

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:

  1. Using your FTP program, download includes/functions/functions_email.php from your server to your local drive (i.e. your computer)
  2. Using a text editing program such as Notepad or Notepad++, find this line of code:
$email_html = zen_build_html_email_from_template($module, $block);
  1. 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.

    No Twitter Messages.
s2Member®