Getting Started



Installation

This is a short instruction on how to install Contact Enhanced  extension in your Joomla installation.

Install Contact Enhanced

To install the Contact Enhanced extension use the Extensions Installer in the Joomla administration. Go to Extensions » Install/Uninstall.

When you are facing an error during installation, it is highly recommended to try to Install from directory:

  1. Download the latest Contact Enhanced (CE) version and unpack all CE files to a directory on your computer;
  2. Using FTP, upload this directory to the /tmp directory of your Joomla installation on your webserver/
  3. Go to the extensions installer in the Joomla administration, use the "Install from Directory" option to set the directory of your uploaded CE files.
  4. Click on the Install button and Joomla will install it from the given directory.

Requirements

  • Joomla 2.5+
  • PHP 5.2.7+
  • PHPs GD extension (enabled by default in PHP 5.0+)
  • PHPs SimpleXML extension (enabled by default in PHP 5.0+)
  • PHPs DOM extension (enabled by default in PHP 5.0+)
  • PHPs allow_url_fopen support (enabled by default in PHP 5.0+)
  • Mod_rewrite for Apache for search engine friendly links (enabled by default in most web servers)

 

Installation Video for Joomla 1.5

install.mov
install.movClick to watch
2:38 minutes
647 views
Average: 0.00
Votes: 0

Cheat sheet

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!

  1. Installation:
    1. Purchase/license and download the latest version of Contact Enhanced (CE);
    2. Select Extensions Extension Manager from the drop-down menu of the Joomla! Administrator Panel. Then select the Install menu item in the Extension manager screen that appears. 
    3. Navigate to the Contact Enhanced zip file, select and install as you would any other Joomla extension;
  2. CE Component Configuration:
    1. Go to Components Contact Enhanced;
    2. Click on the Options button on the toolbar. You don't really need to do anything other than Save it, but keep in mind that it holds all default configuration for Contact Enhanced. This settings can be overriden by the Contact's Options and the Menu Options;
    3. Category Configuration:
      1. Click on the Categories and Select New;
      2. Fill in minimal info to set up a default category and Save;
        • You need to create a different category for each different form (then assign a contact and custom fields to that new category);
    4. Contact (form) Configuration:
      1. Click on the Contacts tab;
      2. Select Contacts and then "New";
      3. Under Publishing Info fill set:
        1. Name. The full name of the Contact. Name can actually be a function or department, not a specific human being;
        2. Alias. The internal name of the item, also used in the URL when SEF is activated. Normally, you can leave this blank and Joomla! will fill in a default value. The default value is the Title or Name in lower case and with dashes instead of spaces. You may enter the Alias manually. The Alias should consist of lowercase letters and hyphens (-). No blank spaces or underscores are allowed. Note: If the title consists of non-Latin characters, the Alias will default to the current date and time, for example "2009-02-11-17-54-38".
        3. Linked to User. Select the User, if any, that this Contact is linked to from the drop-down list box. This allows you to link this Contact's information to a registered Joomla! User. If this Contact is not linked to a User, select "-No User-".
        4. Category. The Category this item belongs to.
      4. Under Contact Details slider set:
        1. Image. Image to display for this Contact. Select an image file from the drop-down list box. This lists images in the 'images/stories' folder. Images can be uploaded using the Media Manager.
        2. Contact's Position: The Contact's current position.
        3. E-mail. Assuming you selected "No User" earlier, you must enter an email address or an alias to which filled forms will be sent.  Do it.
          • Keep in mind that if you link to an user it will use the user's email address, even if you enter an email here;
        4. Address. The Contact's street address.
        5. City or Suburb. The Contact's town or suburb.
        6. State or Province. The Contact's state or county.
        7. Postal / ZIP Code. The Contact's postal code.
        8. Country. The Contact's country.
      5. Fill in other info as you wish; for a simple form you don't need to complete any of the other fill in fields on the left.
      6. Google Maps configuration (optional) - GMaps slider:
        1. Google Maps (GMaps) works with the address info you fill in.  So fill in the next 4 fields: Street Address, Town/Suburb, State/County, and Postal Code/ZIP.
        2. To set Google Maps click on Maps slider and click on "Locate in map".  If it does not find the address correctly then you may need to mess with the Address fields and Apply and try again OR drag the marker (pin) until you point it to the correct location;
      7. Click on Display Options (optional):
        1. Show Contact details: Allows you to display the contact details in different places. Sidebar is good unless you have a really narrow page.
        2. Show Map: Choose whether and where you want to display Google Maps in order to suit your preferences;
        3. Change the options selections to meet your needs; none really must be changed.
      8. Click on "Contact Form" slider (optional):
        1. Record messages: Whether you want to record the emails sent to this contact in the database;
        2. Show sidebar: Change to Right or Left if you want the contact info to display in the sidebar;
      9. Nothing else must be change for the form to work, so click Save;
  3. Menu Configuration:
    1. Go to Menus --> Menu Manager and select the Menu where you want the form to display.
    2. Select New button from the toolbar
    3. Menu Item Type: Contact Enhanced --> Single Contact Form (or other menu item type);
    4. Give it a Menu Title and set Parent Item.
    5. Contact Display Options: you can override most Contact Details configuration options;
    6. Page Display Options: Set a Page Title and a heading;
    7. Select Save;
  4. Clean the Joomla and your browser's cache and go to your website and check it out.  It should be good to go, but you can also configure the plugins included in the package:
  5. Captcha Configuration:
    1. In the Component Configuration (item #2) set the Captcha option to your favorite Joomla core plugin captcha;
    2. Contact Enhanced comes with a core captcha plugin called SecurImage. It is very customizable and if you want to use it, go to Extensions --> Plugin Manager --> Captcha - SecurImage and change the options as you wish;
  6. CE Feedback Plugin Configuration:
    1. Contact Enhanced Full version includes a vertical Feedback tab/button that can be displayed on the left/right of your website. To configure this button, select "System - Cefeedback";
    2. Make changes as necessary and save the changes;

 

* A cheat sheet or crib sheet is a concise set of notes used for quick reference;

How to Update

This is a tutorial on how to update the Contact Enhanced extension without uninstalling and reinstalling the component.

Update Contact Enhanced

Simply choose one of two different distributions of the Contact Enhanced. The Regular Contact Enhanced, OR Contact Enhanced FULL installation package, including all available plugins and modules. Both packages include  the back-end modules and the content plugin.

Now follow these steps to update your Contact Enhanced:

  1. First of all make a backup of your old site (files and database), so you can recover it any time.
  2. Download the latest Contact Enhanced version (one of the distributions from above).
  3. Go to the extensions installer in the Joomla administration, pick the downloaded Contact Enhanced package and click on Upload File & Install.

That's it! Now the Contact Enhanced extension, all language files and all bundled modules and plugins are updated to the latest version...

Keep in mind that any modifications to the files (PHP, CSS, Images, language, etc) may be lost. Therefore we recommend to create a full backup before the upgrade. If you want to change HTML we recommend to use Joomla's core HTML template override and use Language overrides to change the language.

When you've finished the update, clear your browser cache and the Joomla cache. To clear the Joomla cache go to the Joomla administration » Tools » Clean Cache.

If you are facing this error during installation: "Fatal error: Maximum execution time of 30 seconds exceeded in ..... on line ....." you may try to install the component from a directory as described in the Installation article.

Setting up Google Maps

CE GMaps Integration
CE GMaps IntegrationClick to watch
6:10 minutes
613 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

Component Parameters
Component ParametersClick to watch
0:58 seconds
180 views
Average: 5.00
Votes: 3
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;

Extra Contact Detail Fields

Description

Contact Enhanced →Contacts have a full range of fields (address, telephones, Skype, Social Networks, Website, Birth date), however you might need to display a Custom information. With that specific need in mind we've created the Contact Extra Fields.

The Contact Extra Fields were implemented to give the users a bit of flexibility in order to add more Contact Details (up to 10) in the Single Contact and in the Category list menu items.

Extra Fields

Usage

You can add any data, including HTML, in ALL Extra Fields, but there is an HTML WYSIWYG Editor only for Extra Fields 1 to 4.  WYSIWYG Editors take a while to load, so to save load time only 4 of them have the editor. Also, if you need to add plain text Contact info (details), please use the Extra Fields 5 through 10, because most editors automatically add a <p> tag.This fields will display below the other Contact Details.

To translate the labels go to Extensions → Language Manager :: Overrides and add New overrides for

COM_CONTACTENHANCED_FIELD_INFORMATION_EXTRA_FIELD_1_LABEL

to

COM_CONTACTENHANCED_FIELD_INFORMATION_EXTRA_FIELD_10_LABEL

TIP: You can also choose the content of an extra field to display in Google Maps Balloon (aka, Info Window), in case you use the maps.

In order to keep the same load time, the fields are saved to the same database table, therefore it does not allow us to implement an easier way to add labels to them, so you need to change the labels using the the Language override as explained in the Contact Edit page under the Extra Fields tab.

Custom Values Overview

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: Custom Values Overview

Edit Contact Overview

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 Contact Overview

Edit Custom Field Overview

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: Edit Custom Field Overview

How to order Contacts by Last Name

Description

In Contact Enhanced → Contacts → Edit Contact you have the Fields: First Sort Field, Second Sort Field and Third Sort Field, which allow you to order the contacts in a List view by them.  This is very useful if you want to order your contacts in a category list by Last name.

Extra Fields

Usage

If ordering is set to Name (in the Component options, under the List tab), it will use these fields to sort the Contacts in the Category list. If they are blank it will use the Name field.Useful when you What to sort the list by Last name, but want to display the first name in the Category list view. For example, your Contact Name is John Smith, but you want to sort by last name, then in the "First Sort Field" you ad Smith and in the "Second Sort Field" you add John.

Custom Field Manager Overview

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: Custom Field Manager Overview

Contact Enhanced Manager Overview

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: Contact Enhanced Manager Overview

QR Code

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: QR Code

Front-end edit

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: Front-end edit


Newsletter

captcha

Connect with us

We're on Social Networks. Follow us & get in touch.
You are here: Start page