Custom Form Page Types allow you to create and collect custom forms like: event registrations, product registrations, surveys, sales and support inquiries, request forms, and many others.
Here are the Page Type Properties available to this Page Type:
Form Name: |
The is the unique name of the Custom Form that is embedded in the Page. It is used to identify the form's data captured and accessible in the [FORMS] area, and to connect the optional Custom Form Confirmation Page. NOTE: The Form Name can be changed at any time as long as you have deleted all submitted form data associated with the Custom Form. |
Enable Form: |
Select this when you want the Custom Form to collect submitted data. If this is not selected, the Custom Form and it's submit button will not appear within the Page. |
Enable Quiz: | Select this option if you want to add "Quiz Question" fields to the Custom Form. This option prevents the submitter from reaching the confirmation message or next Page until they answer a certain percentage of the "Quiz Questions" correctly. This is useful for creating certification tests and displaying a certificate of completion ONLY if they obtain a passing percentage. If the submitter does not complete the correct percentage, they remain on the Custom Form page and a message is displayed. The Custom Form is submitted regardless of the percentage scored so that quiz administrators can audit the number of attempts and keep track of each score. |
Quiz Pass Percentage: | If Enable Quiz is selected, specify the percentage of correct answers required before the Submitter is allowed to continue to the confirmation message or next Page. |
Label Column Width: |
This optional setting adjusts the horizontal width (in percent) of the label column within the Custom Form area of the Page. Use this setting to improve your form's layout. |
Enable Watcher Option: |
This optional setting will allow Users to add themselves to the watch list for the Page where Visitors might comment on the Submitted Form. You should select the Form Item View Page where the Submitted Form will appear and where Comments and watching are enabled. TIP: This feature is often used for a forum where the User who submits a thread might want to be notified about all replies to that thread. |
Submit Button Label: |
Enter the text you wish to display for the clickable Submit button. |
E-mail Submitter: | Select this if you want to send an auto-responder e-mail to any Visitor that submits this Custom Form. The e-mail will be sent to the e-mail address that the Submitter entered into a field that was connected to the the Contact e-mail address field. Therefore, in order to use this feature you must have a field on this Custom Form where "Connect to Contact" is set to "E-mail Address". The from name for the e-mail will be set to the organization name in the site settings. |
From E-mail Address: |
Specify the e-mail address that should appear as the from address in the e-mail. If this field is left blank, then the support e-mail address from the site settings will be used. |
Subject: |
Specify the subject for the e-mail that is sent to the Submitter. You may include the name of a field (^^example^^) that is in this Custom Form in order to create a dynamic subject that contains submitted form data. Example: ^^name^^, we have received your request. You may use the following format to output different content depending on whether there is a value or not: [[There is a value: ^^example^^|| There is not a value]] You can use the following format to customize the date format for date and date & time fields. The format must be a PHP date format.
Format:
Example: |
Format: | Select whether you want the e-mail to contain plain text or HTML. Plain text is a simpler format that does not contain styling or images. HTML is a format like a webpage. If you select plain text, you will be asked to enter the body content for the e-mail. If you select HTML, you will be asked to select the Page that you want to send. |
Body: |
Specify the body content for the e-mail that is sent to the Submitter. You may include the name of a field (^^example^^) that is in this Custom Form in order to create a dynamic body that contains submitted form data. Example: ^^name^^, we have received your request. You may use the following format to output different content depending on whether there is a value or not: [[There is a value: ^^example^^|| There is not a value]] You can use the following format to customize the date format for date and date & time fields. The format must be a PHP date format.
Format:
Example: |
Page: |
If you select HTML for the format, this field allows you to select an HTML Page to be e-mailed to the Submitter. NOTE: If a Form Item View Page is selected to be e-mailed, then the Form Item View Page will be sent with the submitted data from this Custom Form in it. |
E-mail Administrator: |
Select this when you want to notify an administrator every time this Custom Form is submitted by a Visitor. This feature is used to send notifications to those coordinating activities around the form information. If there is a field connected to the Contact e-mail address field and the Submitter enters an e-mail address into the field, then that address will be used as the from name and from address. If an address for the Submitter cannot be found, then the from name will be set to the organization name in the site settings and the from address will be set to the support e-mail address in the site settings. |
To E-mail Address: |
This is the e-mail address of the person (or group) that you wish to send the e-mail to when a form is successfully submitted. TIP: You can specify multiple e-mail addresses if you separate each by a comma. NOTE: If the Custom Form submitter selects a field option that is set to notify an administrator, then the e-mail will also be sent to that administrator. |
BCC E-mail Address: |
This is the e-mail address of the person (or group) that you wish to BCC the e-mail to when a form is successfully submitted.
|
Subject: |
Specify the subject of the e-mail that is sent to the Form Administrator. You may include the name of a field (^^example^^) that is in this Custom Form in order to create a dynamic subject that contains submitted form data. Example: You received a message from ^^name^^. You may use the following format to output different content depending on whether there is a value or not: [[There is a value: ^^example^^|| There is not a value]] You can use the following format to customize the date format for date and date & time fields. The format must be a PHP date format.
Format:
Example: |
Format: | Select whether you want the e-mail to contain plain text or HTML. Plain text is a simpler format that does not contain styling or images. HTML is a format like a webpage. If you select plain text, you will be asked to enter the body content for the e-mail. If you select HTML, you will be asked to select the Page that you want to send. |
Body: |
Specify the body content for the e-mail that is sent to the administrator. You may include the name of a field (^^example^^) that is in this Custom Form in order to create a dynamic body that contains submitted form data. Example: You received a message from ^^name^^. You may use the following format to output different content depending on whether there is a value or not: [[There is a value: ^^example^^|| There is not a value]] You can use the following format to customize the date format for date and date & time fields. The format must be a PHP date format.
Format:
Example: |
Page: |
If you select HTML for the format, this field allows you to select any Page to be e-mailed automatically to the Form's Administrator when a form is successfully submitted. NOTE: If a Form Item View Page is selected to be e-mailed, then the Form Item View Page will be sent with the submitted data from this Custom Form in it. |
Add to Contact Group: |
If there is a contact for the visitor that submits the custom form, then the contact will be added to this contact group. |
Grant Membership Trial: |
Select this option if you want to grant a membership trial
to the User that submits the Custom Form. If a
membership trial is granted to a User, then the Contact's
Member
ID is set to the Reference Code for the Submitted Form, the
Contact's Expiration Date is set according to the Trial Length field below, and the
Contact is added to the membership Contact Group, which is
set in
the settings. A Visitor is required to login or register in
order
to submit a Custom Form that grants a membership trial. |
Trial Length: |
Enter the number of days that each User should be granted membership access. If you want to grant a membership trial, then the value of this field must be greater than 0. |
Set Member's Start Page to: |
If you also want to update the Member's Start Page, so that the Member is forwarded to a specific Page when he/she logs in, then you should select a page for this field. You may leave this field blank. It is not required in order to grant a membership trial. |
Confirmation Type: |
Select the type of confirmation that you want to appear after the Visitor submits the Custom Form. Select "Message" if you want a message to be shown on the Custom Form Page where the form normally appears. Select "Next Page" if you want the Visitor to be directed to a different Page. |
Message: |
Enter the message that you want to appear after the Visitor submits the Custom Form. |
Next Page: |
The Page that you want the system to go to when the Submit Button is clicked and the Custom Form is submitted successfully. Typically, you may wish for the system to go to a Custom Form Confirmation Page Type, or any other Page on your site - depending on your needs. If a Form Item View Page is selected, then when the User submits the Custom Form they will be sent to the Form Item View Page with the data that the user submitted. |
Alternative Next Page: |
Check this if you want certain Users to be directed to a different next Page based on whether they are in a specific Contact Group or not. This allows you to route Users to different destinations. Users must be logged in for this feature to work. You can place the Custom Form Page in a Folder with registration access control in order to require that. |
If Contact Group: |
Select the Contact Group that Users must be in, in order to be forwarded to the alternative next Page. |
Then Go to Page: |
Select the Page that you want Users to be directed to, for the alternative route. If a Form Item View Page is selected, then when the User submits the Custom Form they will be sent to the Form Item View Page with the data that the User submitted. |
If User has already submitted form in the past, then show: |
Select what you want to appear if a User has already submitted the Custom Form in the past and is returning to it again. If you want Users to be able to submit the Custom Form multiple times, then select "Custom Form". If you want to prevent Users from submitting the Custom Form multiple times, then select either "Message" or "Page". Users must be logged in for this feature to work. You can place the Custom Form Page in a Folder with registration access control in order to require that. As an editor, if you are needing to view the form and you can't because you have submitted it in the past, then you may access the form by clicking on the Page from the Pages tab. |
Message: |
Enter the message that you want to appear if the User has submitted the Custom Form in the past. |
Page: |
The Page that you want the system to go to if the User has already submitted the Custom Form in the past. If a Form Item View Page is selected, then the data that the User submitted last time can appear on the Page. |
Alternative Page: |
Check this if you want certain Users to be directed to a different Page based on whether they are in a specific Contact Group or not. This allows you to route Users to different destinations. Users must be logged in for this feature to work. You can place the Custom Form Page in a Folder with registration access control in order to require that. |
If Contact Group: |
Select the Contact Group that Users must be in, in order to be forwarded to the alternative Page. |
Then Go to Page: |
Select the Page that you want Users to be directed to, for the alternative route. If a Form Item View Page is selected, then the data that the User submitted last time can appear on the Page. |