Contact Enhanced Documentation

Why javascript validation or maps doesn't work?

{gdata title=|Missing screencast| app=|none|}

Contact Enhanced uses MooTools to validate the form, load the Maps and to perform effects and AJAX/JSON calls;

MooTools is the Joomla default javascript library, therefore most templates use MooTools for their fancy things such as menus and slideshows; Your template or other extensions (modules, plugins, components) shouldn't use another javascript library other than MooTools, however if it does use another library such as JQuery it might be incompatible with many MooTools based scripts; Some templates even remove MooTools calls from the output HTML, then no MooTools related scripts will work.

How to find out if your template is using jQuery:

  • You can right click on your browser's window and click on "View source" and check all <script> tags inside the <head> tag; or
  • Use a Firefox plugin called FireBug, to inspect the code.You can view all JS files inside the Net tab.

JQuery can be used with MooTools, as long as the developer follows JQuery guidelines. You might want to suggest this feature to the template's developer:

Some users have reported that using a Plugin called jQuery Easy has helped them to solve the problem.

Always choose extensions that are 100% compatible with Joomla Framework;
Avoid JQuery in Joomla based websites, this way you will avoid incompatibilities and will load less javascript, therefore your website will load faster.

Why do I get this error: Could not instantiate mail function?

{gdata title=|Missing screencast| app=|none|}

Well,this can happen due to following reasons;

  • PHP function mail() has been disabled or not working;
  • You are running an older version on PHP in your server;
  • The Sendmail Path is wrong (usually it is not the case, bacause it is typically filled in by Joomla! during the initial setup;
  • You are on a local environment and don't have a mail server installed.

Here are the steps to solve it:

  • Go to Admin panel > Global Configuration > Server > Mail Settings > Mailer  and select SENDMAIL there,instead of PHP MAIL FUNCTION.
  • If the above point doesn't solve your issue,then the best thing is to contact your webhost and ask them to rectify the PHP Mail Function in the PHP in their server and also ask them to upgrade the PHP to the latest version, OR better yet is to use SMTP instead of PHP Mail function or Sendmail.
  • You can also try to change the contact email address and remove the link to a user, for some reason this solves this issue sometimes;
  • Please read this other article: Why emails are not being sent?

Why emails are not being sent?

{gdata title=|Missing screencast| app=|none|}

Not receiving your mail? It is usually related to mail server misconfiguration or security rules; Here are a few common problems to check:

  1. Does your account have SPAM filters?
    If it does, check your junk mail folder (or trash, or whatever your particular program calls it.) It may have been received and filtered out. Fortunately most programs allow you to add it to a list of safe senders so it won't be filtered out in the future. If you set the mail settings to use SMTP usually solves this problem;
  2. Are you sending to a legal address?
    • a) Depending on how your host has things configured, sometimes you can't send a form mail to if your form is on You may need to setup an email that corresponds to the site you are sending from, or see if your host allows you to add your other email address as an allowed recipient. Since all hosts are different, the best thing you can do is contact them.
    • b) Special email sending requirements (e.g. the sender must be a valid email address in the website domain, whereas FormMail tries to make the email you receive look like it came From the person who filled out your form).
  3. Is the Menu configured correctly?
    • Sometimes Contact Enhanced might not work properly when you copy the menu or just change before creating a new one. Delete the menu item and create a new one from scratch  to make sure the menu is working properly;
  4. Have you been testing the "Custom reply" feature?
    • You might have set up the "Custom reply" parameter to Yes. Custom reply is to be used by advanced users in order to integrate with other systems; If you don't know what it is for, please make sure it is set to No.
  5. Do you need authentication?
    When you send email from your mail program or Joomla,  you need to provide a password for outgoing mail (outgoing mail authentication?). If you are unsure because you set up your mail a long time ago, the best thing to do is ask your host. This is usually required because most mail servers nowadays have implemented DMARC policy in order to help reduce the potential for email-based abuse. For more information please go to the DMARC website.

    Our extensions use Joomla framework and configuration to send emails and some mail servers will not work correctly with Sendmail or PHP Mailer because of the DMARC policy mentioned above. Therefore these servers require that unauthenticated emails must be sent from or to an email address, or do not allow unauthenticated emails. It seems to be your case, specially if only the copy message is sent.

    We always recommend to set the mailer to SMTP in the Joomla Global Configuration under the Server tab. This will avoid many mail problems, including your contact message be marked as SPAM.
    Go to Global Configuration and set these options below accordingly to your server. If you are unsure how to do it, please contact your web hosting provider and he will be able to give you this information:

    Mailer: SMTP Server
    SMTP Authentication:
    SMTP Security:
    SMTP Port:
    SMTP Username:
    SMTP Password:
    SMTP Host:
  6. On Rochen Servers:
    You can use Joomla default mailer configuration, but you might need to set "Email Sender" to Contact in Contact Enhanced's Options (button in the toolbar);
    If you are using a Reseller Plan. When creating new accounts, make sureto enable SPF or DKIM records under "Email Authentication".
  7. On Linux Servers if mail is hosted remotely:
    If your mail is hosted remotely from your server make sure the domain is located in etc/remotedomains instead of etc/localdomains otherwise make sure it is in etc/localdomains;

Do I have the wrong PHP version?

{gdata title=|Missing screencast| app=|none|}

Contact Enhanced requires PHP5 in order to work!

Please read the news published on the website:

On July 13, 2004, PHP 5 was released, powered by the new Zend Engine II. PHP 5 included new features such as improved support for object-oriented programming, the PHP Data Objects extension (which defines a lightweight and consistent interface for accessing databases), and numerous performance enhancements.The most recent update released by The PHP Group is for the older PHP version 4 code branch. As of August, 2008 this branch is up to version 4.4.9. PHP 4 is no longer under development nor will any security updates be released.

Therefore we advise you to update your php version.

In order to check which version you are using, please select

Joomla 1.5 Help System Info from the drop-down menu on the Back-end of your Joomla! installation, then you should see the PHP version under the PHP Information tab.

Jooma 1.6 Site  System Information from the drop-down menu on the Back-end of your Joomla! installation, then you should see the PHP version under the PHP Information tab.

Some Ajax/JSON related features also  require PHP 5.2 or newer.

How to turn off PHP Notices (Errors)

{gdata title=|Missing screencast| app=|none|}

If you have a component (extension) that for some reason does generate Notices, then you can safely turn off this in Joomla Configuration.

Notices are not real errors, they are merley informations for developer in order to help them either improve the performance or to avoid some bugs due to some unitialized variables. If there are notices in our extensions, please let us know. We will work to eliminate them!

There is no real need for a joomla running website to have notices turned on, but some hosings have this as a default.

To turn notices on, follow the following steps...

Read more: How to turn off PHP Notices (Errors)

How can I add a sent confirmation message?

As a strategy to enhance the User Experience 1 our Joomla extensions uses Joomla default messaging system. Most comercial and free Joomla templates have this capability. My template's message look like this:



Thank you for your e-mail.

If your template does not have this option, all you have to do is add a small piece of code to your template and a little css to your main css file (in case it does not have it).

Add the following code to your template where you want all system messages to be displayed, usually inside the same div that displays the content:

Read more: How can I add a sent confirmation message?

Optimize your PHP installation to handle large file uploads

{gdata title=|Missing screencast| app=|none|}

Though PHP presents a very versatile and user friendly interface for handling file uploads, the default installation is not geared for working with files in excess of 2 Mega Bytes. This article will help you configure your PHP engine for handling such large file transfers.

The php.ini File

All the configuration settings for your PHP installation are contained in the php.ini file. Sometimes these setting might be overridden by directives in apache .htaccess files or even with in the scripts themselves. However you cannot over ride some of the settings that effect file uploads with .htaccess directives in this way. So let's just concentrate on the ini file. If you do not have access to your PHP configuration file might have to contact your web hoosting service provider.

To find the location of your php.ini file and the current values for the following settings that we need to modify, please go to:

Joomla 1.5 - Select Help → System Info from the drop-down menu on the Back-end of your Joomla! installation, then select the PHP Information tab.

Joomla 1.6 - Select Site → Site information from the drop-down menu on the Back-end of your Joomla! installation, then select the PHP Information tab.


Read more: Optimize your PHP installation to handle large file uploads

Why do I get an error when trying to upload a file?

{gdata title=|Missing screencast| app=|none|}

This can be due two main reasons:

  1. The [Joomla]/tmp/ folder is unwritable; (most likely)
  2. The file size is bigger than your php memory usage limit;

Possible solutions:

Change the permitions of the [Joomla]/tmp/ folder:

  1. You can use an FTP client, a web file manager or change it via SSH;

Change the memory_limit:

  1. Locate the php.ini file used by your web server. You can use the phpinfo() PHP function to find it. You can find this info at  Help -> System Info from the drop-down menu on the Back-end of your Joomla! installation, under the PHP Innformation tab;
  2. Edit the memory_limit parameter in the php.ini file (usually in a section called Resource Limits). Example:
    memory_limit = 32M  ; #Maximum amount of memory a script may consume (32MB)
    If there is no section already for this, place the above line at the end of the file;
  3. Restart Apache.

Why the Form Fields' border are gone?

Contact Enhanced tries to inherit most of your template's styling, however some templates have HTML override for Joomla core components and/or style your core components differently. In these cases sometimes your custom field's borders will disappear. When this happens you will have to add the line below to the CE's CSS file:

If using Joomla 2.5 and newer, create a CSS Form Field type and add the CSS rule below:

.ce-container .inputbox{border:1px inset !important}

Translating the javascript Error Messages and tips


Translate Contact Enhanced Form Validation errors for Joomla 3.0 and newer is a very simple task, however it might be a bit more complicated for Joomla 2.5 users. Please continue reading...

Read more: Translating the javascript Error Messages and tips

Migrating Contact Enhanced from Joomla 1.5


Migrating Contact Enhanced from Joomla 1.5 to any newer version


If you are migrating from a Joomla 1.5 version you will need to proceed with a manual migration:

In order to achieve this you will need a little experience with PHPMyAdmin and SQL;

First of all you will need to create a full database backup, just for safety reasons, then perform these steps:

1. In PHPMyAdmin:
a) Select your Joomla 1.5 database, then select the "Export" option;
b) Select the tables below to export (#__ stands for the Joomla 1.5 database prefix for your installation, usually jos_):


c) Select the Format to SQL;
d) Export the selected tables;

2. In the exported SQL file or SQL content, find out which database prefix you used for the new installation, usually j25_ or some random characters, then replace your old Joomla 1.5 prefix for the the new one;
3. In PHPMyAdmin, select the database for the new version (if a different database), then run the query (with the changed prefix);
4. In the migrated site install Contact Enhanced 2.5 and it will perform all other migration tasks;

In this situation (manual upgrade), only the Categories will not be imported, so you will have to manually create them and re-configure Contacts and Custom Fields. You will be able to use the Batch features to re-configure, so it should not be a hard task.

Copyright © 2018 All Rights Reserved.

This site is not affiliated with or endorsed by the Joomla!™ Project. It is not supported or warranted by the Joomla!™ Project or Open Source Matters™. The Joomla!™ logo is used under a limited license granted by Open Source Matters™, the trademark holder in the United States and other countries.
We may collect your IP address and your browser's User Agent string while using our site for security reasons and deriving aggregate information (analytics). This information is retained for a minimum of 1 and a maximum of 24 months.