This screen allows you to layout the display of data from multiple submitted forms. This is one of the most powerful features of the system.
You can update the way this Page's displays of data from multiple Submitted Forms, and optionally link this Page to a Form Item View Page, that will display an individual submitted form, by using the ^^form_item_view^^ system field.
All the available fields that can be displayed are listed, sandwiched between the double-caret (^^) which are used by the system to identify where to replace the fields with data when displaying the Page. Simply copy any of the fields (be sure to include the double-carets) into the Layout area.
System Fields are fields that are available to include in your layout that are automatically created for all Submitted Form data.
Form Fields are fields that were created on the Custom Form that the Form List View Page is associated with (through it's Page Properties).
There are several system fields which allow you to display information about Comments that have be added to Submitted Forms. These fields can be used to setup a forum that shows the number of replies and newest reply for various topics.
Use the following URL format to link directly to the newest Comment on the Form Item View Page:
^^form_item_view^^#software_comment_^^newest_comment_id^^
Hints provide a quick way of cutting and pasting common layout values into your layout area.
The Form List View Layout area, or "layout" is where you place your available fields to be replaced by the actual data fields from the Submitted Forms. The layout area represents a single submitted form's data. Think of this area as a row in a spreadsheet, or table. It will be output over and over until all the Submitted Forms are displayed.
Most of the time, you will not only want to display the Submitted Form data in a List, but also allow your site visitors to "drill into" the actual Submitted Form data and view additional fields that are not added to the layout itself. To do this, create a link in the layout and set the "Link URL" value to ^^form_item_view^^. The system will then automatically create a URL with the Page name and reference code. If the link does not work then make sure that a Form Item View Page is set in the page properties for this Form List View.
You can display information within the layout area based on a value being available to display. For example, you may want to hide the label of the field if it is not present the Submitted Form data. 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]]
If you have created a Custom Form with File Upload fields on it, you will need to dynamically link to them through the layout. To do this, use the following URL format:
/files/^^example^^ , where example is a form field that contains the name of the File uploaded.
You want to format your date and time values in different ways for spacing or affect. The system allows you to use virtually any format you desire. To customize the date and time values for the available time and date fields, use the following format within your layout:
Format:
^^field_name^^%%format%%
format can either be a PHP date format or "relative" for a relative time (e.g. "2 minutes ago", "2 minutes from now").
Examples:
^^submitted_date_and_time^^%%l, F j, Y \a\t g:i A%%
^^submitted_date_and_time^^%%relative%%
NOTE: For "relative" date/time formatting, once the date goes beyond one month, the full date and/or time is displayed.
You can sort the order in which the Submitted Form data (rows) are output. "Ascending" orders results from a-z/0-9, while "descending" orders results from z-a/9-0. Normally you will want to choose "alphabetical", however if the field you select contains only numbers (e.g. price, square footage), then you will want to select "numerical", so the results appear in the correct order. Numerical ordering works for both integer numbers (e.g. 1, 2, 3) and decimal numbers (e.g. 0.75, 1.25, 10.333).
NOTE: "Random" sort order is only available for the first sort order option but is useful if you want the rows of Submitted Form data to be displayed in a random order each time the Page is displayed.
You can limit the nuber of Submitted Forms (data rows) are displayed on the page. If you don't set the Maximum Number of Results Per Page, then the system will output pagination navigation automatically.
You can add filters that define exactly which Submitted Forms (data rows) are displayed on the Page.
TIP: If you wish to further filter a Form List View to only allow a Submitter to view their own Submitted Form data, add an E-Mail Address Field to your Custom Form and then add a Filter where the "Submitter" "is equal to" the "Viewer". This will allow you to place the Form List View Page into a Folder that many Users can view, but any Submitted Form data from other Users will be hidden for them.
Allow Visitor to search data |
|||||||||||||||
Enable Search: |
Check this to add a search box to the Form List View Page. Search will allow the Visitor to enter a keyword and the system will search all (filtered) Form List View data for the keyword and display the resulting Submitted Form data (rows) that contain that keyword. NOTE: The keyword search will search all system and custom form fields, not just fields that appear in the display layout above. |
||||||||||||||
Label: |
Enter the text that you want to appear as a placeholder in the search field. Once the Visitor starts to type their search, then the label will disappear from the search field. The label will reappear if they remove their search. You can set this to something general like "Search" or something more specific like "Search Blog". You can also remove the label, if you want the search field to be empty by default. This label is also used for the tooltip title that appears when a Visitor hovers their cursor over the search icon. |
||||||||||||||
Enable Advanced Search: |
Check this to allow the Visitor to search specific fields. A toggle button (i.e. +/-) will appear that allows the Visitor to expand or collapse the advanced search. The Visitor may use the keyword search and advanced search at the same time. You may define the fields that are available in the layout below. The results will only be filtered for the advanced search fields that the Visitor completes. If a Visitor leaves a field blank, then that field will be ignored. In general, fields will appear as they are defined in the Custom Form Field properties. For example, if a field has a text box type, then it will appear as a text box in the advanced search. There are some exceptions to this. For example, a text area field will appear in the advanced search as a text box, because the Visitor will not need a full text area to enter a search term. If a default/blank option does not exist for pick lists and radio button sets, a default/blank option will be added to the top of the lists. This allows a Visitor to leave the default option selected in order to ignore a field if he/she does not want to filter that field. |
||||||||||||||
Expand by Default: |
Check this if you want the advanced search area to be expanded when the Visitor first visits this Page, in order to draw attention to it. This prevents the Visitor from having to click the toggle to expand the advanced search. If you check this, the expand by default setting for the browse feature will be disabled because both areas cannot be expanded at the same time. |
||||||||||||||
Layout of fields in advanced search |
|||||||||||||||
Layout: |
Use this rich-text editor in order to define the layout for the advanced search fields. You will want to include a label for each field and then copy a field from the lists above and paste into the layout. You can use a table in order to align multiple fields. You will also want to include a submit button, and optionally a clear button, which you can also copy from the lists above. You may add additional properties to any field. The available properties appear below. "name" is the only required property.
|
||||||||||||||
Allow Visitor to browse data |
|||||||||||||||
Enable Browse: |
Check this to display a pick list that will allow Visitors to browse data by Custom Form Fields. The pick list will contain a list of Custom Form Fields that you may select below. Once the Visitor selects a Custom Form Field, a list of available browse filters will appear in columns in a table. The browse filters that appear are all of the unique values that exist in Submitted Forms for that field. The Visitor can then click on a browse filter in order to filter the Submitted Form results that appear on this Page. The label for the fields in the pick list comes from the label for the corresponding Custom Form Field. If a colon appears on the end of the label, then it is removed. The order of the fields in the pick list is defined by the order for the fields in the Custom Form. You will have to reorder the fields in the Custom Form to affect their order in the pick list. A field will not appear in the pick list if there are no browse filters for that field (i.e. no values appear in Submitted Forms for that field). Only values for a field that exist in Submitted Forms will appear as browse filters. For example, if there is an option in a pick list field that has not been selected for any Submitted Forms, then it will not appear as a browse filter. Although you may enable both browse and search, the Visitor must choose between browsing and searching at any given time. The Visitor may not combine browsing with searching. |
||||||||||||||
Expand by Default: |
Select a browse field that you want to be selected by default when a Visitor first visits this Page, in order to draw attention to it. This will expand the browse area by default. You may leave this pick list unselected if you do not want the browse feature to be expanded by default. Please be aware that you must also check the corresponding field in the "Select fields" area down below. Also, a value must exist for the selected field in at least one Submitted Form (i.e. the field cannot be left blank in all Submitted Forms if you want this feature to work). NOTE: If you select an option for this field, the expand by default setting for the advanced search feature will be disabled because both areas cannot be expanded at the same time. TIP: You also can create a link to this page, using query string parameters, in order to set a browse field and filter by default: /pages/[page name]?[page id]_browse_field_id=[field id]&[page id]_browse_filter=[filter] Replace [page name] with the Page name. Replace [page id] with the Page id. You can get the Page id, by editing the page properties and looking in the address bar. Replace [field id] with the Custom Form Field id. You can get the Custom Form Field id by editing the field in the Custom Form and then looking in the address bar. Replace [filter] with the browse filter value. |
||||||||||||||
Select Fields: |
Check the fields that you want to include in the browse pick list. Text area fields with rich-text editor enabled and information fields will not appear in the list, because they are not valid browse fields. The columns field allows you to set the maximum number of columns that you want the browse filters to appear in. If the browse filters tend to be long, then you might want fewer columns, however if the browse filters are short, then you might want more columns. Please be aware that the value you enter for this field is the maximum number of columns, so fewer columns might appear in some situations. Select the order that you want the browse filters to appear in. "Ascending" orders filters from a-z/0-9, while "descending" orders filters from z-a/9-0. For date fields, "ascending" orders filters from oldest to most recent, while "descending" orders filters from most recent to oldest. Check the shortcut check box if you want the browse filters for that field to link directly to the Submitted Form on the Form Item View Page instead of refreshing this Form List View Page and showing the result. The shortcut will only be used if there is only one result for the browse filter. You must set a Form Item View on the Edit Page Properties screen for this Form List View Page in order for the shortcut to work. For "date" and "date & time" fields, you may enter a format for the date. This allows you to customize the way that the date is displayed. The format must follow the syntax for the PHP date format. See examples below. Examples: Most of the date characters that PHP supports are supported in this feature. If you want a character to literally appear instead of being converted into a date value, then place a "\" character before it (see example above for "at"). Another benefit of the date format is that it allows you to group date values together. For example, if you have a blog and you want a list of months (with years) to appear in order to create a blog archive, you can simply enter "F Y" and then you will get a list like the following: January 2013, February 2013, March 2013. Your blog form would need to have a "publish date" custom field in order for this to work. You may leave the format field empty if you just want the default format (e.g. 5/24/2013 3:00 PM). |
||||||||||||||
Show all results before Visitor filters results by browsing or searching |
|||||||||||||||
Show Results by Default: |
If you want Submitted Forms to appear in a list on this Page before the Visitor browses or searches, then check this check box. If you leave this field unchecked, then the Visitor will receive a message when they first visit the Page that instructs the Visitor to first browse or search. Once the Visitor browses or searches, then results will appear. |