NEW: Tutorial: Guide to Getting Started
Support Forums
Please use the Official MailBeez Support Forum on forums.oscommerce.com
All Platforms
http://forums.oscommerce.com/topic/359282-automatic-trigger-email-campaigns-with-mailbeez-modules/
Zen-Cart
sunflowertami started a Thread on Zen-Cart.com as well:
http://www.zen-cart.com/forum/showthread.php?t=158085
CRE Loaded
http://creloaded.org/forum/39/29643.html
Deutsche Supportforen:
Deutschsprachigen Support gibt es in folgenden foren:
xtc-modified.org (xt:commerce, Gambio GX)
MailBeez - Automatische Aftersales Kundenpflege http://www.xtc-modified.org/forum/topic.php?id=8525
OsCommerce.de
Frequently Asked Questions F.A.Q.
General
General
Will customers receive the same email several times?
No, each iteration 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.
How often can I run MailBeez?
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.
Could my store’s server get black listed by emailing with MailBeez?
In our experience (24+ months sending over 50.000+ emails), the answer is no.
MailBeez only sends to your registered customers – they will very likely not mark the emails as spam
Is MailBeez compliant with data protection policies?
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.
My installation failed â what can I do?
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:
[sql]DELETE FROM configuration WHERE configuration_key LIKE âMAILBEEZ_%â;[/sql]
(in ZenCart you might need to add your DBPREFIX to the tablename âconfigurationâ.)
Now you should see the initial install-button and can start from new.
Stylesheet definition breaks my template
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:
{literal} <stylesheet>{Â CSS... }</stylesheet>{/literal}
That tells the template system to ignore the lines in between
All popups for advanced modules are blank!
It is very likely that you have Suhosin (http://www.hardened-php.net/) installed on your server.
Please create a file e.g. âfix.phpâ in
mailhive/common/local/fix.php
with this content:
<?php $_GET["module"] = $_REQUEST["module"]; ?>
Background: the Advanced modules use â/â in their URL, which is a valid character, but obviously not accepted by Suhosin
All popups are blank!
Your security token must only contain characters and numbers.
On Servers with Suhosin following settings can cause blank popups when previewing the templates:
suhosin.executor.disable_eval
suhosin.executor.eval.blacklist
MailBeez requires to use eval and gzinflate.
I get a 404 â what can I do?
You have a SEO add-on installed which is attempting to rewrite the URLs of the MailBeez system.
Solution: You need to add:
mailhive.php
admin/mailbeez.php
as exclusions to avoid rewriting these URLs.
I get a 403 â what can I do?
You have a Security solution installed (e.g. osc_sec) which does not allow certain URL parameters, for example: â../â.
Solution: You need to configure / adopt this solution to allow these parameters for/mailbeez.php page requests.
I get a 500 in every pop-up â what can I do?
Almost all pop-ups call mailhive.php located in the store-root.
Solution: 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/â);
I canât send test emails
Check if you have entered VALID email addresses for the âCopy Toâ and âSend Simulation toâ fields.
MailBeez sends only one email
Please check your âsend copy toâ and âsend simulation toâ email address. An invalid email address can stop the sending process.
Some recipients receive html code instead of html emails
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.
No Emails are sent
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
Can’t send a campaign – the window shows only “MailBeez – Mode: …”
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.
Certificates
Certificates
The certificate I got does not activate the module!
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
I get a “invalid certificate” error when mailhive is called by a cronjob
Make sure the cronjob calls mailhive using http, e.g.
wget http://your-server.com/mailhive.php?[token]=run > /dev/null
or
lynx -dump http://your-server.com/mailhive.php?[token]=run
I have a test-system, but the certificate is not valid
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.
I canât enter a certificate for a premium module â the certificate is too long and the field does not allow that many characters
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â
osCommerce
osCommerce
I use OsCommerce and all popups for advanced modules are blank!
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 http://addons.oscommerce.com/info/5752, 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
$security_pro->addExclusion(‘mailhive.php’);
Background: the Advanced modules use â/â in their URL, which is a valid character, but cleansed by FWR Security.
I use OsCommerce with STS and all popups show my storefront
Please take a look at this thread for more information:
http://forums.oscommerce.com/topic/359282-automatic-trigger-email-campaigns-with-mailbeez-modules/page__st__140__p__1531162#entry1531162
Zen-Cart
Zen Cart
Zen Cart: since MailBeez V2.7 the MailBeez Emails are inserted into the Zen Cart Email Template
Since MailBeez V2.7 the option “Override Zencart Email Template System” seem not to work anymore: The Email content generated by MailBeez is shown inside the Zencart Email Template.
To make Zen Cart compatible with MailBeez V2.7 please perform a small change as you find on:
http://www.zen-cart.com/showthread.php?158085-Mailbeez-After-Sales-Modules&p=1170912#post1170912
Background:
zencart checks if the mailcontent starts with a html-tag. With MailBeez V2.7 the htmlemailboilerplate template is introduced, which improves the visual presentation of the emails in different email clients. This template does not start with a html-tag.
The code change checks if the template CONTAINS a html-tag, which is a much more flexible approach.
Zen Cart: All emails are sent in TXT, not HTML format. How can I change this?
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:
http://tutorials.zen-cart.com/index.php?article=113
If you want to force Zen Cart to always send emails in HTML format, you can override the format detection with following changes:
open:
includes/functions_email.php
find
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”
Zen Cart: The Subject Line is repeated in the body. How can I remove this?
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:
/email/email_template_default.htm
and there you can remove the subject line.
Can’t send a campaign – get an empty window
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:
{literal} <stylesheet>{Â CSS... }</stylesheet>{/literal}



