/*
Copyright 2006-2007  Oliver Seidel   (email : oliver.seidel@deliciousdays.com)
/*

v4.5 (maintenance, bug fixes and enhancements)
*) NOTE: the format for check box groups has been enhanced, see HELP!
*) feature: (optional) ID's for labels for even greater level of customization!
*) bugfix: "Subject for Email" could not be saved "Is Required"
*) other: "Subject for Email", user definable subject is now appended
*) other: "Subject for Email" is now part of the email form submission body
*) other: form structure re-done! XHTML'fied; much more robust now
*) other: streamlined CSS
*) other: added a warning msg re: "Show messages" settings

v4.1 (features)
*) feature: support for shown but disabled form element
*) feature: "user message" positioning, now optionally at the bottom of the form
*) feature: "multi-select" via check boxes, grouped check boxes
*) feature: new special field: subject field
*) other: revised and cleaned up Help! section

v4 (feature & bugfix)
*) feature: captcha support for additional SPAM protection
*) feature: select & configure stylesheets via admin UI
*) bugfix: IE margin-bottom hover bug
*) bugfix: deleting form fields (on the general form config page) was broken due a 
     new bug that was introduced as part of the localization effort
*) other: change the INSERT queries using LAST_INSERT_ID() due to overly sensitive
     SQL servers.

v3.5 (mostly maintenance)
*) feature: slightly enhanced Tracking page ("delete" now also removes attachments)
    tracking data view now permits selective deletion of submission entries
*) feature: text fields can optionally be auto cleared on focus (if browser is JS enabled)
*) feature: attachments (uploads) are now stored on the server and can be accessed 
    via the "Tracking" page
*) feature: added optional ID tracking to forms (& emails sent out)
*) bugfix: editor button wouldn't show due to wrong image path
*) bugfix: order of fields on the "Tracking" page fixed, to ensure an absolute order
    NOTE: as part of the install/update either deactivate/reactive the plugin or delete 
    the existing Tracking tables, to make use of the new table structure)
*) bugfix: due to a WP bug, the use of plugin_basename had to be adjusted
*) bugfix: fixed support for non-utf8 blogs ( mb_convert_encoding etc.)
*) other: code cleanup (big thanks to Sven!) to allow proper localization
			current languages supported: 
			English, default
			German, provided by Sven Wappler
*) other: changed data counter (column 1) on the Tracking page to reflect unique 
    form submission ID, that a visitor could possibly reference.

v3.4
*) feature: multi-select fields
*) feature: dynamic forms (on the fly form creation)
*) bugfix: minor display bug on admin page: "add new field" button
*) bugfix: fixed a CSS bug to better support 3 column WP themes 
   (w/ middle column not floated)

v3.3
*) feature: "file upload field" can now be mandatory
*) feature: additional select box for more intuitive form selection
*) drop down "-" option for multi recipients
*) bugfix: select (drop down) boxes did not save values for non ajax method
*) bugfix: when using "multi-recipients" field & first entry used, email would
   still go out to everyone
*) bugfix: charsets other than UTF-8 caused issues with special characters in emails
*) other: added form name as hover text for form buttons

v3.2.2
*) feature: most attachment types (images, docs etc) are now recognized
*) bugfix: not really a bug, but no "extra" attachments anymore
*) bugfix: more special characters in response messages

v3.2
*) feature: file upload; only works with non-ajax send method (chosen autoamtically)
   due to HTML constraints. ajax support does NOT need to be explicitly disabled
*) feature: select boxes (drop downs) now can be "required" -> to support situations,
   where you don't want a default value to kick in, but want the visito to make a choice!
   see HELP! section for more info on how to use this new feature
*) feature: checkboxes : now can be "required" -> for "I have read the above" type
   scenarious, where the user has to comply/agree to a statement
*) feature: radio buttons, you can now click on the labels to toggle the selection
*) feature: radio & select boxes (drop down): now accept a "display value" & a "submit value"
   see HELP! section for more info
*) feature: "submit button" is now disabled after sending to prevent multiple
   submissions in case the web servers response is delayed (Ajax!)
*) feature: download supports both CSV and TXT (tab delimited)
*) bugfix: time correction in email (now considers blog time/date configuration)
*) bugfix: failure and success msgs would not show special characters properly
*) bugfix: “database tables found msg” would always show when settings were saved
*) bugfix: labels (left of an input field) would not display special chars correctly
*) other: renamed a few functions to avoid conflicts with other plugins
*) other: modified checkboxes: text to the right is by default "clickable"
*) other: W3C XHTML compliance now fully supported even when using REG EXPRESSIONS!

v3
*) bugfix: changed the priority of the plugin: fixes layout issues due to wpautop
*) bugfix: fixed ajax (email) issues with CC: and Visitor verification fields
*) bugfix: fixed a few minor layout issues
*) UI: new admin uinterface
*) feature: full support for  for role-manager support, see here for a current release:
   http://www.im-web-gefunden.de/wordpress-plugins/role-manager/
*) feature: database tracking of form input & download as a CSV file
*) feature: backup and restore individual form settings (doesn't affect plugin-wide settings)
*) feature: erase all cforms data before deactivating/uninstalling the plugin
*) feature: added a new special field: "textonly" to add fully customizable paragraphs to your forms
*) feature: verification question to counteract spam
*) feature: custom regular expressions for single line input fields
   usage: separate regexp via pipe '|' symbol:  fieldname|defaultval|regexp
		        e.g. Phone|+49|^\+?[0-9- \(\)]+$
*) new menu structure (now top level menu!)
*) admin code clean up
*) verification codes accept answers case insensitive

v2.5
*) feature: multiple email recipients ("form admins"): mass sending & selective sending by
   (visitor)
*) CFORMS.CSS includes custom settings for form #2 (to see it in action, create a second 
   form (#2) with one FIELDSET and a few input fields)
*) feature: order of fields; fields can now be sorted via drag & drop
*) feature: forms can be duplicated
*) Fully integrated with TinyMCE & code editor. FF: hover over form placeholder and form 
   object will be displayed. IE: select form placeholder and click on the cforms editor 
   button
*) feature: default values for line & multi line input fields: use a "|" as a delimiter
*) UI: "Update Settings" returns directly to config section
*) bugfix: quotes and single quotes in input fields fixed
*) bugfix: adding/deleting fields will respect (=save) other changes made
*) UI: all form fields can now be deleted up until the last field
*) feature: CC optional for visitor / if CC'ed not auto confirmatin will be sent add'l
*) feature: enhanced email layout - supporting defined fieldset
*) feature: REPLY-TO set for emails to both form admins & visitors (CC'ed)
*) non ajax form submisssion: page reloads and now jumps directly to form (& success msg)
*) code clean up and a handful of minor big fixes

v2.1.1
*) bugfix: IE not showing AJAX / popup message stati
*) bugfix: send button jumping to the left after submitting
*) check boxes: text can now be displayed both to the left and right

v2.1
*) fieldsets are now supported: CSS: .cformfieldsets addresses all sets,
		cformfieldsetX (with X=1,2,3...) individual ones.
*) form code clean-up: more standardized with a minimum on necessary elements and
		got rid of all the legacy DIVs
*) javascript has been "outsourced" making your html so much nicer :)

v2
!!) when upgrading to v2:
		!) please edit each form on your plugins config page to verify that the email
			field is checked with "Is Email" to ensure email verification
*) additional form fields: checkboxes, radio buttons and select fields
		*) please note the expected "Field Name" entry format, separating input field items
		   form the field name: i.e. radio buttons: field-name#button1#button2#button3#...
*) ajax support can be optionally turned off
*) a form can now have as few input fields as two
*) more flexibilty in choosing email entry field. NOTE: if you have multiple email
		fields in your form, only the first will be used for sending the auto confirmation to
*) "valid email required" placeholder added to indicate required input format for email fields
*) optional popup window for user messages (may be helpful for very long forms)
*) code cleanup

v1.90
*) email header correction: "From:" doesn't claim to be visitor's email
address anymore this should fix most paranoid mail server

v1.81
*) form name added for either email filtering or simply better differentiation
*) admin email: can now be just "xx@yy.zz" or "abc <xx@yy.zz>" (from name removed)
*) changes to email header: simplified and "WP compliant"
*) added to cforms.css: success and failure styles
*) bug fix related to the use of a single forms (#2 and up) and insertion of ajax code
*) FINALLY fixed "CR"s for multi-line response messages (success & failure fields)

v1.71
*) HTML bug resolved & localization for "waiting message"
*) default value for email recipient is now the blog admins' email address
*) added a function call to insert form anywhere on your blog
*) added new version support

v1.6
*) bug fixes: email/form functionality w/ standard send mechanism

v1.5
*) clean up, external css, multiple forms support & user auto confirmation