Contact Enhanced Documentation

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




Basic Features

{gdata id=|F-fERcoMN2U|}

Description

Form Fields allows you to extend the functionality of Contact Enhanced.

Requirement

  1. Have created one or more Contact Enhanced categories;

important Information

  1. You can add as many Form Fields as you'd like;
  2. The Name, Email, Subject and Recipient Form Field types have special behaviors;
  3. Every Form MUST have the Name and Email Form Field types; If you don't want to display them, then set the value and hide them;
  4. Read more information regarding the Form Fields in the Documentation Page.

Usage

Select Components → Contact Enhanced → Form Fields from the drop-down menu of the Joomla! Administrator Panel.

To add a new Form Field, press the "New" icon in the toolbar. To edit an existing Form Field, click on the Form Field's Name OR click the Form Field's checkbox and then click on the "Edit" icon in the toolbar.

If you need different forms, assign the Form Fields to different categories and create new contacts for these categories as well;

Read more: Basic Features

AcyMailing

Description

You can integrate AcyMailing with Contact Enhanced so that when a user submits a form, this user is also subscribed to one or several AcyMailing Lists. Contact Enhanced uses the AcyMailing API, so it will work with all AcyMailing Versions (including Starter).

Requirements

  1. Have configured at least one list in AcyMailing;
  2. Have watched the Form Fields -> Basic Features screencast;

    Read more: AcyMailing

Auto Complete

Description

 Creates an auto complete Form Field where you can search content from any table in the database.

Requirement

  1.  Have watched the Form Fields -> Basic Features screencast.

Usage

 Select Components → Contact Enhanced → Form Fields from the drop-down menu on the back-end of your Joomla! installation, then Select AutoComplete from the Field Type select list;

 Choose a category for your Form Field, then Save the changes.

Add a SQL query to the value. The SQL Query must return one column only and the column name OR alias must be "value". Use {selectresult} as the text to search for

Code Example

SELECT title AS value
FROM #__content
WHERE state=1
AND title LIKE '%{selectresult}%'
ORDER BY title ASC

Campaign Monitor

Description

{gdata id=|hp6n36Bclo4|} With Campaign Monitor Form Field your can display your CampaignMonitor lists so your users can subscribe themselves when they send submit the Contact form.

Requirements

  1. Have watched the Form Fields -> Basic Features screencast;
  2. You have to sign up to Campaign Monitor and add the API and ClientID to the Custom Field Parameters, which are only displayed after you save the form;
  3. Campaign Monitor API requires Apache cURL module to be enabled [1];

Read more: Campaign Monitor

Chain Select List

Chained Selects lets you "chain" multiple select lists together so that the selection in a "parent" list can tailor the options available in a "child" list. Chained Selects supports unlimited unlimited number of "chains" in in a form.

In order to Create a chain select list you have to use the SQL Form Field and the fields will be loaded using AJAX JSON Calls.

The first option of a Chain select list can also be a Radio list.

Read more: Chain Select List

Checkbox

Description

{gdata id=|MjEDEWQ8xxo|}

A checkbox (check box, tickbox, tick box) is a Graphical control element that permits the user to make a choice, i.e. a choice between one of two or more possible options. For mutually exclusive options, use Radio button instead.

Checkboxes are often shown on the screen as a square box that can contain white space (for false) or a tick mark or × (for true), as shown ( ☐ or ☑, respectively). A caption describing the meaning of the checkbox is normally shown adjacent to the checkbox. Inverting the state of a checkbox is done by clicking the mouse on the box, or the caption, or by using a keyboard shortcut, such as the space bar.

Requirement

  1. Have watched the Form Fields -> Basic Features screencast;

Read more: Checkbox

Constant Contact

Description

With the Constant Contact Form Field integration, you can now sign up any user to a Constant Contact list with a few simple steps. Constant Contact is a field and does not display Constant Contact fields, so additional CE fields need to be assigned to the category that match Constant Contact (Surname, Name, Email, City and State). This way Contact Enhanced will submit the fields to Constant Contact;

Requirements

  1. Have a Constant Contact account and at least one list created
  2. Have a Mashery account (explained later);

    Read more: Constant Contact

CSS

Description

You can add any CSS code to a page where a Contact Enhanced form is published. Please do not confuse this Custom Field with the Attributes Field of every Custom Field where you can add the style="" attribute.

Requirement

  1. Have watched the Form Fields -> Basic Features screencast;
  2. Some CSS knowledge;
  3. FireBug might help in this task; (optional);

Read more: CSS

Date

{gdata id=|iLW15Ad7xlU|}

Value:

Blank

Output:

calendar

Read more: Date

Free Text

You can display HTML anywhere in the form using the Free Text Form Field type;

How to access it:

  1. Go to Components →Contact Enhanced → Form Fields;
  2. Create a new Form Field, set the Type to Free Text and Save;
  3. Add any value you want to the Value, including HTML content and Save.

 

Tutorial (Joomla 1.5)

Hidden Input + Populate Fields via Query String

{gdata id=|bTBFtCUnsqU|}

Value:

Any text

The value will be displayed in the email message;

Advanced:

If you want to integrate Contact Enhanced with other systems you just you can send variables in the URL that will populate the fields;

You will just have to add alias=example to the URL, where alias is the Form Field alias. For example we'll prefill the Subject and website fields in our Support Contact Form, take a look:

https://idealextensions.com/support/contact.html?subject=Add+a+subject+via+Query+String&website=adomain.com

Javascript

Description

You can add any JavaScript code to a page where a Contact Enhanced form is published. Please do not confuse this Custom Field with the Attributes Field of every Custom Field where you can add html attributes such as onblur="", onchange="", cols="", rows="" ,....

Requirement

  1. Have watched the Form Fields -> Basic Features screencast;
  2. Some Javascript knowledge;
  3. FireBug might help in this task; (optional);

Read more: Javascript

MailChimp Integration

{gdata id=|-KTWd1Esz4I|} With MailChimp Form Field your can display your MailChimp lists so your users can subscribe themselves when they send submit the Contact form.

Multitext

{gdata id=|0jJoHRksQwU|}

Value:

Blank or text

Output:

Multiple File Upload

Description

Contact Enhanced allows your user to upload Multiple Files at once, with multiple file selection, progress bars and validation. The files are uploaded via Ajax, so the form will be processed much faster (version 3.2 and newer).

Requirement

  1. Have watched the Form Fields -> Basic Features screencast;
  2. In Joomla 3.2 and newer, jQuery and Bootstrap will be loaded (automatically);

Read more: Multiple File Upload

Number

{gdata id=|uprqKknvGlY|}

Value:

Range separated by -

Value example:

1-10

Output:

Number Range

{gdata id=|o93wu8dgN48|}

Value:

Range separated by - and Values separeted by |

Value example:

1-10|11-20

Output:

Pagination

{gdata id=|6e6UREuTOcY|}

Description

You can break a contact form into multiple pages. This will allow you to collect data in a contact form over multiple pages (steps) instead of all in one.

Read more: Pagination

PHP

Description

You can add PHP code to a page where a Contact Enhanced form is published.

Requirement

  1. Have watched the Form Fields -> Basic Features screencast;
  2. Some PHP knowledge;
  3. FireBug (optional) might help in this task, in case you the PHP fields adds javascript code as well;

Read more: PHP

Radiobox (aka Radio Groups)

<input> elements of type radio are generally used in radio groups—collections of radio buttons describing a set of related options. Only one radio button in a given group can be selected at the same time. Radio buttons are typically rendered as small circles, which are filled or highlighted when selected.

Example

Read more: Radiobox (aka Radio Groups)

Select List (aka Dropdown list)

A select list (also known as drop-down list) is a form element that allows the user to select an option from a range of options.

Example: 

Usage:

Go to Components → Contact Enhanced → Form Fields, click on the New button, then set the Form Field Type to Select List.

Edit Custom Field Value by adding a new row for each new option. The first option is the field's value and the second is the label. 

Read more: Select List (aka Dropdown list)

Select Recipient

{gdata id=|tI4UVcaT1uE|}

Value:

email::Description separeted by |

Value example:

sales@mycompany.com::Sales Department  |

support@mycompany.com::Support Department

Output:

Subject

{gdata id=|4g-KZdpjb1g|}

Value:

  1. Blank;
  2. Some text or Values separated by | (if you want to display as a select list)
  3. If the Form Field is set to hide you can add any Form Field input in the Subject by adding the following syntax {ALIAS} where ALIAS is the Form Field ALIAS; The {ALIAS} cannot be a checkbox Form Field;

Subject Form Field Parameters

With the Subject Form Field type you have four options of prefix, which will be added after the field is submitted:

  1. None: No prefix will be added;
  2. Custom Text: You can add your custom text for the prefix. You can also add any Form Field input {name}, {email}, {user_ip} or any other form field with the following syntax {ALIAS} where ALIAS is the Form Field ALIAS; The {ALIAS} cannot be a checkbox;
  3. Site Name: Will prepend the site name to the subject;
  4. Current Content Title: In case the form is embeded in an article using the Content plugin, this option will prepend the content title to the subject;

Using Form Fields in Multiple Languages

 

Description

How to display Custom Fields in multiple languages;

Requirement

  1. Have Joomla Multi-lingual plugins enabled;
  2. Have created the language content in Joomla! Admin -> Extensions -> Language Manager;
  3. Joomla 1.6 and newer;

Usage

 

When you first install Contact Enhanced, all Form Fields are set to ALL languages. So first, you need to copy the current Form Fields to one of the languages.

Batch Process:

Go to Components -> Contact Enhanced -> Form fields, Select ALL Fields you need in multiple Languages, then click on the Batch button and move the fields to the new language.

One by one:

Go to Components -> Contact Enhanced -> Form fields, open the original form field set the language to English (or another language) under the Publishing Info slider and then change the name of the field for the new language and set the language to the chosen one and hit Save as a Copy and you are done.

 

Joomla 1.5:

In Joomla 1.5 it is a bit more complicated because it requires you to use Joom!Fish and it cannot translate multiple database tables per component. Please read this forum post.

Displaying Form Fields in Recorded Messages

Description

You can display one or more Custom Fields in the Components → Contact Enhanced →Recorded Messages (back-end)list.

Requirement

  1. Contact Enhanced 3.2+;

Usage

Select Components → Contact Enhanced → Form Fields from the drop-down menu on the back-end of your Joomla! installation. Then  under the General Parameters tab set Show on Recorded Messages to Show;

Displaying Form in Multiple Responsive Columns

Description

How to display Form Fields in multiple columns.

Requirement

  1. Have setup and Category and Contact;
  2. Have watched the Form Fields -> Basic Features screencast;

Usage

Go to Components -> Contact Enhanced -> Form Fields.

1. Edit each Custom Field and under the General Parameters tab set the Width type to either Bootstrap OR Percentage.
Set to Bootstrap if your template is compatible with Bootstrap javascript library and if you want your form to be responsive.

2. Adjust the Field's Container Width to the desired number of columns.

You have to perform steps 1 and 2 for each custom field.

Keep in mind that the field order will be from left to right (top->bottom), so you can have multiple columns. Please see screenshot below for example.

You might also create a CSS Custom Field and add the CSS rule below to make the fields take the full width;

.ce-cf-container{width:95%}

Screenshot

Contact Enhanced Form


Copyright © 2018 IdealExtensions.com. 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.
Feedback