Submissions View Menu Item

The Submissions menu item permits you to display the submissions in the front-end for a form of your choice. The menu item can be added to your site from the Menu Manager section in the back-end, to any menu on your site. When creating the menu item you can edit the following options for it (besides the standard menu item default System Parameters):

  • Form: The form which submissions you wish to display.
  • Show Submissions In: A list of available front-end language pack. If a multilingual form is used, you can filter the displayed submissions by language.
  • Enable Viewing Submissions: Set this to Yes after you have setup your menu item so that people will have access to this page. This is a security measure, so that people will not be able to craft the URL in order to view the submissions of other forms (that may contain sensitive information).
  • Show search filter: No / Yes. If enabled, a simple search form will be displayed (the search radius includes all fields of the selected form).
  • Sort submissions:Descending / Ascending. The submissions will be sorted by the built-in submission time stamp.
  • Show submissions for user ID: Leave 0 to show all submissions. Specify multiple users by separating them with a comma (eg. 1,2,3). Type login to show only the logged in user's submissions.
  • Show only confirmed submissions: Yes / No - set to Yes in order to only display submissions that have been confirmed by the submitter via the email confirmation link.
  • HTML Layout: This HTML code is parsed in the module position you choose. Do not remove {formdata} tag from this, since it is replaced with the data output.
  • Row Layout:This HTML code is parsed and all your field ids like {FullName:value} are replaced with user data(you can change the value "FullName" with the actual name of your field). Use {details}some text{/details} to display a details link that points to the Details Layout. Also you can add a link to the PDF view of the submission by using the following placeholders in order to set the link: {detailspdf}Download PDF{/detailspdf}.
  • Details Layout:This HTML code is parsed and all your field ids like {FullName:value} are replaced with user data. If you wish to display the submission on multiple pages in the PDF file generated for it, you can use the HTML code line:
     
    			  <p style="page-break-before: always"></p>
    			 
     

    in order to delimit the pages in the layout. For example you can use something similar to this in the Details Layout in order to show a 2 page PDF for the submission:

     
     
    			  <p>Page 1</p>
    			  <p style="page-break-before: always"></p>
    			  <p>Page 2</p>
    			 

You can easily control the displayed results using "IF" statements (similar to how they are used in the component generated emails). The pseudocode is useful in cases where users would skip fields that are not required in the submission process, generating empty spaces in the listing page layout.This syntax can be used in Row Layout and Details Layout.

Example:

{if {name_of_field:value}}The submitted message is {name_of_field:value}.{/if}  The string found within the {if} syntax will not show if the field has no value.

The {if} clause also accept the following operators:

<= , >=, <>, <, >, !=, =,==,===, <-, ->

Assuming that you have a checkbox and you need to compare its value with a specific string, you will use:

{if {Checkbox:value}<-Item1}This text will be displayed only if the Item1 value is selected{/if}  If you want to display a text if the checkbox has one of your desired values, you will use the following syntax:  {if {Checkbox:value}->Item1,Item2}This text will be displayed if one of the following values is selected: Item1 or Item2{/if}

After setting the Submission View menu item you will be able to access it in the front-end, from the menu item to which you have assign it. The Layout of the Menu item can be customized to any extent, displaying the submissions in the desired format.

Note:
  • If you wish to display the submissions inside a module position, please refer to the mod_rsform_list tutorial.
  • In order to be able to use multiple pages in the PDF file you will need to update the TCPDF library to the latest version as explained here.

Available global placeholders:

  • {global:username} - displays the username
  • {global:userid} - displays the user ID
  • {global:useremail} - displays the email of the user
  • {global:fullname} - will display the Full Name registered for the current user
  • {global:userip} - displays the ip of the user that submitted the data
  • {global:date_added} - displays the date when the form was submitted
  • {global:sitename} - returns the name of your site
  • {global:siteurl} - returns the URL of your site
  • {global:confirmation} - displays the URL used for the submission confirmation
  • {global:confirmed} - displays the status of the submission
  • {global:submission} / {global:submission_id} - returns the ID of the submission
  • {global:counter} - working only in the Row Layout area, will display a counter for the submissions
  • {global:naturalcounter} - working only in the Row Layout area, will display a counter for the submissions (based on your Sort submissions option, counting is done either ascending or descending)

Using the Submission View Menu Item, you can display your Community Builder Profile upon clicking the submitted name.A step by step guide can be found in the How to display a Community Builder profile article.


17 persons found this article helpful.


Was this article helpful?

Yes No
Sorry about that

You Should Also Read

Module - mod_rsform_list (Display submissions in a module position) HOT

Submissions Directory Menu Item HOT

How to display a Community Builder profile HOT