Ideal - Custom Software Development

Contact Enhanced Documentation
Print
These guidelines are intended as a work-in-progress and will continue to be informed by feedback from users and staff members. Ideas about and suggestions for improvement of the document can be forwarded using our forum and email form. Keep in mind that the screencasts here are to demonstrate a specific feature and may look different in your site, specially due to template styling. Some users have helped with screencasts, so if you made a screencast or a tutorial, you can post on the forum or send it to us by email.

Getting Started

  • Installation and basic features

    Getting Started
    install.mov
    install.movClick to watch
    2:38 minutes
    593 views
    Average: 0.00
    Votes: 0

    Most most users will be able to use the Automated Installation procedure:

    • Select Help → System Info from the drop-down menu on the Back-end of your Joomla! installation, then click on the Directory Permissions tab and make sure the all direcotries listed are writable.
    • Download the extension to your local machine as a zip or gz file package.
    • From the backend of your Joomla site (administration) select Extensions -> Install/Uninstall.
    • Click the Browse button and select the extension package on your local machine.
    • Click the Upload File & Install button.

     

    Read more...
  • Cheat sheet

    Getting Started

    Contact Enhanced is very easy to set up, but because it has so many options it might bit a bit confusing for beginners, so Bob Meetin created a cheatsheet* for the basic usage. Keep reading it!

    Read more...
  • Setting up Google Maps

    Getting Started

    CE GMaps Integration
    CE GMaps IntegrationClick to watch
    6:10 minutes
    382 views
    Average: 5.00
    Votes: 1
    Contact Enhanced uses the Google Maps (formerly Google Local) API to show a map based on the contact address. Take a look at some of the features:

    • Google Maps directions;
    • Easily display latitude and longitude of address;
    • You can add any text to the balloon using a contact extrafield, including HTML .
    • Show GMaps and directions inline or in a Modal (Lightbox style) window;
    • Customize the Marker icon;
    • Choose a language;
    • Show/Hide Navigation Control;
    • Show/Hide Map Type Control;
    • Choose the default Map Type. Options: Roadmap, Satellite; Hybrid, Terrain;
    • Using GMaps API version 3, which was designed with Mobile devices in mind, therefore loads faster;

    Screencast by Goran;

  • Component Parameters

    Getting Started

    Component Parameters
    Component ParametersClick to watch
    0:58 seconds
    140 views
    Average: 5.00
    Votes: 2
    This Screencast shows how to edit the Component Parameters (Options in Joomla 2.5). Remember that all Component Parameters are overridden by the Menu Item parameters. This feature allows you to have different configurations for each form;

  • Custom Values Overview

    Getting Started

    Missing screencast
    Help us improve the documentation page and Win a free copy of BB Flashback PRO*

    How to Access

    Select Components → Contact Enhanced → Custom Values from the drop-down menu on the back-end of your Joomla! installation.

    Description

    The Custom Fields Manager screen allows you to create advanced Custom Fields using the SQL custom field type;

    Details
    • Text: The text the user will see in the dropdown select list (required);

    • Value: The text that you will get in the email (required);
    • Type: You can enter any value to help you to keep things organized;

    • Category: You can use this field as you wish; You can enter a value or select one from the list; IMPORTANT: This is not necessary related to the Contact Enhanced Categories;

    Read more...
  • Edit Contact Overview

    Getting Started

    Missing screencast
    Help us improve the documentation page and Win a free copy of BB Flashback PRO*

    How to Access

    Navigate to the Contact Enhanced Manager. To add a new Contact, press the "New" icon in the toolbar. To edit an existing Contact, click on the Contact's Name or click the Contact's checkbox and then click on the "Edit" icon in the toolbar.

    Description

    This is where you can add a Contact or edit an existing Contact. Contact Enhanced allow you to list people on your web site. They also allow users to send e-mails to those people.

    Read more...
  • Edit Custom Field Overview

    Getting Started

    Navigate to the Custom Fields Manager. To add a new Custom Field, press the "New" icon in the toolbar. To edit an existing Custom Field, click on the Custom Field's Name or click the Custom Field's checkbox and then click on the "Edit" icon in the toolbar.

    Description

    This is where you can add a Custom Field or edit an existing one. Contact Enhanced allows you to list Custom Fields on your web site's contact forms. Contact Enhaced has the ability to allow you (site administrator) to assign custom fields to a contact category. Therefore you have to create a category before you create a custom field. Your users will be able to fill that custom field when they submit the form.

    Read more...
  • Custom Field Manager Overview

    Getting Started

    How to access

    Select Components → Contact Enhanced → Custom Fields from the drop-down menu on the back-end of your Joomla! installation.

    Description

    Contact Enhaced has the ability to allow you (site administrator) to assign custom fields to a contact category. Therefore you have to create a category before you create a custom field. Your users will be able to fill that custom field when they submit the form.

    Read more...
  • Contact Enhanced Manager Overview

    Getting Started

    Select Components → Contact Enhanced → Contacts from the drop-down menu on the back-end of your Joomla! installation.

    Description

    The Contact Enhanced Manager screen allows you to add contact information to your Joomla! site. You can enter information such as name, address, phone and e-mail. You can also link contacts to registered users. Afterwards, you can use the Menu Manager to create front-end links to the the contacts.

    Read more...
  • QR Code

    Getting Started

    Description

    A QR code (abbreviated from Quick Response code) is a specific matrix barcode (or two-dimensional code) that is readable by dedicated QR barcode readers, camera telephones, and to a less common extent, computers with webcams. The code consists of black modules arranged in a square pattern on a white background. The information encoded may be text, URL, or other data. Wikipedia
    Read more...
  • Front-end edit

    Getting Started

    Description

    Option to allow an usergroup to edit a contact details without back-end (administrator) access. Only the user linked to a contact can edit the contact;

    Read more...

Custom Fields

Contact Enhanced has the ability to allow webmasters to assign custom fields to contact forms. Custom Fields offer a lot of flexibility that allows you to create more a simple contact form.

Customizing your forms


Using plugins and modules

  • Category Module

    Contact Enhanced Documentation - Using plugins and modules

    Description

    With this new module we can display the contents of a category in a list layout. We can also display multiple categories.

    Requirements

    1. Have Contact Enhanced Component installed;
    2. Have created at least one category and one contact;
    Read more...
  • Feedback Plugin

    Contact Enhanced Documentation - Using plugins and modules

    CE FeedbackThe CE Feedback is a plugin that adds a Feedback image to the side of your site and when clicked it loads a feedback form using Contact Enhanced to allows any website user to leave a comment on your site. It loads in a modal window using Joomla default's MooTools modal window (SqueezeBox), so if your customer have a question about a particular page he can submit a feedback form without ever leaving the page.

    For more info, please go to the CE Feedback page;

  • Contact Enhanced Content Plugin

    Contact Enhanced Documentation - Using plugins and modules

    The Contact Enhanced Plugin
    The Contact Enhanced PluginClick to watch
    2:37 minutes
    739 views
    Average: 5.00
    Votes: 3
    With the Contact Enhanced plugin you can display forms inside Joomla Content Articles, by adding the following tag:
    {loadcontact id=|ID| }

    You just have to change the ID for your contact id;

    You can also add the Map or display in a modal window using this code:

    {loadcontact id=|ID| map=|before_form OR after_form| type=|embedded OR modal| text=|Text to that will display when type is set to modal| }

    For Joomla 1.6+ you have a few additional options, Contact details and Contact image, by using this code:

    {loadcontact id=|ID| map=|before_form OR after_form| details=|before_form OR after_form OR before_map OR after_map| image=|before_details OR after_details| type=|embedded OR modal| text=|Text to that will display when type is set to modal| modal_width=|800l| modal_height=|500| modal_template=|beez5| }

    Syntax explained:

    • id: Contact Enhanced Contact's ID to load the form; * This is the ONLY required syntax parameter;
    • type: Whether or not to display the form in a modal window; Possible values: [blank], embedded, modal;
    • fields: Used to pre-load one or more custom fields; add multiple fields in a URL query syntax. Example: fields=|subject=A custom subject goes here&cf_10=some text|
    • Parameters only available if type=|embedded| or if there is no type parameter:
      • map: Whether to load the contact map or not. Possible values: before_form, after_form, [none];
      • details: Whether to load a contact details or not. Possible values: before_map, after_map, before_map, after_map, [none];
      • image: Whether to load the contact image or not. Possible values: before_form, after_form, [none];
    • Parameters only available if type=|modal|:
      • text: Text that will be displayed in the link; Can be text or an image;
      • modal_width: Modal window width size in pixels; Use numbers only;
      • modal_height: Modal window height size in pixels; Use numbers only;
      • modal_template: Template to load the modal window; You can choose any template installed on your Joomla site to load the Contact Enhanced form;

    If you enable the "Button - Contact Enhanced Form" Plugin in order to help add Contact Enhanced (CE) Form into an article. It will add a button below your WYSIWYG Editor.

    Important:

    • Please make sure that you have Contact Enhanced component installed correctly, otherwise the plugin will not work;
    • In the Plugin Parameters (Options) set the "After form is submitted show" option in order to choose the component behavior once the form is submitted;

    This screencast made by Dale covers the installation and usage of the Contact Enhanced plugin.

     

  • Enabling iCaptcha Plugin

    Contact Enhanced Documentation - Using plugins and modules

    Missing screencast
    Help us improve the documentation page and Win a free copy of BB Flashback PRO*

    Please follow these steps:

    1. Contact Enhanced already installs the Captcha plugin automatically. If for some reason it was not installed you need to download the free CAPTCHA plugin from our download page;
      • Install the plugin using Joomla installer, and then enable in the Plugin Manager;
    2. Go to Extensions -> Plugin manager, search for "CAPTCHA" and choose which captcha library you want to use (SecurImage, reCAPTCHA or MathGuard). If you choose a library other than reCAPTCHA, please jump to step 6;
    3. You will see that the reCAPTCHA requires two API keys. To get these keys you need to create an account at the reCAPTCHA website (http://recaptcha.net);
    4. After registration at the reCAPTCHA website, you will be taken to a page where you can create the two keys that you need.
    5. Inserted the two keys into the plugin fields;
    6. Joomla 1.5: Ensure that CAPTCHA is enabled in the 'Parameters' section of the Contact Enhanced Manager;
    7. Now the CAPTCHA system is ready to go, and will appear on your contact page;

    Please note that in Joomla 1.5 the CAPTCHA plugin only appears to non-registred members of your website, so if you are and administrator, for example, you must log out to view it on your contact page.

     

    Written by Trevor and updated by Douglas

  • JCE Advanced Links

    Contact Enhanced Documentation - Using plugins and modules

    Description

    The extension integrates with JCE (Joomla Content Editor) and allows you to create links to:

    • Contact Enhanced Categories; NEW!
    • Contact Enhanced Contacts;
    Read more...

Troubleshooting

  • Why javascript validation or maps doesn't work?

    Contact Enhanced Documentation - Troubleshooting

    Missing screencast
    Help us improve the documentation page and Win a free copy of BB Flashback PRO*

    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.

    Solution:
    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:
    http://docs.jquery.com/Using_jQuery_with_Other_Libraries

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

    Advice:
    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?

    Contact Enhanced Documentation - Troubleshooting

    Missing screencast
    Help us improve the documentation page and Win a free copy of BB Flashback PRO*

    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?

    Contact Enhanced Documentation - Troubleshooting

    Missing screencast
    Help us improve the documentation page and Win a free copy of BB Flashback PRO*

    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 yourself@THISaddress.com if your form is on www.THATaddress.com. 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, do 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;

      Contact Enhanced, Ajax Contact and Joomla core contact (of course) use Joomla framework and configuration to send emails and some Joomla installs will not work correctly with Sendmail or PHP Mailer because some mail servers require that unauthenticated emails must be sent from or to an email address @your-domain.com, or do not allow unauthenticated emails. It seems to be your case, specially because only the copy message is sent.

      I 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 these informations.

      Mailer: SMTP Server
      SMTP Authentication:
      SMTP Security:
      SMTP Port:
      SMTP Username:
      SMTP Password:
      SMTP Host:
  • Do I have the wrong PHP version?

    Contact Enhanced Documentation - Troubleshooting

    Missing screencast
    Help us improve the documentation page and Win a free copy of BB Flashback PRO*

    Contact Enhanced requires PHP5 in order to work!

    Please read the news published on the PHP.net 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)

    Contact Enhanced Documentation - Troubleshooting

    Missing screencast
    Help us improve the documentation page and Win a free copy of BB Flashback PRO*

    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 can I add a sent confirmation message?

    Contact Enhanced Documentation - Troubleshooting

    Missing screencast
    Help us improve the documentation page and Win a free copy of BB Flashback PRO*

    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...
  • Optimize your PHP installation to handle large file uploads

    Contact Enhanced Documentation - Troubleshooting

    Missing screencast
    Help us improve the documentation page and Win a free copy of BB Flashback PRO*

    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...
  • Why do I get an error when trying to upload a file?

    Contact Enhanced Documentation - Troubleshooting

    Missing screencast
    Help us improve the documentation page and Win a free copy of BB Flashback PRO*

    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 Custom Fields' border are gone?

    Contact Enhanced Documentation - Troubleshooting

    Missing screencast
    Help us improve the documentation page and Win a free copy of BB Flashback PRO*

    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:

    [Path to Joomla 1.5]/components/com_contact_enhanced/assets/css/validate.css

    [Path to Joomla 1.6]/components/com_contactenhanced/assets/css/ce.css

    .ce-container .inputbox{border:1px inset !important}
  • Translating the javascript Error Messages and tips

    Contact Enhanced Documentation - Troubleshooting

    Joomla 1.6+ comes with MooTools 1.3 which has its own validation script, which Contact Enhanced uses. The translation for the error messages (for some languages, see language codes) are in the MooTools javascript files:

    [Path to Joomla 1.6+]/media/system/js/mootools-core.js
    [Path to Joomla 1.6+]/media/system/js/mootools-more.js

    Current languages in MooTools language files:

    ar-AA, ca-CA, ca-ES, cs-CZ, da-DK, de-DE, en-US, en-UK, en-AU, es-AR, es-ES, et-EE, fa-IR, fi-FI, fr-FR, he-IL, hu-HU, it-IT, ja-JP, nl-NL, nl-BE, no-NO, pl-PL, pt-BR, pt-PT, ru-RU, si-SI, sv-SE, tr-TR, uk-UA, zh-CN, zh-TW

    If it is not translated into your language, open this file:

    [Path to Joomla 1.6+]/components/com_contactenhanced/assets/js/mootools-languages/locale.en-US.js

    and copy to:

    [Path to Joomla 1.6+]/components/com_contactenhanced/assets/js/mootools-languages/locale.language-CODE.js where language-CODE follows this convention [language-code]-[COUNTRY-CODE]. (see a list with the most common COUNTRY-CODE)

    Then Translate all content of the file  inside single quotes, except for the strings 'Date', 'Number' and 'FormValidator'.


Login Form

Use paypal, a safe waay to pay!

Banco do Brasil, Direct Deposit or Swift transfer