=== cforms II - contact form ===
Contributors: olivers
Donate link: http://www.deliciousdays.com/
Tags: ajax, email, secure, visitor, input, order, form, contact
Requires at least: 1.6+
Tested up to: 2.2.2
Stable tag: 5.4

cforms II is an extremely customizable, flexible & powerful contact form plugin.

== Description ==

= PREVIEW: cforms II (v5.5) =
*(to be released soon)*

* **WP Comment / Note feature** - Thanks to Rob Rice' inspiration (via the cforms forum) v5.5 will allow you to have one form as a replacement for your WP default comment form, essentially giving the user the option to leave a comment behind or simply send his note to the post author. Of course all the cforms security features and other functionality can be used on top of the special comment fields. My favorite new feature.
* **Dashboard Support** - Enable your forms individually to allow most recent entries to appear on the dashboard (requires cforms DB Tracking turned on).
* **Fancy Javascript Date Picker** - Not the food is meant, but a mini calendar popup for more convenient date entry.

and more....

For **WHAT'S NEW** and a complete version history (new features, bug fixes etc.), see [here](http://www.deliciousdays.com/cforms-forum?forum=2&topic=2&page=1).

= Description =
cforms is a highly customizable, flexible and powerful contact form plugin, covering a variety of use cases and features from attachments to multi form management, you can even have multiple forms on the same page!

= Upgrading Notes: =
For all the new features, see the Help documentation. 

= Plugin Features =
* **NEW: individual error messages (HTML enabled), see Help!**
* **NEW: Tell-A-Friend functionality, see Help!**
* Support for alternative SMTP server (in case you can't use *PHP mail()*)
* Better non-HTML (TXT only) email support
* Post processing of submitted data (see documentation) 
* Full HTML formatting support for email messages
* Customizable auto confirmation message & form email (Variables!)
* Page redirection after successful form submission
* Creates robust XHTML form code (no floats)
* Alternative form action supported (please read config info!)
* Full localization support (currently: English, German, Spanish)
* Built-in CSS editor & theme chooser
* Additional predefined CSS themes
* Multiple file attachments (upload)
* Multiple forms on one or many pages / posts
* Ajax supported form submission (w/ graceful fall-back)
* Multiple recipients per form (optionally selectable by visitor)
* Fully customizable Look & Feel (** labels & fields **)
* Role Manager support
* Backup & Restore of individual forms
* Cloning, duplication of forms
* **NEW: Tracking of submissions, searching/filtering & download of data**
* Support for tracking unique form submission IDs
* BCC to copy additional admin(s)
* 3rd party email tracking support, e.g. readnotify & didtheyreadit
* SPAM protection (Q & A + Captcha)
* **NEW: added Ajax captcha reset**
* Submission status (success/failure) optionally via Alert Box
* **NEW: HTML support for success/failure messages** 
* Form validation & *regular expressions*
* Configurable text elements
* Convenient handling of input field order, via drag and drop
* **NEW: HTML support for field labels (*field names*), see examples on Help!**
* Supporting DISABLED form fields for better usability
* Various standard form building blocks:
	* fieldsets
	* single and multi-line fields
	* select boxes (drop down)
	* multi select boxes
	* check boxes
	* grouped check boxes
	* radio buttons
* ...and a few special ones:
	* "CC me" check box for visitors
	* multiple form recipient (drop down list)
	* visitor verification Q&A
	* Captcha
* Default values for single/multi-line input fields (w/ auto clear,reset)
* Fully integrated with TinyMCE & std editor (buttons)
* Basic widget support
* Clean separation of CSS styling and form code
* Validates XHTML 1.0 Strict

= Localization =
cforms has been revised to fully support WP localization. If you'd like to contribute a language translation, please get in touch. If you have suggestions or would like to point out typos etc, please contact the actual author (see list below) of the respective localization.

* Currently, cforms includes the following language packs (besides English):
	* **French** \* Author: [La maison de l’informatiqu](http://www.deliciousdays.com/download/cformsII-fr_fr.zip)
	* **German** \* Author: [Sven Wappler](http://www.wordpressbox.de/plugins/cforms/)
	* **Hungarian** \* Author: [Ungvári Béla](http://www.deliciousdays.com/download/cformsII-hu_hu.zip)
	* **Spanish** \* Author: [Samuel Aguilera](http://agamum.net/blog/archivo/plugin-cforms-en-espanol-formularios-para-tu-wordpress.xhtml)
	* **Turkish** \* Author: M.Yasin ERDOGAN, not yet completed

== Installation ==

= Upgrading =

When upgrading to a new release, please properly deactivate the running version before installing the new files.

= Installation =

1. Download & extract plugin using its default directory
2. Upload plugin directory `/contactforms/` to the wordpress `/wp-content/plugins/` directory
3. Activate the plugin through the 'Plugins' menu in WordPress
4. *Optionally check cforms.css for indvidual styling of your forms*

= Usage =
Of course you could just use the cforms button in either TinyMCE or the std editor to insert your forms, or disregard the possibility and do it manually.

= Layout & CSS =
If you'd like to customize the default **cforms** CSS theme and are not a CSS expert, you may find [this document](http://www.deliciousdays.com/download/cforms-css-guide.pdf) helpful.

---

= Inserting a form in a posts or page =
To do so, please insert `<!--cforms-->` for the first form and/or `<!--cformsX-->` for your other forms in the code view/edit mode to include them in either your **pages** or **posts**.


= Inserting a form via the PHP function call =
Alternatively, you can specifically insert a form (into the sidebar, footer etc. ) per the PHP function call `insert_cform();` for the default (first) form and/or `insert_cform('X');` for any other, subsequent form.

_**Note**: "**X**" represents the number of the form, starting with **2**, 3,4 ..and so forth._

= Inserting a dynamic form via PHP =

**Note:**

1. Dynamic forms only work in **non-Ajax** mode.

2. Each dynamic form references and thus requires **a base form** defined in the cforms form settings. All its settings will be used, except the form (&field) definition.

3. Any of the form fields described in the plugins' **HELP!** section can be dynamically generated. 

4. **Function call** to generate dynamic forms: `insert_custom_cform($fields:array,$form-no:int);` with 

    `$form-no`: '' for the first (default) form and **2**,3,4... for any subsequent form  
    `$fields` : 
    `
	$fields['label'][n]      = 'label';                expected format described in plugin HELP! section 
	$fields['type'][n]       = 'input field type';     default: 'textfield';
	$fields['isreq'][n]      = true|false;             default: false;
	$fields['isemail'][n]    = true|false;             default: false;
	$fields['isclear'][n]    = true|false;             default: false;
	$fields['isdisabled'][n] = true|false;             default: false;

    n = 0,1,2...
    `

5. Input field types ('type'):

    text paragraph: `textonly`  
    single input field: `textfield`  
    multi line field: `textarea`  
    check boxes: `checkbox`  
    check boxes groups: `checkboxgroup`  
    drop down fields: `selectbox`  
    multi-select boxes: `multiselect`  
    radio buttons: `radiobuttons`  
    'CC' check box: `ccbox` \*)  
    Multi-recipients field: `emailtobox` \*)  
    Spam/Visitor verification (Q&A): `verification` \*)  
    Spam/Captcha: `captcha` \*)  
    File Upload fields: `upload` \*)  
    Begin of a fieldset: `fieldsetstart`  
    End of a fieldset: `fieldsetend`  

    *) should only be used **once** per generated form!

   
6. Simple example:

    `$fields = array();`
    
	`$fields['label'][0]   ='Your Name|Your Name';`
	`$fields['type'][0]    ='textfield';`
	`$fields['isreq'][0]   ='1';`
	`$fields['isemail'][0] ='0';`
	`$fields['isclear'][0] ='0';`
	
	`$fields['label'][1]   ='Your Email';`
	`$fields['type'][1]    ='textfield';`
	`$fields['isreq'][1]   ='0';`
	`$fields['isemail'][1] ='1';`
	
    `insert_custom_cform($fields,'');`


See the "**Other Notes**" section for another example.

== Frequently Asked Questions ==

Please visit the [cforms plugin forum](http://www.deliciousdays.com/cforms-forum) for up-to-date [FAQs](http://www.deliciousdays.com/cforms-forum?forum=3&page=1) and more help.

== Screenshots ==

[Please visit the cforms plugin page for screenshots & sample](http://www.deliciousdays.com/cforms-plugin)

== A more advanced dynamic form example ==

This example shows you how to store certain input field (select/drop-down box) information in a file and load it dynamically at run-time.

File: [months.txt](http://www.deliciousdays.com/download/months.txt) *(to be copied into your WP `theme` directory)*

Code: *(to go into your page.php or whereever else you want it :)*

`
$fields['label'][0]  ='Your Name|Your Name';
$fields['type'][0]   ='textfield';
$fields['isreq'][0]  ='1';
$fields['isemail'][0]='0';
$fields['isclear'][0]='1';
$fields['label'][1]  ='Email';
$fields['type'][1]   ='textfield';
$fields['isreq'][1]  ='0';
$fields['isemail'][1]='1';
$fields['label'][2]  ='Please pick a month for delivery:||font-size:14px; padding-top:12px; text-align:left;';
$fields['type'][2]   ='textonly';

$fields['label'][3]='Deliver on#Please pick a month|-#';

$fp = fopen(dirname(__FILE__).'/months.txt', "r"); // need to put this file into your themes dir!

while ($nextitem = fgets($fp, 512))		
	$fields['label'][3] .= $nextitem.'#';

fclose ($fp);
$fields['label'][3] = substr( $fields['label'][3], 0, strlen($fields['label'][3])-1 );  //remove the last '#'

$fields['type'][3]='selectbox';
$fields['isreq'][3]='1';
$fields['isemail'][3]='0';

insert_custom_cform($fields,5); 
`

*Note: This is a very flexible way of introducing dynamically changing form contents, you can just a easily query a DB table and insert the results into the `$fields` array*