Module - mod_rsform_list (Display submissions in a module position)

In this article we will describe how to use the module (mod_rsform_list) for displaying submissions for a selected form, in the front-end area.


Downloading and Installing the module
 
Download

You can download the module by logging with your purchase user, then head to My Downloads > RSForm!Pro - Modules & Plugins > Modules > "RSForm!Pro Module List" plugin.

Install

In the backend area go to the Extensions > Manager > Install page, and install the module. Next thing is to publish the module (or add a new one) from Extensions > Site modules area, search (or filter) for the "RSForm!Pro Module List" module.

You will need to use your form's specific placeholders or global placeholders to build up the layout.


Module configuration
  • Form ID: The form which submissions you wish to display.
  • Menu Item ID: If you would like to link your submission details to a menu item, please enter the menu item's ID in here. Please make sure that the menu item is an RSForm!Pro menu item and is configured to display submissions for the same form as this module.
  • 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.
  • 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: If Submission Confirmation is enabled, you can filter the displayed submissions by their status
  • Module 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 will have to change the placeholder "FullName" with the actual name of your field). Use {details}some text{/details} to display a details link that points to the Details Layout.
  • Details Layout: This HTML code is parsed and all your field ids like {FullName:value} are replaced with user data.
  • Page Limit: This field controls the number of rows to be displayed per page, use 0 for no limit
  • Show Pagination: Yes / No - set to Yes in order to display the page navigation links
  • Show Results Counter: Yes / No - Set to Yes in order to show the number of results
  • Module Class Suffix: A suffix to be applied to the CSS class of the module. This allows for individual module styling

You can set up the Menu Item ID (it can be from a Submission Directory or a Submission View menu item). With this setting configured, you can use the following placeholder : {details_link} to create a link to the detail view of a specific submission.

<a href="{details_link}">{Name:value}</a>

Using the syntax above, you can even create a link to the PDF file:

<a href="{details_link}?format=pdf">Download PDF</a>

Keep in mind that if you do not use SEF, you will have to use "&" instead of "?"


If you want to display the submissions inside an article, you have to follow these additional steps:

  1. You will have to add a custom position for the module(it should be an unique position), for example myposition.
  2. In your article you use Joomla! syntax which triggers the LoadPosition plugin.


Available global placeholders:

The syntax for global placeholders is {global:placeholder_name}

Placeholder name Description Logged in user required?
username If the user is registered to your Joomla website, his username will appear when using this placeholder Yes
userid If the user is registered to your Joomla website, his user id will appear when using this placeholder Yes
useremail If the user is registered to your Joomla website, his email will appear when using this placeholder Yes
fullname If the user is registered to your Joomla website, his fullname will appear when using this placeholder Yes
userip The IP of the user that submitted the form No
date_added The date the user submitted the form No
sitename The name of your site, as defined in your Joomla configuration No
siteurl The URL of your site No
confirmation The URL used to confirm the submission No
deletion The Global placeholder that can be used in order to delete the submission. No
confirmed The status of the submission No
submissionid / submission_id The id of the submission No
counter working only in the Row Layout area, will display a counter for the submissions No
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) No

Using the RSForm! Pro Module List , 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

04 Mar 2024
Version 3.1.0
  • Added - Joomla! 5 native compatibility - no longer needs the 'Behaviour - Backward Compatibility' plugin.
30 Jan 2023
Version 3.0.4
  • Added - {component:filename} is now available in the 'Row Layout' section (for File Upload fields).
28 Jun 2022
Version 3.0.3
  • Updated - Bumped minimum requirements to use RSForm! Pro 3.0.20
  • Updated - {global:deletion} updated to match the changes in RSForm! Pro 3.0.20
15 Sep 2021
Version 3.0.2
  • Fixed - Showing all submissions was no longer working.
03 Sep 2021
Version 3.0.1
  • Updated - Bumped minimum requirements to use Joomla! 3.9.26
  • Updated - 'Menu Item ID' is now a dropdown with all your menu items instead of a regular textbox.
  • Updated - Some code cleanup.
  • Fixed - 'Advanced' tab was missing 'Layout' and 'Caching' options.
09 Jun 2021
Version 3.0.0
  • Updated - Joomla! 4.0 and RSForm! Pro 3.0 compatibility.
17 Jun 2020
Version 2.0.5
  • Fixed - {_TRANSACTION_ID:value} was not showing correctly.
22 Jan 2020
Version 2.0.4
  • Fixed - Some global placeholders were not working in the Row Layout.
13 Jan 2020
Version 2.0.3
  • Added - {global:confirmation} is now available.
06 Jan 2020
Version 2.0.2
  • Added - {global:deletion} is now available.
  • Added - {_TRANSACTION_ID:value} is now available.
  • Updated - Some code improvements.
  • Fixed - Module Class Suffix was not escaped.
15 Jul 2019
Version 2.0.1
  • Added - {:image} placeholders are now available.
  • Updated - Not all links were SEF.
  • Updated - Bumped minimum requirements to RSForm! Pro 2.2.4
03 Jun 2019
Version 2.0.0
  • Updated - Bumped minimum requirements to RSForm! Pro 2.2.2
22 Mar 2019
Version 1.51.4
  • Updated - Bumped minimum requirements to RSForm! Pro 2.1.5 and Joomla! 3.7.0
  • Updated - Changed language keys from 'RSFP_PAYPAL_STATUS_' to 'RSFP_PAYMENT_STATUS_'
  • Updated - Some code improvements and deprecated code has been removed.
18 Aug 2017
Version 1.51.3
  • Added - {global:fullname} is now available.
11 Jul 2017
Version 1.51.2
  • Updated - Bumped minimum requirements to Joomla! 3.6.5
  • Fixed - Pagination is now working for multiple modules on the page.
18 Jan 2017
Version 1.51.1
  • Added - {global:formid} is now available.
19 Jan 2016
Version 1.51.0
  • Added - Joomla! automatic updates support.
  • Updated - Bumped minimum requirements to RSForm! Pro 1.51.0 and Joomla! 2.5.28
18 Aug 2015
Version 1.5.6
  • Updated - Specific error messages when trying to view a submission that you don't have access to.
03 Aug 2015
Version 1.5.5
  • Added - {if} scripting is now supported.
03 Aug 2015
Version 1.5.4
  • Added - {global:naturalcounter} is now available.
15 Apr 2015
Version 1.5.3
  • Added - {global:fullname} is now available.
04 Feb 2015
Version 1.5.2
  • Added - {global:fromname} is now available.
  • Added - {global:mailfrom} is now available.
03 Feb 2015
Version 1.5.1
  • Added - Module options 'Show Pagination' and 'Show Results Counter'
  • Fixed - Pagination was not showing up correctly on Joomla! 3
08 Jun 2015
Version 1.5.0
  • Fixed - When having more than one module on a page the Itemid was set incorrectly.
22 Nov 2013
Initial Release

32 persons found this article helpful.


Was this article helpful?

Yes No
Sorry about that