Compatibility issues

Joomla Messaging System

AcyMailing uses the core Joomla messaging system to display messages on your website so if you don't see any message when you subscribe a user, that's probably because your Joomla template does not contain the tag to display Joomla messages: <jdoc:include type="message" />

Please edit the index.php file from your template and make sure the tag <jdoc:include type="message" /> is added to it. If not, please add it immediately before the tag <jdoc:include type="component" />

This tag should already be present in all templates.


By default the Boostrap CSS file applies a style to all elements with .modal class. Unfortunately the default Joomla modal system uses that class as well (for links only). Due to this conflict, you may see some floating elements in the middle of your page... You can apply one of these two solutions: 1/ (the best one) Edit the boostrap css file including in your Joomla template and replace .modal{ by div.modal{ so this style will only be applied to div elements. 2/ (the easiest one) Edit the AcyMailing CSS component file via the AcyMailing back-end and add this code at the end of the file:

/*Avoid bootstrap issue with .modal*/a.modal{position:static !important;margin:0 !important;width:auto !important;display:inline !important}

AcyMailing plugin: trigger Joomla content plugins

Our AcyMailing plugin called "trigger Joomla content plugins" will trigger all other plugins created which are supposed to have actions on your Joomla articles.

Most of them will work just perfectly and so you can use their features in your Newsletter content as well.

But they have not been developed to be triggered from the back-end or for a Newsletter... so some of them will just break your Newsletter and that's why our plugin is not enabled by default.

No problem, just unpublish it if you have some issue and you will be fine!

Here is an example of the preview screen broken by a Joomla content plugin (not sure which one...):

Preview issue

Another example with the "Droppics - content" plugin: in the preview screen of the newsletter, the radio buttons will not work and the popup windows will stay empty.

1064: SQL error when clicking on the readmore or article link

This error generally occurs when your Front-end template or a system module/plugin does not handle non-SEF URLs...

The error message is generally "1064 - You have an error in your SQL syntax: check......near ':ARTICLE_ALIAS' at line 1...."

  • You may remove the article and category's aliases from the link and try to access it again to make sure it is your template (...com_content&view=article&id=524:article-alias&catid=228:category-alias...).

  • If no error appears when accessing the link without the aliases, that means it is your Front-end template or a system module/plugin, if you can, temporary change your template to see if you still get the issue.

  • If the issue disappears when changing your template contact your template's creator and tell him that it does not handle non-SEF URLs as the "id" parameter is not only a number, he will fix it and provide you with a new version

  • If the issue appears regardless the used template, you should try to disable one by one your Front modules / system plugins to locate the one responsible of this issue.

  • If you can't find what element is causing this issue, post a new topic on our forum and sum up the tests you made so far

The form could not be submitted ReferenceError: submitacymailingform is not defined

This option may occur when you submit the AcyMailing subscription form if the AcyMailing javascript file can't be loaded...

  • Please make sure the file can be loaded via your browser... if not, you should make sure your server allows this file to be loaded.

  • If you included the AcyMailing subscription module inside an article or another part of your website using the "Modules Anywhere" plugin, please access the AcyMailing module configuration and set the option Include JS files to On the module itself (this option is within the "advanced" tab)

  • The fwSiteOptimizer plugin could apparently cause this issue, you may want to unpublish this plugin.

The anticopy plugin (version 1.8.1 or previous versions) will prevent popup from being displayed properly. The popup will appear for a few second and then will be displayed as a new full windows.

TinyMCE 3.2.4

With an old version of TinyMCE, the editor may not be loaded when you edit your Newsletter.

You can either change the editor you use via the AcyMailing configuration page (tab "interface") or update TinyMCE to the latest version (by updating Joomla for example).

JoomFish 2.1.5 -> 2.1.7: 500 - No valid database connection

There is a bug in a recent JoomFish release (in 2.1.5 and 2.1.6) which breaks the nested queries and causes this kind of error message:

JoomFish issue no valid database connection

This bug does not only concern AcyMailing but many other components and the JoomFish forum already wrote a workaround (use mysqli instead of mysql in "Site -> Global Configurations -> Server") but a real fix has been submitted on their forum and implemented in JoomFish 2.1.7, the solution is to update JoomFish.

GuardXT : Warning: include_once(.../administrator/components/com_acymailing/helpers/mailer.php) [function.include-once]: failed to open stream: No such file or directory

GuardXT may rename the mailer.php file into mailer.php_guardxt which will break AcyMailing.

You should connect via FTP to your website and rename the file administrator/components/com_acymailing/helpers/mailer.php_guardxt into mailer.php

The online version is not displayed properly on your website

AcyMailing includes the online version of your Newsletter in an iframe and set automatically its height to make the iframe' structure invisible. This process may not work properly if you did mistakes in your Newsletter such as:

  • You included a style="position:absolute" on one of your elements within the Newsletter

  • You included a style="height:100%" on one of your elements within the Newsletter

Front-end edition : the Yes/No buttons and the tabulation system are not working

We use the standard Joomla tabulation system, if it's not displayed properly on your website on the front-end, please make sure your Joomla template defines it, the default CSS is:

.nav-tabs:before,.nav-tabs:after {    display: table;    content: "";    line-height: 0;}.nav-tabs:after {    clear: both;}.nav-tabs > li {    float: left;}.nav-tabs > li:before {    content: none !important;}.nav-tabs > li > a {    padding-right: 12px;    padding-left: 12px;    margin-right: 2px;    line-height: 14px;}.nav-tabs {    border-bottom: 1px solid #ddd;}.nav-tabs > li {    margin-bottom: -1px;}.nav-tabs > li > a {    padding-top: 8px;    padding-bottom: 8px;    line-height: 18px;    border: 1px solid transparent;    -webkit-border-radius: 4px 4px 0 0;    -moz-border-radius: 4px 4px 0 0;    border-radius: 4px 4px 0 0;}.nav-tabs > li > a:hover,.nav-tabs > li > a:focus {    border-color: #eee #eee #ddd;}.nav-tabs > .active > a,.nav-tabs > .active > a:hover,.nav-tabs > .active > a:focus {    color: #555;    background-color: #fff;    border: 1px solid #ddd;    border-bottom-color: transparent;    cursor: default;}.tab-content > .tab-pane{    display: none;}.tab-content > .active {    display: block;}

If the Yes/No buttons are not working properly, please make sure your Joomla template defines the style applied to the bootstrap buttons, the default one is:

/* CSS for pretty radio buttons (bootstrap) */.btn-group {    position: relative;    display: inline-block;    *display: inline;    *zoom: 1;    font-size: 0;    vertical-align: middle;    white-space: nowrap;    *margin-left: .3em;}.btn-group:first-child {    *margin-left: 0;}.btn-group + .btn-group {    margin-left: 5px;}.btn-group > .btn {    position: relative;    -webkit-border-radius: 0;    -moz-border-radius: 0;    border-radius: 0;}.btn-group > .btn + .btn {    margin-left: -1px;}.btn-group > .btn,.btn-group > .dropdown-menu,.btn-group > .popover {    font-size: 13px;}.btn-group > .btn:first-child {    margin-left: 0;    -webkit-border-top-left-radius: 4px;    -moz-border-radius-topleft: 4px;    border-top-left-radius: 4px;    -webkit-border-bottom-left-radius: 4px;    -moz-border-radius-bottomleft: 4px;    border-bottom-left-radius: 4px;}.btn-group > .btn:last-child,.btn-group > .dropdown-toggle {    -webkit-border-top-right-radius: 4px;    -moz-border-radius-topright: 4px;    border-top-right-radius: 4px;    -webkit-border-bottom-right-radius: 4px;    -moz-border-radius-bottomright: 4px;    border-bottom-right-radius: 4px;}.btn-group > .btn:hover,.btn-group > .btn:focus,.btn-group > .btn:active,.btn-group > {    z-index: 2;}.btn {    display: inline-block;    *display: inline;    *zoom: 1;    padding: 4px 12px;    margin-bottom: 0;    font-size: 13px;    line-height: 18px;    text-align: center;    vertical-align: middle;    cursor: pointer;    color: #333;    text-shadow: 0 1px 1px rgba(255,255,255,0.75);    background-color: #f5f5f5;    background-image: -moz-linear-gradient(top,#fff,#e6e6e6);    background-image: -webkit-gradient(linear,0 0,0 100%,from(#fff),to(#e6e6e6));    background-image: -webkit-linear-gradient(top,#fff,#e6e6e6);    background-image: -o-linear-gradient(top,#fff,#e6e6e6);    background-image: linear-gradient(to bottom,#fff,#e6e6e6);    background-repeat: repeat-x;    filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffffff', endColorstr='#ffe5e5e5', GradientType=0);    border-color: #e6e6e6 #e6e6e6 #bfbfbf;    *background-color: #e6e6e6;    filter: progid:DXImageTransform.Microsoft.gradient(enabled = false);    border: 1px solid #bbb;    *border: 0;    border-bottom-color: #a2a2a2;    -webkit-border-radius: 4px;    -moz-border-radius: 4px;    border-radius: 4px;    *margin-left: .3em;    -webkit-box-shadow: inset 0 1px 0 rgba(255,255,255,.2), 0 1px 2px rgba(0,0,0,.05);    -moz-box-shadow: inset 0 1px 0 rgba(255,255,255,.2), 0 1px 2px rgba(0,0,0,.05);    box-shadow: inset 0 1px 0 rgba(255,255,255,.2), 0 1px 2px rgba(0,0,0,.05);}.btn:hover,.btn:focus,.btn:active,,.btn.disabled,.btn[disabled] {    color: #333;    background-color: #e6e6e6;    *background-color: #d9d9d9;}.btn:active, {    background-color: #cccccc \9;}.btn:first-child {    *margin-left: 0;}.btn:hover,.btn:focus {    color: #333;    text-decoration: none;    background-position: 0 -15px;    -webkit-transition: background-position .1s linear;    -moz-transition: background-position .1s linear;    -o-transition: background-position .1s linear;    transition: background-position .1s linear;}.btn:focus {    outline: thin dotted #333;    outline: 5px auto -webkit-focus-ring-color;    outline-offset: -2px;},.btn:active {    background-image: none;    outline: 0;    -webkit-box-shadow: inset 0 2px 4px rgba(0,0,0,.15), 0 1px 2px rgba(0,0,0,.05);    -moz-box-shadow: inset 0 2px 4px rgba(0,0,0,.15), 0 1px 2px rgba(0,0,0,.05);    box-shadow: inset 0 2px 4px rgba(0,0,0,.15), 0 1px 2px rgba(0,0,0,.05);},,,,, {    color: rgba(255,255,255,0.75);}.btn-success {    color: #fff;    text-shadow: 0 -1px 0 rgba(0,0,0,0.25);    background-color: #5bb75b;    background-image: -moz-linear-gradient(top,#62c462,#51a351);    background-image: -webkit-gradient(linear,0 0,0 100%,from(#62c462),to(#51a351));    background-image: -webkit-linear-gradient(top,#62c462,#51a351);    background-image: -o-linear-gradient(top,#62c462,#51a351);    background-image: linear-gradient(to bottom,#62c462,#51a351);    background-repeat: repeat-x;    filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff62c462', endColorstr='#ff51a351', GradientType=0);    border-color: #51a351 #51a351 #387038;    *background-color: #51a351;    filter: progid:DXImageTransform.Microsoft.gradient(enabled = false);}.btn-success:hover,.btn-success:focus,.btn-success:active,,.btn-success.disabled,.btn-success[disabled] {    color: #fff;    background-color: #51a351;    *background-color: #499249;}.btn-danger {    color: #fff;    text-shadow: 0 -1px 0 rgba(0,0,0,0.25);    background-color: #da4f49;    background-image: -moz-linear-gradient(top,#ee5f5b,#bd362f);    background-image: -webkit-gradient(linear,0 0,0 100%,from(#ee5f5b),to(#bd362f));    background-image: -webkit-linear-gradient(top,#ee5f5b,#bd362f);    background-image: -o-linear-gradient(top,#ee5f5b,#bd362f);    background-image: linear-gradient(to bottom,#ee5f5b,#bd362f);    background-repeat: repeat-x;    filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffee5f5b', endColorstr='#ffbd362f', GradientType=0);    border-color: #bd362f #bd362f #802420;    *background-color: #bd362f;    filter: progid:DXImageTransform.Microsoft.gradient(enabled = false);}.btn-danger:hover,.btn-danger:focus,.btn-danger:active,,.btn-danger.disabled,.btn-danger[disabled] {    color: #fff;    background-color: #bd362f;    *background-color: #a9302a;}.btn-danger:active, {    background-color: #942a25 \9;}.btn-success:active, {    background-color: #408140 \9;}.radio.btn-group input[type=radio] {    display: none;}.radio.btn-group > label:first-of-type {    margin-left: 0;    -webkit-border-bottom-left-radius: 4px;    border-bottom-left-radius: 4px;    -webkit-border-top-left-radius: 4px;    border-top-left-radius: 4px;    -moz-border-radius-bottomleft: 4px;    -moz-border-radius-topleft: 4px;} {    padding-left: 0;}

Clean the AcyMailing tables

If you deleted some users directly via your database, you may have some lost entries on the AcyMailing tables and one effect is that it won't display the same number of subscribers on the list listing and on the user listing.

Please access the AcyMailing configuration page, tab "security" and click on the button "Check database integrity". AcyMailing will perform a few tests and clean these "lost entries".

Allow POST data redirection in htaccess file

If you have modified your .htaccess file and some form validations don't work any more, you should modify your rules to replace [L] flags by [P] flags.

If the tags inserted in the newsletter are modified and an asterisk is added inside such as this: {* subtag:...} It means that a plugin from another component is modifying the content of your page.

You should first try to disable the plugin "AcyMailing : trigger Joomla Content plugins". If it doesn't solve the issue, you should search which plugin is responsible for this.

Currently the plugins that have been found linked to this were "User - EasyBlog Users" or "System - JSN Power admin" or plugins from the following component: Mossets tree, No Number or an old version of Simple Image Gallery. We were not able to identify the right plugin for now... we're working on it to make sure this issue gets solved asap!

Unable to get the Squeeze page plugin work

If the squeeze box does not show up, that could come from the fact that the JavaScript isn't loaded. Please make sure you don't have the plugin "YT Framework" installed on your site, this plugin prevents Joomla from inserting the scripts (so ours too).

If you have this plugin, but need it for your Front-end template, please contact the YT Framework plugin's creator and ask him to fix the triggered function in this plugin.

JCE editor styling issue

If you use the JCE editor and it doesn't display the styles you created in the template edition, then you should go in the global configuration in the JCE administration and change the parameter "Compress CSS" to No.

My "Send", "Schedule", "ABTesting" and "Spam-test" buttons are not working

If when you click on these buttons and no popup is displayed, it could come from an issue when you updated Joomla to Joomla 3.4.1.

You should make sure the folder layouts / joomla / modal / is in your site's files, and if not, download the latest version of Joomla and copy this folder to your site.

Module not working when using the System - NoNumber modals plugin

If when you click on the module's button, an empty popup is displayed (or with only the text "Subscribe"), you can try to turn OFF the "ClassNames - Auto-Convert"option in the plugin's configuration and make sure you selected "Popup mode" in the module's configuration.

Birthday field always displayed in English

Some of our users noticed that the Joomla component Form Maker made the birthday field always display the month names in English. If you have this issue, update the Form Maker component.

Question marks ( ? ) appear when saving the newsletter

Using the Acyeditor, it can happen that some question marks appear on new lines when saving the newsletter. This is linked to a server configuration that do not have the right charset when loading JavaScript files.

The solution is either to change the configuration of your server to set UTF-8 as the default charset or to add a rule in your htaccess file so it will handle it. The rule for the htaccess would be:

The JCE editor isn't completely shown (only the preview is displayed)

The solution is to disable the RocketLoader on your Cloudflare account for the site experiencing the issue.

Last updated