Details

Category: Contact Enhanced

A work-in-progress documentation.

Feedback

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. If you made a screencast or a tutorial, you can post on the forum or send it to us by email.

How to get the this Joomla Extension

With our automated payment and delivery process, you could be downloading and installing your new component in a few minutes! We use PayPal as our payment processor. It is one of the most preferred payment methods on the internet. You are not obligated to sign up with PayPal, so you can also just make a onetime purchase using your favorite creditcard.

{tab=Screencasts}

All Screencasts on available on this page were produced by Dale, the nicest Canadian lady I've ever "met". Thanks Dale!

Installation Instructions

Screencast by Dale

 

Editing HTML Templates

Contact Enhanced Plugin

Screencast by Dale

 

Setting up Google Maps + Security

Screencast by Dale

{tab=Contact Enhanced}

Contact Enhanced Manager

How to access

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.

Screenshot

Column Headers

Click on the column heading to sort the list by that column's value.

• #. An indexing number automatically assigned by Contact Enhanced for ease of reference.

• Checkbox. Check this box to select one or more items. To select all items, check the box in the column heading. After one or more boxes are checked, click a toolbar button to take an action on the selected item or items. Many toolbar actions, such as Publish and Unpublish, can work with multiple items. Others, such as Edit, only work on one item at a time. If multiple items are checked and you press Edit, the first item will be opened for editing.

• Name. The name of the Contact. You can click on the Name to open the Contact for editing.

• Published. Whether the item has been published or not. You can change the Published state by clicking on the icon in this column.

• Order. The order to display items. If the list is sorted by this column, you can change the order by clicking the arrows or by entering the sequential order and clicking 'Save Order'. Note that the display order on a page is set in the Parameters - Advanced section for each Menu Item. If that order is set to use something other than 'Order' (for example, 'Title - Alphabetical'), then the order value in this screen will be ignored. If the Menu Item Order parameter is set to use 'Order', then the items will display on the page based on the order in this screen.

• Access Level. Who has access to this item. Current options are:

  • Public: Everyone has access

  • Registered: Only registered users have access

  • Special: Only users with author status or higher have access

You can change an item's Access Level by clicking on the icon in the column.

• Category. The Category that this Contact belongs to. Clicking on the Category Title opens the Category for editing. Note that Contact Categories are separate from other Categories, such as those for Articles, Banners, Newsfeeds, and Web Links.

• Linked to User. The username this contact is linked to (if applicable).

• ID. The ID number. This is a unique identification number for this item assigned automatically by Contact Enhanced. It is used to identify the item internally. You can not change this number.

• Display #. The number of items to display on one page. If there are more items than this number, you can use the page navigation buttons (Start, Prev, Next, End, and page numbers) to navigate between pages. Note that if you have a large number of items, it may be helpful to use the Filter options, located above the column headings, to limit which items display.

Toolbar

At the top right you will see the toolbar:

The functions are:

• Publish. To publish one or more items, select them and click on this button.

• Unpublish. To unpublish one or more items, select them and click on this button.

• Delete. To delete one or more items, select them and click this button. The selected items will be deleted.

• Edit. Select one item and click on this button to open it in edit mode. If you have more than one item selected, the first item will be opened. You can also open an item for editing by clicking on its Title or Name.

• New. Click on this button to create a new item. You will enter the New page for this item.

• Parameters. See Global Configuration section below.

• Help. Opens this Help Screen.

Global Configuration

Click the Parameters button to open the Contact Enhanced Global Configuration window. This window allows you to set default parameters for Contact Enhanced, as shown below.

• Save. Press Save to save your settings.

• Cancel. Press Cancel to cancel your changes.

• Captcha. Press Disable to disable Captcha in all forms
• Thank you message. What message to show after the form is submitted. Select an option from the list:
  • Joomla Default: Displays a "Thank you message" right above the form;
  • Show sent email message: Shows to the user the email that was just sent;
  • Javascript Alert: Shows a Thank you message in a Javascript Alert style;
  • Custom Redirect:The page is going to be redirected to the URL listed in the Custom Redirect option.
• Custom Redirect: Redirect after submit email. Place an external URL starting with http or an internal URL starting with index.php;
• Show User Info: Show User Info on email. User info = IP, Operating System, Screen size and Web Browser;
• Max File Size: Max File size (in Kb) for attachments files;
  

• Icons/Text. Whether an Icon, Text or nothing is displayed next to the Contact fields.

• Address Icon. Icon to use for Address. Select an image file in the drop-down list box. These images are located in the 'images/M_images' folder.

• E-mail Icon. (Hide/Show/Use Global) Whether or not to display a button to allow a link to the Article to be e-mailed. This displays a form that allows the user to send an e-mail with a link to the current Article.

• Telephone Icon. Icon to use for Telephone. Select an image file in the drop-down list box. These images are located in the 'images/M_images' folder.

• Mobile Icon. Icon to use for Mobile phone. Select an image file in the drop-down list box. These images are located in the 'images/M_images' folder.

• Fax Icon. Icon to use for Fax. Select an image file in the drop-down list box. These images are located in the 'images/M_images' folder.

• Miscellaneous Icon. Icon to use for Miscellaneous. Select an image file in the drop-down list box. These images are located in the 'images/M_images' folder.

• Show Table Headings. Hide or Show the column headings (Name, Address, and so on) in the Contact Category Layout.

• Show Contact Position. Hide or Show the Contact's Position.

• Show E-mail Address. Hide or Show the Contact's E-mail address.

• Show Telephone Number. Hide or Show the Contact's Telephone number.

• Show Mobile Number. Hide or Show the Contact's Mobile phone number.

• Show Fax Number. Hide or Show the Contact's Fax number.

• Enable vCard. Whether or not to enable vCard support for Contacts. vCard is a special file format for electronic business cards. This allows contact information to be sent in a standard way via e-mail. Note that this parameter must be set to "Yes" for the vCard feature to work. If this parameter is "No" and vCard is set to "Show" for a Contact, the vCard link will show but the link will not work correctly. It will only show a blank screen.

• Banned E-mail. Enter any e-mails to be banned from the site. E-mail addresses containing any of the listed text will be banned. Separate different words with semi-colons ';'. For example, the entry "spam;junk" would ban e-mail addresses such as "myspam@.com" or "aeddie@junkisgood.com".

• Banned Subject. Enter any e-mail subject words to be banned from the site. Separate different words with semi-colons ';'. For example, the entry "spam;junk" would ban e-mail subjects such as "This is not spam" or "I Like Junk".

• Banned Text. Enter any e-mail text words to be banned from the site. Separate different words with semi-colons ';'. For example, the entry "spam;junk" would ban e-mail content such as "This is not spam" or "I Like Junk".

• Session Check. Whether or not to check for the existence of a Session Cookie on the User's computer. If set to 'Yes', Users without Cookies enabled will not be able to send e-mails.

• Custom Reply. Whether or not to use the Custom Reply. Setting this to 'No' allows integration to other systems.

List Filters

Filter by Partial Title

You can filter the list of items by typing in part of the Title or the ID number. You can also select a combination of Category and Published State.

• Filter. In the upper left corner just above the column headings is a Filter field and two buttons, as shown below:

  

  If you have a large number of items on the list, you can use this filter to find the desired item(s) quickly.

Filter by Category and Published State

In the upper right area, above the column headings, are 2 drop-down list boxes as shown below:

The selections may be combined. Only items matching both selections will display in the list.

• Select Category. Use the drop-down list box to select the desired Category. Only items in this Category will display.

• Select State. Use the drop-down list box to select the published state: Published or Unpublished.

Quick Tips

• You need to add at least one Category for your Contact Enhanced before you can add your first Contact. Categories are added using the Contact Enhanced Category Manager.

For most screenshots I've used Firefox and Ubuntu Studio so it might look a little different.

{tab=Contact Edit}

{tab=Custom Fields}

Custom Fields Manager

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.

Screenshot

Column Headers

Click on the column heading to sort the list by that column's value.

• #. An indexing number automatically assigned by Contact Enhanced for ease of reference.

• Checkbox. Check this box to select one or more items. To select all items, check the box in the column heading. After one or more boxes are checked, click a toolbar button to take an action on the selected item or items. Many toolbar actions, such as Publish and Unpublish, can work with multiple items. Others, such as Edit, only work on one item at a time. If multiple items are checked and you press Edit, the first item will be opened for editing.

• Name. The name of the Custom Field, which is also the label that will be shown in the form. You can click on the Name to open the Custom field for editing.

• Value. For certain Field Types (Select list, Radio, Checkbox, ) you have to setup the available options separated by pipe | . For example, on our support contact page you have to fill which browsers you have tested, in order to do that we selected the Radiobox field type and typed the following content in the value box: Firefox|Internet Explorer|Opera|Google Chrome|Safari|Other

• Published. Whether the item has been published or not. You can change the Published state by clicking on the icon in this column.

• Parameters. This advanced option makes Contact Enhanced even more powerfull! You can add styling and javascript code here.

• Order by. The order to display Custom Fields in the form. If the list is sorted by this column, you can change the order by clicking the arrows or by entering the sequential order and clicking 'Save Order'.

• Category. The Category that this Custom Field belongs to. Clicking on the Category Title opens the Category for editing. Note that Contact Enhanced Categories are separate from other Categories, such as those for Articles, Banners, Newsfeeds, and Web Links.

• Id. The ID number. This is a unique identification number for this Custom Field assigned automatically by Contact Enhanced. It is used to identify the item internally. You can not change this number.

Toolbar

At the top right you will see the toolbar:

The functions are:

• Publish. To publish one or more items, select them and click on this button.

• Unpublish. To unpublish one or more items, select them and click on this button.

• Delete. To delete one or more items, select them and click this button. The selected items will be deleted.

• Edit. Select one item and click on this button to open it in edit mode. If you have more than one item selected, the first item will be opened. You can also open an item for editing by clicking on its Title or Name.

• New. Click on this button to create a new item. You will enter the New page for this item.

List Filters

Filter by Partial Name

You can filter the list of items by typing in part of the Name. You can also select a combination of Category and Published State.

• Filter. In the upper left corner just above the column headings is a Filter field and two buttons, as shown below:

  

  If you have a large number of items on the list, you can use this filter to find the desired Custom Field(s) quickly.

Filter by Category and Published State

In the upper right area, above the column headings, are 2 drop-down list boxes as shown below:

The selections may be combined. Only items matching both selections will display in the list.

• Select Category. Use the drop-down list box to select the desired Category. Only items in this Category will display.

• Select State. Use the drop-down list box to select the published state: Published or Unpublished.

Quick Tips

• You need to add at least one Category for your Contact Enhanced before you can add your first Custom Field. Categories are added using the Contact Enhanced Category Manager.

For most screenshots I've used Firefox and Ubuntu Studio so it might look a little different.

{tab=Custom Field Edit}

Custom Field: New /Edit

How to Access

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.

Screenshot

Custom Field Details

Name

Name or Title for the custom field. This is the text that will be shown in the front-end as the field label;

HTML Output: <label for="cf_field_id">Field name</label>

Field Type

All available types:

Type	Value	Value Example	Output
Text Field
Checkbox	Values separeted by |	Firefox|Internet Explorer|Opera|Google Chrome|Safari|Other	Browsers Tested Firefox Internet Explorer Opera Google Chrome Safari Other
Date
Date Range			to
Free Text	Custom HTML	<i>Any Text</i>, <strong>May</strong> contain <u>most HTML tags</u>	Any Text, May contain most HTML tags
Hidden Input
Multiple Files - Beta
MultiText
Number	Range separated by -	1-10	-- Please select one --12345678910
Number Range	Range separated by - and Values separeted by |	1-10|11-20	From12345678910 to11121314151617181920
Password
Radiobox	Values separeted by |	Firefox|Internet Explorer|Opera|Google Chrome|Safari|Other	Firefox Internet Explorer Opera Google Chrome Safari Other
Recipient	email:: Description separeted by |	sales@mycompany.com:: Sales Department  | support@mycompany.com:: Support Department	-- Please select one --Sales Department Support Department
SelectList	Values separeted by |	Firefox|Internet Explorer|Opera|Google Chrome|Safari|Other	-- Please select one --FirefoxInternet ExplorerOperaGoogle ChromeSafariOther
SQL	SQL Query	SELECT text, value FROM #__contact_enhanced_cv WHERE category = 'MY_CATEGORY_NAME_OR_ID' ORDER BY ordering
Subject	Blank, Some text or Values separeted by | (if you want to display as a select list)

Value

For certain Field Types (Select list, Radio, Checkbox, Free Text, Number, Number Range) you have to setup the available options separated by pipe | . For example, on our support contact page you have to fill which browsers you have tested, in order to do that we selected the checkbox field type and typed the following content in the value box: Firefox|Internet Explorer|Opera|Google Chrome|Safari|Other. See table above for more examples.

Tooltip

Add a tooltip to be shown when the mouse is over the field's label (frontend).

• Allows HTML tags
• Max length:250 character

Atributes

This advanced option makes Contact Enhanced even more powerfull! You can add styling and javascript code here. If you are an advanced user you can add, for example, a background-image to any field or a javascript onchange event to a selectlist;

Attibutes dummy examples:

• style="background-color:#F0F0EE;border:1px dashed #9FD377"
• onfocus="this.style.border='3px solid #9FD377'"
• onblur="this.style.border='1px dashed #9FD377'"
• onblur="if(this.value !=''){ alert(this.value);}"

Publishing Info

Published

Whether or not Users can view this Custom Field.

Category

Select the Contact Enhanced Category for this Custom Field from the drop-down list box. Note that you must have at least one Contact Enhanced Category defined before you can add a Custom Field.

Order

Indicates the order of this Custom Field when display on the website . The default Order is to add the item to the end of the list. This Custom Field will move to the position just after the Custom Field selected from the drop-down list. Note that the Order of Custom Field can also be changed in the Custom Field Manager.

Required

Indicates whether the user is required to fill this field in order to submit the form or not. Contact Enhanced uses MooTools¹ to validate the forms.

Toolbar

At the top right you will see the toolbar:

The functions are:

• Save. Save it and return to the main screen of the Manager.

• Apply. Save it, but stay in the same screen. If you have been working on a screen for a long time and don't want to risk losing your work, pressing Apply saves your work and lets you continue working. If, for example, you lost your Internet connection, your work will be saved up this point.

• Close. Return to the previous screen without saving your work. If you press Close while adding a new item, this new item will not be created. If you were modifying an existing item, the modifications will not be saved.

• Help. Opens this Help Screen.

Points to Watch

At least one Contact Enhanced Category must be added before adding the first Custom Field.

¹ MooTools is a compact, modular, Object-Oriented JavaScript framework designed for the intermediate to advanced JavaScript developer. It allows you to write powerful, flexible, and cross-browser code with its elegant, well documented, and coherent API. MooTools code respects strict standards and doesn't throw any warnings. It's extensively documented and has meaningful variable names: a joy to browse and a snap to understand. MooTools is compatible and fully tested with Safari 2+, Internet Explorer 6+, Firefox 2+ (and browsers based on gecko), Opera 9+. Mootools is the Joomla default Javascript Library!

{tab=Custom Values}

Custom Values

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;

SQL Field Examples:

• Nothing fancy:
  SELECT text, value FROM #__contact_enhanced_cv WHERE category = 'MY_CATEGORY_NAME_OR_ID' ORDER BY ordering
• Same content for the value and text:
  SELECT text, text as value FROM #__contact_enhanced_cv WHERE category = 'MY_CATEGORY' AND TYPE='Any type' ORDER BY ordering
• If you have a small SQL knowledge you can play around with it. Let's say that you need to show the part number and product name, you your SQL will be like this:
  SELECT CONCAT_WS(' :: ',value, text) AS text, value FROM #__contact_enhanced_cv WHERE category = 'MY_CATEGORY_NAME_OR_ID' ORDER BY orderingSELECT CONCAT_WS(' :: ',value, text) AS text, value FROM #__contact_enhanced_cv WHERE category = 'MY_CATEGORY_NAME_OR_ID' ORDER BY ordering
• Same content for the value and text:
  SELECT text, text as value FROM #__contact_enhanced_cv WHERE category = 'MY_CATEGORY' AND TYPE='Any type' ORDER BY ordering
• Get a backend userlist:
  SELECT username AS value, name AS text FROM #__users WHERE gid >=23 ORDER BY name ASC
• Get data when the user is logged in:
  Get user id:
  SELECT id AS value, id AS text
  FROM #__users
  WHERE id = {user_id}
  
  Get user name:
  SELECT username AS value, username AS text
  FROM #__users
  WHERE id = {user_id}
  
  Get Product and order Info from VirtueMart:
• SELECT p.product_name AS text,
  CONCAT('Product:',p.product_id,' - ', p.product_name,
  ' :: Order ID:', o.order_id ,
  ' Date: ', FROM_UNIXTIME(o.cdate),
  ', Status: ', os.order_status_name) AS value
  FROM jos_vm_orders AS o
  INNER JOIN jos_vm_order_item AS oi ON o.order_id = oi.order_id
  INNER JOIN jos_vm_product AS p ON p.product_id = oi.product_id
  INNER JOIN jos_vm_order_status AS os  ON o.order_status = os.order_status_code
  WHERE o.user_id ={user_id}

{/tabs}

Recommend to a friend