Module - mod_rsform_list (Display submissions in a module position)

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

In order to download this module you will have to log in to www.rsjoomla.com and go to "Downloads -> My Downloads" area. After you have downloaded the installation zip file just go to Extensions > Install/Uninstall, browse the file and click Upload & Install button. To enable the installed module you will have to go Extensions > Module Manager, search for "RSForm! Pro Module Frontend List" and click the enable icon.

The module is now up and running and ready to use. To enter the configuration screen of the module just click on the RSForm! Pro Module Frontend List link. Here you will be able to select where you want to display the module, access level and set the order.

In the right side of the Module Parameters rollout you will have to set the id of the forms submissions you want to display, and build up your own layout for the submissions.

Please note that you will have 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.
  • 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

In the Advanced tab of the module, 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 "?"

Note:
Show submissions options:
  • 0: will display all submissions
  • login: will display the submissions of the logged in users
  • 1,2,3,etc: will display the submissions of the specified user ids

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:

  • {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 RSForm! Pro Frontend List module, 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

Submissions View Menu Item HOT

Submissions Directory Menu Item HOT

How to display a Community Builder profile HOT