cforms II.', 'cforms'); ?>

»
»
»
- »
- »
- »
- »
»
»
»
»
»
»

1.

cforms is not the easiest form mailer plugin but it may be the most flexible. The below outline should help you get started with the default form.', 'cforms'); ?>

default form', 'cforms'),'?page=' . $plugindir . '/cforms-options.php#anchorfields'); ?>
- if an email address is expected for input) and/or "Auto Clear" (if the field default value needs to be cleared upon focus).', 'cforms'); ?>
- Q&A, captcha add an input field accordingly and configure here.', 'cforms'),'#qa','onclick="setshow(19)"','#captcha','onclick="setshow(19)"','?page=' . $plugindir . '/cforms-global-settings.php#visitorv','onclick="setshow(13)"'); ?>
email admin for your form is configured correctly.', 'cforms'),'?page=' . $plugindir . '/cforms-options.php#anchoremail','onclick="setshow(2)"'); ?>
auto confirmation message upon form submission.', 'cforms'),'?page=' . $plugindir . '/cforms-options.php#autoconf','onclick="setshow(5)"'); ?>
to track form submission via the database?', 'cforms'),'?page=' . $plugindir . '/cforms-global-settings.php#tracking','onclick="setshow(14)"'); ?>
Add the default form to a post or page.', 'cforms'),'#inserting','onclick="setshow(18)"'); ?>

2.

Pages/Posts.', 'cforms'),'',''); ?>

Button Support is enabled!).', 'cforms'),'?page=' . $plugindir . '/cforms-global-settings.php#wpeditor','onclick="setshow(12)"'); ?>

insert_cform();','insert_cform(\'X\');'); ?>

X','2, 3,4'); ?>

3.

formats for their associated Field Names. Form labels (Field Names) permit the use of HTML, see examples below.', 'cforms'); ?>

Field Names are usually just the label of a field (e.g. "Your Name"), they can contain additional information to support special functionality (e.g. default values, regular expressions for extended field validation etc.)', 'cforms'); ?>

wizard like mode allows you to configure more complex settings in case all the pipes "|" and pounds "#" are overwhelming.', 'cforms'); ?>

Tell A Friend input fields', 'cforms'); ?>
WP Comment Feature input fields', 'cforms'); ?>

field', 'cforms'); ?>

	\|'); ?>
	`\|mytextclass\|font-size:9x; font-weight:bold;`

text paragraph supports HTML. If you need actual <, > in your text please use the proper HTML entity.', 'cforms'); ?>
mytextclass" AND the specific styles "`font-size:9x; font-weight:bold;`" to the paragraph.', 'cforms'); ?>
css class, you also need to define it in your current form theme file, here.', 'cforms'),'?page=' . $plugindir . '/cforms-css.php'); ?>

field', 'cforms'); ?>

regular expression', 'cforms'),'|','#regexp'); ?>

|mm/dd/yyyy|^[0-9][0-9]/[0-9][0-9]/[0-9][0-9][0-9][0-9]$

default value of "mm/dd/yyyy" so users know the expected format. The regexp at the end ensures that only this format is accepted. NOTE: You also need to configure the date picker options to match the date format ("MM/dd/yyyy" !)', 'cforms'),'?page=' . $plugindir . '/cforms-global-settings.php#datepicker','onclick="setshow(9)"'); ?>

field', 'cforms'); ?>

	regular expression', 'cforms'),'\|','#regexp'); ?>
	`#\|xxx-xx-xxx\|^[0-9A-Z-]+$`
	`\|\|^[A-Za-z- \.]+$`
	`<acronym title="</acronym>`
default value, the syntax would as in Example 2.', 'cforms'); ?>

field', 'cforms'); ?>

	#','\|'); ?>

field name will result in not showing a label to the left of the field.', 'cforms'); ?>
option placeholder determines the text displayed to the visitor, value what is being sent in the email.', 'cforms'); ?>
value explicitly given, then the shown option text is the value sent in the email.', 'cforms'); ?>
Select box marked "Required": Using a minus symbol %1$s as the value (after %2$s), will mark an option as "not valid"! Example: `Your age#Please pick your age group\|-#12 to 18\|kiddo#19 to 30\|young#31 to 45#45+ \|older`. "Please pick..." is shown but not considered a valid value.', 'cforms'),'`-`','\|'); ?>

field', 'cforms'); ?>

	#','\|'); ?>


Required. If so and unless at least one option is selected the form won\'t validate.', 'cforms'); ?>
value1,2,.. are not specified, the values delivered in the email default to `option1,2,...`.', 'cforms'); ?>
red\|#ff0000', 'cforms'); ?>

field', 'cforms'); ?>

	left %s field name right', 'cforms'),'#'); ?>

#label-right-only).', 'cforms'); ?>
both left and right labels are provided, only the right one will be considered.', 'cforms'); ?>
Required" to support special use cases, e.g.: when you require the visitor to confirm that he/she has read term & conditions, before submitting the form.', 'cforms'); ?>

field', 'cforms'); ?>

	#','\|','##'); ?>

##) in a row will force a new line! This helps to better structure your check box group.', 'cforms'); ?>
multi-select boxes (see above), Check box groups allow you to deploy several check boxes (with their labels and corresponding values) that form one logical field. The result submitted via the form email is a single line including all checked options.', 'cforms'); ?>
value (text after the pipe symbol \'%1$s\') is specified, the provided check box label is both label & submitted value.', 'cforms'),'\|'); ?>

field', 'cforms'); ?>

	left %s field name right', 'cforms'),'#'); ?>

no additional auto confirmation email (if configured) is sent out!', 'cforms'),'?page=' . $plugindir . '/cforms-options.php#autoconf','onclick="setshow(5)"'); ?>
check boxes above.', 'cforms'); ?>

field', 'cforms'); ?> here!!', 'cforms'),'?page='.$plugindir.'/cforms-options.php#anchoremail','onclick="setshow(2)"'); ?>

	#'); ?>

directly corresponds with the order of email addresses configured here.', 'cforms'),'?page=' . $plugindir . '/cforms-options.php#anchoremail','onclick="setshow(2)"'); ?>

field', 'cforms'); ?>

	\|'); ?>
	`\|fixed,hidden text`
	`\|{custom_field_1}`
{variables} which reference custom fields of posts or pages.', 'cforms'); ?>

field', 'cforms'); ?>



field name required, the field has no configurable label per se, as it is determined at run-time from the list of Question & Answers provided here.', 'cforms'),'?page=' . $plugindir . '/cforms-global-settings.php#visitorv','onclick="setshow(13)"'); ?>
New Fieldset field before this one.', 'cforms'); ?>

field', 'cforms'); ?>




Visitor verification feature, you can have the visitor provide a captcha response.', 'cforms'); ?>

field', 'cforms'); ?>



general settings for proper configuration of the `File Upload` functionality (allowed extensions, file size etc.).', 'cforms'),'?page='.$plugindir.'/cforms-global-settings.php#upload','onclick="setshow(11)"'); ?>

field', 'cforms'); ?>

of all 4 fields', 'cforms'); ?>	regular expression', 'cforms'),'\|'); ?>
	`(make sure it\'s checked \'Email\')', 'cforms'); ?>` `(make sure it\'s checked \'Email\')', 'cforms'); ?>`
Tell A Friend feature needs to be enabled for the respective form (check if it\'s the right one!), otherwise you won\'t see the above input fields in the [Field Type] select box.', 'cforms'),'?page='.$plugindir.'/cforms-options.php#tellafriend','onclick="setshow(6)"'); ?> auto confirmation message will be used as a message template and needs to be defined. See example below.', 'cforms'),'?page='.$plugindir.'/cforms-options.php#cforms_cmsg','onclick="setshow(5)"'); ?> three additional, predefined variables that can be used in the message template.', 'cforms'),'#tafvariables','onclick="setshow(23)"','?page='.$plugindir.'/cforms-options.php#cforms_cmsg','onclick="setshow(5)"'); ?> Add the form to your post/page php templates (see deployment options further below).', 'cforms'); ?> enable your posts/pages by checking the T-A-F field in the WP post (page) editor.', 'cforms'); ?>

auto confirmation message as a Tell-A-friend template:', 'cforms'),'?page='.$plugindir.'/cforms-options.php#cforms_cmsg','onclick="setshow(5)"'); ?>
`, {Title}: {Excerpt} {Permalink} --`


Alternative 1: The actual form will not show on the WP front page, but in the individual post/page view.', 'cforms'); ?> <?php insert_cform(#); ?> (# = your form id) to your existing `single.php` and/or `page.php` template, e.g:', 'cforms'),'#inserting','onclick="setshow(18)"');?> `[...] <?php the_content('<p>Read the rest of this entry »</p>'); ?> <?php if ( is_tellafriend( $post->ID ) ) insert_cform(#); ?> [...]`
Alternative 2: A Tell-A-Friend link is shown under every eligible post/page, displayed both on the blog\'s front page & individual post & page view.', 'cforms'); ?> page template:', 'cforms'); ?> `[...] <?php the_content('<p>Read the rest of this page »</p>');?> <h3> <?php echo 'E-Mail "'.get_the_title( $_GET['pid'] ).'" to a friend:'; ?> </h3> <?php if ( is_tellafriend( $_GET['pid'] ) ) insert_cform(#); ?> [...]` single.php & index.php and/or page.php add beneath the "the_content()" call the link to the new page created above, e.g.:', 'cforms'); ?> `[...] <?php the_content('<p>Read the rest of this entry »</p>'); ?> <?php if ( is_tellafriend( $post->ID ) ) echo '<a href="[your-new-page]?&pid='.$post->ID.'" title="Tell-A-Friend form">Tell a friend!</a>'; ?> [...]` [your-new-page] with the permalink of your newly created page.', 'cforms'); ?>

field', 'cforms'); ?>

of all 4 fields', 'cforms'); ?>	regular expression', 'cforms'),'\|'); ?>


	comment %2$s 0 %1$s text to author %2$s 1', 'cforms'),'#','\|'); ?>
:


WP Comment feature for the given form. (Make sure it\'s the right one!), otherwise you won\'t see the above input fields in the [Field Type] select box.', 'cforms'),'?page='.$plugindir.'/cforms-options.php#commentrep','onclick="setshow(7)"'); ?> form tag and usually anything in-between (`<form action="...</form>`). Instead replace with a PHP call to cforms: `<?php insert_cform(X); ?>` with X being omitted if the form is your default form or starting at \'2\' (with single quotes!) for any subsequent form #.', 'cforms'); ?> WP comment feature settings here (especially the Ajax specific ones!). ', 'cforms'),'?page='.$plugindir.'/cforms-global-settings.php#wpcomment','onclick="setshow(28)"'); ?> '.__('Important:','cforms').' '; _e('To make Ajax work in case there are no comments yet, make sure that the comment container is always being rendered.', 'cforms'); ?>
wide_form.css theme under the Styling menu. And adjust to your liking.', 'cforms'),'?page='.$plugindir.'/cforms-css.php'); ?> required" to the input field label and set this style: `span.reqtxt, span.emailreqtxt {...` to `display:none;` (using the CSS editor on the Styling page)', 'cforms'); ?>

field', 'cforms'); ?>



New Fieldset field between or before your form elements.', 'cforms'); ?>
New Fieldset element will automatically close the existing (if there is one to close) and reopen a new one.', 'cforms'); ?>
End Fieldset can be used, but it works without just as well.', 'cforms'); ?>
End Fieldset element, the plugin assumes that it needs to close the set just before the submit button', 'cforms'); ?>

field', 'cforms'); ?>

	\|'); ?>
US zip code', 'cforms'); ?>	`\|\|^\d{5}$)\|(^\d{5}-\d{4}$`
US phone #', 'cforms'); ?>	`\|\|^[$]?(\d{0,3})[$]?[\s]?[\-]?(\d{3})[\s]?[\-]?(\d{4})[\s]?[x]?(\d*)$`
comparing two input fields', 'cforms'); ?>	`\|\|cf2_field2`

Required\'!', 'cforms'); ?>
`^` `$`
"`ab*`":
"`ab+`":
"`[a-d]`":
here, a great regexp repository here.', 'cforms'),'http://weblogtoolscollection.com/regex/regex.php','http://regexlib.com'); ?>
'.__('Important:','cforms').'';?> If you would like to compare two input fields (e.g. email verification): simply use the regexp field (see special example above, to point to the HTML element ID of the field you want to compare the current one to. To find the HTML element ID you would have to look into the html source code of the form (e.g.', 'cforms'); ?> `cf2_field2`).

4.

|title:XXX'); ?>

success and error messages) for your input fields, simply append a %s to a given definition string/field name. HTML is supported.', 'cforms'),'?page=' . $plugindir . '/cforms-options.php#cforms_success','onclick="setshow(1)"','?page=' . $plugindir . '/cforms-options.php#cforms_failure','onclick="setshow(1)"','|err:XXX'); ?>

|title:XXX','|err:XXX');?>

	\|title:','\|err:',''); ?>




Custom error messages can be applied to any input field that can be flagged "Required", titles to any input field.', 'cforms'); ?>

5.

real-time manipulation of a form & fields are required.', 'cforms'); ?>

my-functions.php file (plugin root directory), including examples.', 'cforms');?>


`my_cforms_filter()`	`after user input validation and cforms processing', 'cforms'); ?>`
`my_cforms_ajax_filter()`	`after input validation, but before further processing', 'cforms'); ?>`
`my_cforms_action()`	`after input validation, but before further processing', 'cforms'); ?>`

6.

non-Ajax mode.', 'cforms');?>
a base form defined in the cforms form settings. All its settings will be used, except the form (&field) definition.', 'cforms');?>
HELP! section can be dynamically generated.', 'cforms');?>

insert_custom_cform($fields:array,$form-no:int); ');?>

$form-no: 2,3,4... for any subsequent form', 'cforms'); ?>
$fields :


	            $fields['label'][n]      = '';           field name format described above', 'cforms'); ?>
	
	            $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;
	            $fields['isreadonly'][n] = true|false;             default: false;
	
	            n = 0,1,2...


:	`textonly`	:	`yourname`
:	`textfield`	:	`youremail`
:	`textarea`	:	`friendsname`
:	`hidden`	:	`friendsemail`
:	`pwfield`
:	`datepicker`
:	`checkbox`	:	`author`
:	`checkboxgroup`	:	`email`
:	`selectbox`	:	`url`
:	`multiselectbox`	:	`comment`
:	`radiobuttons`	:	`send2author`
^*):	`ccbox`
^*):	`emailtobox`
^*):	`verification`
^*):	`captcha`
^*):	`upload`
:	`fieldsetstart`
:	`fieldsetend`

^*) once per generated form!', 'cforms'); ?>


$fields = array();

$formdata = array(	
		array('','textfield',0,1,0,1,0),
		array('','textfield',0,0,1,0,0),
		array('','textarea',0,0,0,0,0)
		);
				
$i=0;
foreach ( $formdata as $field ) {
	$fields['label'][$i]        = $field[0];
	$fields['type'][$i]         = $field[1];
	$fields['isdisabled'][$i]   = $field[2];
	$fields['isreq'][$i]        = $field[3];
	$fields['isemail'][$i]      = $field[4];						
	$fields['isclear'][$i]      = $field[5];						
	$fields['isreadonly'][$i++] = $field[6];		
}

insert_custom_cform($fields,'');    //

More advanced example (file access)', 'cforms'); ?>:


$fields['label'][0]  ='';
$fields['type'][0]   ='textfield';
$fields['isreq'][0]  ='1';
$fields['isemail'][0]='0';
$fields['isclear'][0]='1';
$fields['label'][1]  ='';
$fields['type'][1]   ='textfield';
$fields['isreq'][1]  ='0';
$fields['isemail'][1]='1';
$fields['label'][2]  ='||font-size:14px; padding-top:12px; text-align:left;';
$fields['type'][2]   ='textonly';

$fields['label'][3]='|-#';

$fp = fopen(dirname(__FILE__).'/months.txt', "r"); //  

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

fclose ($fp);

$fields['label'][3]  = substr( $fields['label'][3], 0, strlen($fields['label'][3])-1 );  // 
$fields['type'][3]   ='selectbox';
$fields['isreq'][3]  ='1';
$fields['isemail'][3]='0';

insert_custom_cform($fields,5);    //

month.txt containing all 12 months of a year:', 'cforms'); ?>

```
...
```

7.

subjects and messages for emails both to the form admin as well as to the visitor (auto confirmation, CC:) support insertion of pre-defined variables and/or any of the form input fields.', 'cforms'),'?page=' . $plugindir . '/cforms-options.php#anchoremail','onclick="setshow(2)"','?page=' . $plugindir . '/cforms-options.php#autoconf','onclick="setshow(5)"'); ?>


{BLOGNAME}
{Form Name}
{Page}
{Date}
{Time}
{IP}
{ID}
{CurUserID}
{CurUserName}
{CurUserEmail}
	`.`"'); ?>

{Permalink}
{Author}	`Nickname).', 'cforms'); ?>`
{Title}
{Excerpt}
field name: Example: The default form comes with a %1$sYour Name%2$s and %1$sWebsite%2$s field.', 'cforms'),'',''); ?> ',''); ?>

'.__('Important:','cforms').' '; _e('If you are using multiple input fields with the same recorded field label (you can always check the "Tracking" menu tab for how the fields are stored), e.g:', 'cforms'); ?>


Size#250gr.#500gr#1kg circa
Size#450gr.#700gr#1.2kg circa
Size#650gr.#800gr#1.5kg circa

Size\'','{Size}','{Size__2}'); ?>

Admin HTML message (you can copy and paste the below code or change to your liking):', 'cforms'),'?page=' . $plugindir . '/cforms-options.php#cforms_header_html','onclick="setshow(3)"'); ?>
<p style="background:#fafafa; text-align:center; font:10px arial">' . sprintf(__('a form has been submitted on %s, via: %s [IP %s]', 'cforms'),'{Date}','{Page}','{IP}') . '</p> '; ?>
' . __('a form has been submitted on June 13, 2007 @ 9:38 pm, via: / [IP 184.153.91.231]', 'cforms') . ' '; ?>

Admin HTML message:', 'cforms'),'?page=' . $plugindir . '/cforms-options.php#cforms_header_html','onclick="setshow(3)"'); ?>
<p>'.__('{Your Name} just submitted {Form Name}. You can get in touch with him/her via <a href="mailto:{Email}">{Email}</a> and might want to check out his/her web page at <a href="{Website}">{Website}</a>', 'cforms') . '</p> <p>' . __('The message is:', 'cforms') . '<br/ > '.__('{Message}', 'cforms') . '</p> '; ?>
' . __('John Doe just submitted MY NEW FORM. You can get in touch with him/her via john.doe@doe.com and might want to check out his/her web page at http://website.com', 'cforms') . ' '; ?> ' . __('The message is:', 'cforms') . ' '; ?> '; ?>

HTML auto confirmation message:', 'cforms'),'?page=' . $plugindir . '/cforms-options.php#cforms_cmsg_html','onclick="setshow(5)"'); ?>

<div style="text-align:center; color:#aaa; border-bottom:1px solid #aaa"> <strong>' . __('auto confirmation message', 'cforms') . ', {Date}</strong> </div><br />

'; ?> '; ?> '; ?> '; ?>

' . __('auto confirmation message', 'cforms') . ', June 13, 2007 @ 5:03 pm
'; ?> ' . __('Dear John Doe,', 'cforms') . '

'; ?> ' . __('Thank you for your note!', 'cforms') . '

'; ?> ' . __('We will get back to you as soon as possible.', 'cforms') . '

'; ?>

8.

Styling page for theme selection and editing options.', 'cforms'),'?page=' . $plugindir . '/cforms-css.php'); ?>

your forms!) but you can of course create your own theme file -based on the default cforms.css file- and put it in the /styling directory.', 'cforms'); ?>

PDF guide on cforms CSS & a web screencast I put together to give you a head start.', 'cforms'),'http://www.deliciousdays.com/cforms-forum?forum=1&topic=428&page=1'); ?>

doesn\'t look like the preview image, or your individual changes don\'t take effect, check your global WP theme CSS! It may overwrite some or many cforms CSS declarations. If you don\'t know how to trouble shoot, take a look at the Firefox extension "Firebug" - an excellent CSS troubleshooting tool!', 'cforms'); ?>

9.

cforms forum and comment section on the plugin homepage.', 'cforms'); ?>