/*
*
* EasyAjax_Form Script
*
* Copyright 2009 John Stevens.
*
* Get this script at Themeforest.net :
* http://themeforest.net/item/easyajax_form/57497
*
* Requires jQuery 1.3+
*
* version 5.5
*
*/
EasyAjax_Form = function () {
/*
* Configuration Options
*/
var config = {};
config = {
errorMsgs: {
required: '*Required',
email: 'Please enter a valid email address.',
phone: 'Example: 111-222-3333.',
lengthInput: '50 or fewer characters for this field.',
lengthText: '5000 or fewer characters for this field.',
ruHuman: 'Incorrect single digit number',
ajaxTimeout: 'An error occurred when saving your request, please try again.' +
'If this problem persists, please try again later.'
},
ruHuman: {
answer: '4'
},
fades: {
validation: 200, /*The time it takes validation messages to fade in.*/
ajax: 10 /*The time it takes ajax communicaiton to fade in and out.*/
},
ajaxTimers: {
pause: 10, /*Ajax message sent to server is delayed by this amount.*/
timeout: 10000 /*Will return the ajax_timeout error message if no server response in this amount of time*/
},
valClasses: { /*Customize the class names used in the HTML that will trigger Validation actions in this script.*/
requiredField: 'REQUIRED',
emailField: 'EMAIL',
phoneField: 'PHONE',
charLengthInput: 'LENGTH_INPUT', /*Default is 50 characters, useful for regular input fields*/
charLengthText: 'LENGTH_TEXT', /*Useful for text areas. Default is 5000 characters (about 800 words) */
optionalField: 'OPTIONAL',
ruHumanField:'RU_HUMAN'
},
formClasses: { /*Customize the class names used in the HTML that will trigger Ajax actions in this script*/
validateOnly: 'VALIDATE',
ajaxOnly: 'AJAX',
disable: 'DISABLE',
choose: 'CHOOSE'
},
cssSelectors: { /*Customize class & ID names used in the CSS file. Make sure to update the CSS file if you change these*/
validationPass: 'PASS',
validationFail: 'FAIL',
ajaxLoading: '#FORM_LOAD', /* # needed as it is used as a jQuery selector in this script, this is an ID.*/
ajaxTimeout: "AJAX_TIMEOUT", /*Reccomend keep double quotes*/
ajaxResponse: "AJAX_RESPONSE" /*Reccomend keep double quotes*/
},
regExps: { /*Contains regular expressions used later in the script*/
email: /^\w+([\.\-]?\w+)*@\w+([\.\-]?\w+)*(\.\w{2,3})+$/,
phone: /^\(?(\d{3})\)?[\.\-\/ ]?(\d{3})[\.\-\/ ]?(\d{4})$/
},
charLimit: {
input: 50,
textArea: 5000
}
};
/*
* I use the jQuery $.each function for looping in this script. I find it easier to read and work with
* and it does all the necessary type checking, etc behind the scenes. In my mind it is well worth the
* slightly, slightly, slightly slower processing. In my experience I've seen no perceptible performance
* difference.
*
* See the following url for more information on $.each :
* http://docs.jquery.com/Utilities/jQuery.each
*/
/*
* General Helper Functions
*/
function appendSpan(allFields) { /*Appends an empty span element after each form field found in the HTML*/
$.each(allFields, function (i, field) {
$('').insertAfter(this);
});
}
function hasClassArray_maker(currentField, formLevel) { /*Populates the HasClass Array for a given form field when needed.*/
var hasClassArray = [],
Classes = config.valClasses,
j = 0;
if (formLevel) { /*Makes the second paramenter optional. Is passed true from the init function, null for validation uses*/
Classes = config.formClasses;
}
$.each(Classes, function (k, currentClass) {
if ($(currentField).hasClass(currentClass)) {
hasClassArray[j] = currentClass;
j = j + 1;
}
});
return hasClassArray;
}
function fieldProperty_maker(currentField) {
var valTypes = config.valClasses, /*The keys of valClasses object will describe all possible field properties*/
fieldProperties = {};
$.each(valTypes, function (l, currentType) {
fieldProperties[l] = false;
});
return fieldProperties;
}
function calcFieldProperties(fieldProperties, hasClassArray) { /*Based on classes present, determines what validation is indicated*/
$.each(hasClassArray, function (m, currentClass) {
switch (currentClass) {
case config.valClasses.emailField:
fieldProperties.emailField = true;
break;
case config.valClasses.requiredField:
fieldProperties.requiredField = true;
break;
case config.valClasses.phoneField:
fieldProperties.phoneField = true;
break;
case config.valClasses.charLengthInput:
fieldProperties.charLengthInput = true;
break;
case config.valClasses.charLengthText:
fieldProperties.charLengthText = true;
break;
case config.valClasses.ruHumanField:
fieldProperties.ruHumanField = true;
default:
break;
}
});
return fieldProperties;
}
function boolObjDecoder(boolObj, retFalseIf) { /*Returns false if any value in the object is equal to the second paramenter (true or false)*/
var x = 0;
$.each(boolObj, function (p, currentBool) {
var booleanKeepGoing;
if (currentBool === retFalseIf) {
x = 1;
booleanKeepGoing = false;
}
});
if (x === 1) {
return false;
}
return true;
}
/*
* Ajax Helper Functions
*/
function ajaxError(daddy, thisForm) { /*Is called in the case of a timeout error*/
$(config.cssSelectors.ajaxLoading).fadeOut(config.fades.ajax / 4, function () {
$(this).remove();
});
$('' +
'
' + config.errorMsgs.ajaxTimeout + '
' +
'
' +
'
Click here to re-enter form information.
' +
'
' +
'
' + serverResponse + '
' +
'