New to MailBeez? Start learning the basics


13 minutes, 5 seconds

Answers to frequently asked questions

General issues

The quick answer is as often as you want. In practice, a typical installation would run at least once daily through a cronjob activation. If you do want to trigger Mailbeez more regularly, there is no risk of sending the same email twice due to the MailBeez tracking feature.

No, each email will be sent exactly once to each customer matching the criteria. Email campaigns are tracked in the table ‘mailbeez_tracking’, controlled within the MailBeez framework, not in an individual module’s code.

Issue: All popups only show the loading indicator – they seem never to finish.

Solution 1: store configuration

make sure you admin configuration (located in /includes/configuration.php) value for HTTP_CATALOG_SERVER is using the same URL (incl. http:// and https://) as HTTP_SERVER

Solution 2: Server configuration

Check with your Server Admin if the configuration value X-Frame-Options is set to e.g. SAMEORIGIN, this tells browsers not to show the loaded content in an iframe. read more on


Technically the popup is an iframe. The webserver can be configured to tell browsers to show a page only in iframes, when the origins (first part of the URL, incl. http or https) are the same. In the the admin site is using https but the catalog site is configured without https the origin is not the same.

From the apache documentation:

"The X-Frame-Options HTTP response header can be used to indicate whether or not a browser should be allowed to render a page in a frame or iframe. Sites can use this to avoid clickjacking attacks, by ensuring that their content is not embedded into other sites."

With sending high volume of Emails the risk of getting black-listes is increasing due to numerous reasons. We recommend to configure certified email sending service in the Email Engine Configuration.

MailBeez is installed on your server, and operated from within your store’s admin area, and as such, does not export any data to us, or indeed any 3rd party. In short, you keep your customer’s data in your system so there are no data protection issues.

Have a cup of tea and relax. Ahh, that’s better. Now, if for any reason your automatic installation fails, please remove the MailBeez configuration with this SQL statement:

DELETE FROM configuration WHERE configuration_key LIKE ‘MAILBEEZ_%’;

(in Zen Cart you might need to add your DBPREFIX to the tablename configuration.)

Now you should see the initial install-button and can start from new.

When you insert a Stylesheet section in your templates these will break: Since the curly brakets  {…} are also used by the template system, you need to surround these with literal-tags like this:

     {  CSS... }

That tells the template system to ignore the lines in between

Your security token must only contain characters and numbers.

On Servers with Suhosin following settings can cause blank popups when previewing the templates:


MailBeez requires to use eval and gzinflate.

Also check your apache configuration: A configuration entry like Header set X-Frame-Options: 'sameorigin' can cause the browser not to show iframe contents from different domains (e.g. if your admin page is using a different domain name then your store)

You have a SEO add-on installed which is attempting to rewrite the URLs of the MailBeez system.


You need to add:


as exclusions to avoid rewriting these URLs.

You have a Security solution installed (e.g. osc_sec) which does not allow certain URL parameters, for example: ../.


You need to configure / adopt this solution to allow these parameters for /mailbeez.php page requests.

Almost all pop-ups call mailhive.php located in the store-root.


Please check your configuration located in includes/configure.php. The value for the constant DIR_FS_CATALOG must end with /, e.g. like define(‘DIR_FS_CATALOG’, ‘/home/yourshop/public_html/’);

Check if you have entered VALID email addresses for the “Copy To” and “Send Simulation to” fields.

Please check your “send copy to” and “send simulation to” email address. An invalid email address can stop the sending process.

This will very likely also happen with your order confirmation emails as well, and the reason that it does happen is not related to MailBeez. We would recommend to check the linefeed settings of your email system (usually found in your general store admin area – not MailBeez). See if a change to “LF” helps.

When your MailBeez is not sending any Emails at all, please check the email addresses you entered for “sent copy to” and “send simulation to”, you find both in MailBeez > Configuration.

Both email addresses must be valid – invalid email address can stop the sending of more emails

When campaigns just won’t start sending, the number of emails to generate might exhaust you servers memory. Please try to reduce the number of recipients by choosing a shorter time-frame in the module’s configuration.

Issues related to certificates

The domain you entered during the ordering process does not match with your server domain. Please to go Mailbeez > tab “about” and find the exact server domain in the red box and contact us to request a valid certificate

Make sure the cronjob calls mailhive using http, e.g.

wget[token]=run > /dev/null


lynx -dump[token]=run

Please request a free test certificate, making sure to provide us with the exact URL of the test server. Please to go Mailbeez > tab “about” and find the exact server domain in the red box.

You have a modification in your admin system which limits characters for configuration settings.

Solution: Remove the “maxlength=”110″ modification from function_draw_input_field() defined in “/includes/functions/html_output.php”

Issues related to osCommerce

It is very likely that you are using FWR Security, and if this is the case, please add catalog/mailhive.php as an exception and allow “/” in the URL.

Find the addon at, and in the documentation find the section called “Excluding Certain Files from Cleansing”. Follow the instructions and add mailhive.php like this:

// If you need to exclude a file from cleansing then you can add it like below  

Background: the Advanced modules use “/” in their URL, which is a valid character, but cleansed by FWR Security.

Please take a look at this thread for more information:

Issues related to Zen Cart

When clicking on a link in an email sent by MailBeez (clicktracker active) following error appears:

PHP Fatal error: Class 'email' not found in (…)/mailhive/common/classes/oscommerce/emailMB.php on line 14


Remove the file


This file was included in one of the first 2.7 packages and is actually a bug so it MUST not be there.

Instead add the clicktracker code to /includes/application_top.php as described in MailBeez

Since MailBeez v2.7 the option “Override Zencart Email Template System” seems not to work anymore: The Email content generated by MailBeez is shown inside the Zencart Email Template.

There are several ways to solve this:

1. Create your own template

create a template file


which you only fill with the variable:


2. Configure an SMTP Server

Alternatively, you can configure MailBeez to send email through an SMTP server rather then using Zen Carts email function.

go to mailbeez > configuration > email system, switch to “SMTP” and configure a SMTP server – this will bypass the Zen Cart email function.

3. Adapt the Zen Cart code:

To make Zen Cart compatible with MailBeez v2.7, you can perform a minor code change as described here:

Zen Cart checks if the mailcontent starts with a valid html tag. With MailBeez v2.7 the htmlemailboilerplate template is introduced, which improves the visual presentation of the emails in different email clients. NOTE: This template does not start with a html tag.

The code change checks if the template does CONTAIN a valid html tag, which is a much more flexible approach.

In MailBeez > configuration > email engine you need to switch to SMTP and configure an SMTP server of your choice. Then MailBeez is having 100% control on the email content sent out.

Quick Solution: configure an SMTP Email Server or sending through Newsletter2Go in MailBeez > Configuration > Email Engine. This will bypass the Zen Cart email function and give MailBeez full control for sending emails.

2. Adapt the Zen Cart code:

To make Zen Cart compatible with MailBeez, you can perform a minor code change as described here:

Zen Cart ignores part of the starting html tag in custom templates causing this error. This code change tells ZenCart to check if the template does CONTAIN a valid html tag.

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.

Mailbeez on Zen Cart relies on the Zen Cart mail engine which queries each email address to find out which format the recipient prefers (reverse look-up). If you think all emails are sent in TXT you probably have been testing MailBeez with an email address w/o an account in your Zen Cart installation.

If your Zen Cart is configured to send HTML emails, you need to set up a customer account with your CC-email / send-copy-to email and configure this account to receive emails in HTML format.

When using this email address for testing / CC you should now receive the HTML version.

Here’s a handy tutorial on how to configure Zen Cart to be able to send emails as HTML:

If you want to force Zen Cart to always send emails in HTML format, you can override the format detection with following changes:



if ($customers_email_format == '' && ADMIN_EXTRA_EMAIL_FORMAT == 'HTML' && in_array($module, array('newsletters', 'product_notification')) && isset($_SESSION['admin_id'])) {
       $customers_email_format = 'HTML';

insert afterwards

$customers_email_format = 'HTML';

that overrides the format to “always HTML”

When you choose not to override Zen Cart’s email template system, the body content of the MailBeez modules will be merged into Zen Cart’s default email template, located in:


and there you can remove the subject line.

If you want to use MailBeez' Welcome email module to send Welcome emails to your customers instead of Zen Cart's Welcome emails, you can turn off the Zen Cart fuction in two ways.

Solution 1: Modify the code


/includes/modules/create_account.php around line 245

find line after // send welcome email

and comment it out so it looks like:

// if (trim(EMAIL_SUBJECT) != 'n/a’)…

Solution 2: Use extra_configures:

The email has the module name ‘welcome’, according to the comment in includes/functions/functions_email.php

// (The EMAIL_MODULES_TO_SKIP constant can be defined in a new file in the "extra_configures" folder)
if (defined('EMAIL_MODULES_TO_SKIP') && in_array($module,explode(",",constant('EMAIL_MODULES_TO_SKIP')))) return false;

this email can be skipped by creating a new file


then adding the following content:

define(‘EMAIL_MODULES_TO_SKIP’, ‘welcome’);

Something goes wrong, but Zen Cart doesn’t show the PHP errors.

Have a look in your “/cache” directory for files starting with “myDebug…”, these files contain the PHP error Messages.

A typical reason is you inserted a Stylesheet section in your templates, since the curly brakets  {…} are also used by the template system, you need to surround these with “literal”-tags like this:

     {  CSS... }

Found errors? Think you can improve this documentation?   edit this page