ContactManager

Developer

Ideas & Pixels - Gwarrior

3rd Party (Free)


EE Version Support

  • ExpressionEngine 2

Compatibility

If an item is crossed out, it might be untested, not applicable or incompatible. Contact the developer to be sure.

  • Updater
  • Multi Site Manager
  • Stand Alone Entry Form
  • Low Variables
  • Content Elements
  • Better Workflow
  • Matrix
  • Grid
  • Webservice
  • Publisher

Requirements

  • jQuery for the Control Panel

Add-On Type(s)

Module

Tags

Helps manage contacts by deploying a form that collects data in the CP and/or emails it to users.

Introducing Contact Manager for Expression Engine 2

With the introduction of the long anticipated Expression Engine 2.0 beta, modules have already begun popping up all over the place, covering a multitude of functions. Although small in scope, we’re offering our first EE2 creation Contact Manager to the general public.

Contact Manager is a third-party module that allows developers to deploy a contact form anywhere on the website that then records data to a database and optionally emails subscribed members notification upon the contact form being submitted.

User Guide

Tags

There are two tag pairs, in the form of

{exp:contactmanager:display_form} {/exp:contactmanager:display_form}

and

{exp:contactmanager:display_message}{/exp:contactmanager:display_message}

When deployed in a template, the “display_form” tag generates the following HTML:

<form id="" class="" action="/index.php" method="post"><input type="hidden" name="ACT" value="41" /><input type="hidden" name="RET" value="" />

How it works & Parameters

When you call the tag, it displays the above form. The form submits to the main index.php file which then uses the ACT hidden field’s action id to find the accept_contact() method, which then stores the POST variables in a database, and if set in the configuration, emails a notification to subscribed members. The page where the user is sent after submission can be overwritten entirely in the module’s configuration or specified directly in the script by applying the following parameter to the template’s display_form tag:

{exp:contactmanager:display_form return="http://example.com/contact_success"}

Other parameters for the “display_form” tag include:

  • Return (return=” “) - The page you would like the user to be returned to after submission. This is not the page or function that handles the POST data.
  • Form_id (form_id=” “) - The (optional) ID you would like the form to have.
  • Form_class (form_class=” “) - The (optional) CLASS you would like the form to have.
  • Message (message=“inset”) - The (optional) way of specifying that you would like the form to include the response message.

You must also define the sub tags that you are going to use. You can apply them like this:

<input type="text" name="{name}" />

They are:

  • {type} - The type of contact.
  • {name} - The name of contact.
  • {company} - The company of contact.
  • {email} - The email of contact.
  • {phone} - The phone of contact.
  • {message} - The message of contact.

Generating a response

The actual response is delivered via flashdata, session data available only to the next page, in a session object variable that is called by using the following function in the module (the module will automatically take care of this):

$this->EE->session->flashdata(‘system_message’)

If using AJAX for a response, you must first specify your intent to do so in the configuration. After you have changed the appropriate setting, upon submission a simple message is given back (via JSON encoded data). You can specify success and failure messages in the configuration, also.

You can optionally include the response message in the form itself by using the following parameter:

{exp:contactmanager:display_form message="inset"}

If you would like to display the response message outside of the form, you can call the “display_message” tag pair.

When using this tag, you must declare one parameter. That parameter is “tagtype” (in which you declare the tag that will surround the AJAX message. It can be set like this:

{exp:contactmanager:display_message tagtype="div"}{/exp:contactmanager:display_message}

This would display:

<div id="" class=""/> </div>

If AJAX is set to ON, it will display the tags regardless. If AJAX is OFF, it will only display the tag (with system message) if the flashdata exists.

Other parameters for the “display_message” tag include:

  • Id (id=” “) - The (optional) ID you would like the form to have.
  • Class (class=” “) - The (optional) CLASS you would like the form to have.

If using AJAX, you can then hide the given tag (via class, id, tag selector) until revealed when the AJAX gets a return.

We hope that you enjoy the module and look forwards to getting comments on it. If you have suggestions, feel free to suggest them. ContactManager is currently in BETA, so it will become more full-featured as time goes on.

ContactManager Links

This entry was created March 1, 2010, 6:03 am.
This entry was last updated July 13, 2010, 5:23 pm.

Disclaimer: Information about ExpressionEngine add-ons is provided as a service to you, the user, and every member of the ExpressionEngine community. devot:ee is not responsible if you hose, mangle, wreck, or otherwise destroy your EE website by installing an add-on that you found out about at this site, regardless of its rating, Favorites status, commercial or free status, or general popularity. Caveat EEmptor!

Returns: devot:ee has a 30-day return policy on all commercial add-ons sold through devot-ee.com. If you need to return an add-on, do not go to the developer or the developer's site, but rather visit our returns page at https://devot-ee.com/returns to initiate your return. If you have questions, email support@devot-ee.com.

There are no reviews for this add-on yet.

What are you waiting for? Rate it and review it!