Collect user input on your website via forms created with JotForm
The Composite.Forms.JotForm package displays forms you create by using JotForm, an online web form builder (http://www.jotform.com). You can choose how to display the form on your web page: embedded, in a iFrame, in a lightbox, in a popup window or via a feedback button.
The package also allows you to view submission reports for these forms in the C1 Administrative console. The reports can be of various types (grid-like reports, HTML tables, Excel spreadsheets etc).
Prerequisites
- In Composite C1, log in to the console and install the Composite.Forms.JotForm package.
- Log in to your JotForm account. If you don't have an account, please sign up.
How to add a JotForm to your website
- Create a form at JotForm.
- Edit the form and make a note of the form's URL in your browser's address bar (for example,
http://www.jotform.com/?formID=13540754401) - In Composite C1, edit a page and insert the
Composite.Forms.JotForm function (
Insert |
Function) or add similar code:
<f:function name="Composite.Forms.JotForm" xmlns:f="http://www.composite.net/ns/function/1.0"> <f:param name="FormURL" value="http://www.jotform.com/?formID=13631204567" /> <f:param name="FormTitle" value="My Form" /> <f:param name="DisplayStyle" value="Embed" /> </f:function>
- In the Form URL parameter, specify the form's URL from Step 2
- If needed, specify its optional parameters:
- Form Title: The form's title to appear on the page
- Display Style: The display style of the form (embedded, iFrame, lightbox, feedback button, popup)
How to show submission reports in the C1 Console
- Create a report at JotForm. (For a sample report, please read how to create Grid Report.)
- Make a note of the shared Grid Report's URL (e.g.
http://www.jotform.com/grid/13543556789) - If necessary, create reports of other types such as HTML tables, visual reports, Excel spreadsheets, CSV reports and make a note of their respective URLs.
- In Composite C1, in the Content perspective, select the JotForm Reports element and click Add JotForm Report on the toolbar.
- In the form that opens, specify the Title and one or more URLs in the respective fields for the reports you have created in steps 1 and 3.
Now that the report has been added, you can select it and click one of the "Report" buttons on the toolbar (for example, "Grid Report"). Grid, Table and Visual Reports will open in their views in the right part of the cosnole. Excel and CVS Reports are downloadable.
Note: If a report of a specific type is not available, you will see a message about that. In this case, you have to create a report, get its shared URL and specify it as described above.
Tips and tricks
- Thank You Page: To learn how to manage the "Thank you" page, please read "How to Redirect to a Page After Form Submission". You can either specify a page to redirect to or provide your own "Thank you" message.
- Recipient Email Address: Each submitted form will be sent to the email address you specified in your account. To change this email address, please read "How can I change recipient e-mail address for my form? "
Requirements
Composite C1 version 3.0 or later