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.
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:
- You will have to add a custom position for the module(it should be an unique position), for example myposition.
- 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
Version 3.1.0
- Added - Joomla! 5 native compatibility - no longer needs the 'Behaviour - Backward Compatibility' plugin.
Version 3.0.4
- Added - {component:filename} is now available in the 'Row Layout' section (for File Upload fields).
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
Version 3.0.2
- Fixed - Showing all submissions was no longer working.
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.
Version 3.0.0
- Updated - Joomla! 4.0 and RSForm! Pro 3.0 compatibility.
Version 2.0.5
- Fixed - {_TRANSACTION_ID:value} was not showing correctly.
Version 2.0.4
- Fixed - Some global placeholders were not working in the Row Layout.
Version 2.0.3
- Added - {global:confirmation} is now available.
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.
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
Version 2.0.0
- Updated - Bumped minimum requirements to RSForm! Pro 2.2.2
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.
Version 1.51.3
- Added - {global:fullname} is now available.
Version 1.51.2
- Updated - Bumped minimum requirements to Joomla! 3.6.5
- Fixed - Pagination is now working for multiple modules on the page.
Version 1.51.1
- Added - {global:formid} is now available.
Version 1.51.0
- Added - Joomla! automatic updates support.
- Updated - Bumped minimum requirements to RSForm! Pro 1.51.0 and Joomla! 2.5.28
Version 1.5.6
- Updated - Specific error messages when trying to view a submission that you don't have access to.
Version 1.5.5
- Added - {if} scripting is now supported.
Version 1.5.4
- Added - {global:naturalcounter} is now available.
Version 1.5.3
- Added - {global:fullname} is now available.
Version 1.5.2
- Added - {global:fromname} is now available.
- Added - {global:mailfrom} is now available.
Version 1.5.1
- Added - Module options 'Show Pagination' and 'Show Results Counter'
- Fixed - Pagination was not showing up correctly on Joomla! 3
Version 1.5.0
- Fixed - When having more than one module on a page the Itemid was set incorrectly.
Initial Release
32 persons found this article helpful.