coreForm:

The custom tag wrapped around everything.

Attribute Required? Description
formname required name of form
template required If you are using cfmodule syntax.
maketable optional defaulted to No (N), select Yes (Y) if you want the tag to automatically generate a table for your form.
debug optional defaulted to No (N). Select if you want debuging information shown at the bottom of the form.
queryinput optional Use this tag if you want to automatically insert values into your fields, like if you wanted to edit an existing record. It would be the name of the Query called on the page.
allowfile optional Use this tag if you are going to do file uploads. It adds the attribute 'enctype="multipart/form-data"' to the form tag.
wysiwygeditor optional Use this tag if you want to convert all of your textarea fields into WYSIWYG fields. This pulls TinyMCE onto your forms. If you want to change the buttons that TinyMCE shows, you have to change the config files of TinyMCE.

coreField:

Attribute Required? Description
fieldname required The name you want to give the field. If you are using the QueryInput attribute of the Coreform, you need to name it the same as the database field.
template required If you are using cfmodule syntax.
required optional defaulted to No. Specify Yes if you would like the field to be required.
format required

You can specify the same as the html forms. The following are supported: text, textarea, radio, select, checkbox, file, and submit.

There are additional formats:

  • date: validates that the input is a valid date
  • calendar: validates that the input is a date and also provides a calendar popup to select the date
  • int: validates the input is a number
  • email: checks to see if the input has a "@" symbol in it at the text after the @ has at least one period
  • time: puts three fields onto your form for hour, minute, and AM or PM
  • fckeditor: if you have fckeditor installed correctly, it will load an instance of fckeditor
  • usstates: gives you a select box with all the United States states in it.
  • countries: gives you a select box with all the countries in the world. Specifically, the country names (official short names in English) in alphabetical order as given in ISO 3166-1 and the corresponding ISO 3166-1-alpha-2 code elements.
caption optional

provides a way of naming the field more easily in the error statement.

If you are using the MAKETABLE option, this field is required.

standalone optional If you are specifying a queryinput, all the fields look for a field in the query. If you specify Y for this attribute it will stop the tag looking for a field.
default optional Sets a default value to a field.
size optional just like the size attribute in the html input tag.
minvalue optional Only for use when the format is set to Int, Date or Calendar. Validation checking for the Int to see if the value entered is smaller than the value specified in this attribute. For the Date or Calendar, it checks to see if the date entered is smaller than the value specified in this attribute.
maxvalue optional Only for use when the format is set to Int, Date or Calendar. Validation checking for the Int to see if the value entered is larger than the value specified in this attribute. For the Date or Calendar, it checks to see if the date entered is larger than the value specified in this attribute.
maxlength optional For all string values (text, textarea, email, fckeditor), checks to see if the character count is greater than the value specified in this attribute.
minlength optional For all string values (text, textarea, email, fckeditor), checks to see if the character count is smaller than the value specified in this attribute.
showtip optional Default is No. Only works for the Calendar and date at the moment, if you select Yes, it shows you the proper number format.
valuelist optional For use with Radio, Select and Checkbox. Allows you to provide a list of values.
displaylist optional

For use with Radio, Select and Checkbox. Allows you to provide labels to the values.

If you use the Valuelist and not the displaylist, it shows the valuelist values as the labels.

queryname optional For use with Radio, Select and Checkbox.
valuecolumn optional For use with Radio, Select and Checkbox when you are using the queryname attribute. Specify the fieldname of the query you would like to use as the value.
displaycolumn optional For use with Radio, Select and Checkbox when you are using the queryname attribute. Specify the fieldname of the query you would like to use as the label.
blankselection optional For use with select box only. Provides a default selection with no value, you can enter information like " - select one -".
rows optional For use only with a Textarea. Default is 50
cols optional For use only with a Textarea. Default is 10
width optional For use only with the fckeditor. Default is 100%
height optional For use only with the fckeditor. Default is 300
toolbar optional For use only with the FCKeditor. Default is "Default". Specify whatever toolbar set you would like to use for that instance of FCKeditor.
minuteinterval optional For use with the time format. So you can change the dropdown options for the minute increments. For example if you enter 1 the minutes 1 through 60 will show. If you specify 5, then the minutes will increase by 5's.
altselectedvalues optional For use with the checkbox format. Allows you to have a comma delimeted list of selected values.
altselectedvaluesdelimeter optional Used with altselectedvalues, in case you need to provide a different delimeter.

coreRule

Attribute Required? Description
template required If you are using cfmodule syntax.
rule required specify the rule you would need to generate an error. An example would be if you were verifying the user entered the same thing in two different text boxes (password verification when changing), you would specify "password1 neq password2". If this were true it would generate an error.
caption required The error message you want displayed when an error has been generated.

coreDirections

Attribute Required? Description
template required If you are using cfmodule syntax.
directions required Specify the directions you want to add.

 

Initial Setup:

You need to specify this in your "application.cfm" file:

<!--- include the coreForm stuff --->
<cfset coreformstyle = "SkyBlue"> <!--- OrangeBreeze, SkyBlue --->
<cfinclude template="/coreforms/coreFormIncludes.cfm">
<!--- include the coreForm stuff --->

 

Bottom of Form

<cfif isdefined('form.coreformaction') and request.isformvalid eq "OK">

- - - Whatever action you want to do now that the form validates. - - -

</cfif>