Submissions Directory Menu Item

In this article we will explain how you can enable and edit submission information in the frontend area.

 

For a presentation of the Submissions Directory feature, please have a look at the dedicated video tutorial.

 

The submissions are listed using the Submissions Directory menu item. This has been illustrated in the following pictures:

 
 

Generic steps you need to take:

  1. Enable submission directory for your form. This is done by selecting the Directory Fields you wish to show in the frontend area(backend > Components > RSForm!Pro > Manage Directories tab).
  2. Set the permissions on who can edit submission information.
  3. Publish the submissions using the Submission Directory menu item. While configuring the menu item, select your form and set the "enable submissions directory" option to Yes.

A more detailed explanation on these can be found below.

 
Submissions Directory - menu item

This menu item provides basic configuration for the submissions you are about to list. Besides the standard Joomla! menu item setup, the following options are available (found in the Advanced Options tab):

  • Form: choose the form from which you want the submissions to be listed.
  • Language: in case you have a multi-language website, you can select to show submissions from all languages or from a particular language.
  • Enable submissions directory: set this to Yes after you have setup your directory details in order to provide 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 directory of other forms (that may contain sensitive information).
  • Show only confirmed submission: set this to "Yes" to only show confirmed submissions.
  • Show submissions for the User ID: Leave 0 (zero) 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.
  • Items number: set the number of submissions to display on one page.
 
Manage Directories - tab

The Manage Directories area offers a listing of all your configured forms, this is the centralized area in which you can configure for each form the submission's frontend available information, fields, particular details as well as sending emails when the data was modified. There are several configurable tabs as explained below:

 
Directory General
  • Status: Enabled / Disabled; It shows whether or not the form submissions are ready to use in the frontend.
  • Enable PDF Support: Enabling this option will show an export to PDF button while viewing submissions via "Submissions Directory" menu item.
  • Enable CSV Support: Enabling this option will show an export to CSV button while viewing submissions via "Submissions Directory" menu item.
 

Directory PDF filename

The directory PDF filename can be customized by heading to Components > RSForm!Pro > Manage Directories > Select your directory and edit the "PDF Filename" field.

 
Directory Permissions
  • Can edit submissions: You can choose to only allow the submitter to edit own submissions or restrict an overall access based on the standard Joomla! user groups.
  • Can delete submissions: You can choose to only allow the submission owner to delete their own submissions and you can also select which Joomla! User Groups can delete submissions.
Directory Fields

The Directory Fields are shown in a tabular view for a more intuitive and faster setup(as seen in the picture on the right).

This area provides a granular control for each of your form's fields, even their ordering (this is controlled by dragging and dropping the rows to your liking). You can basically control the following features:

  • Show in listing: select the fields you wish to show in the frontend listing.
  • Searchable: select the fields which can be searchable in the frontend.
  • Editable: select fields that can be editable.
  • Show in Details: choose which fields will show in the Details Layout area of each submission (the submissions within the listing have the "view" icon which can be clicked to show these additional details you choose).
  • Export to CSV: you can choose the fields that will be available when exporting to CSV.
 
Details layout

This tab automatically generates the HTML code for the details area based on what you choose to display form the "Directory Fields" tab.

Five XHTML Layouts are available to choose from, these will dictate how the details area of a submission looks and feels:

  • Inline
  • 2 Lines
  • Inline + Titles
  • 2 Lines + Titles
  • 2 Columns

You can disable the auto generated layout option to perform additional changes within the HTML code and or add inline CSS style.

 

Note: Disabling the "Auto Generate Layout" option will make the Details layout area to be editable, but will prevent the field placeholders from being automatically added.

Tip:

Form fields that have multiple selectable values (checkboxes, multiple drop-downs) can be shown within the Details Layout with a custom separator. This is specified from the "Multiple Selections Separator" option from the form's Properties tab > Form Info.

 
CSS and Javascript

The CSS and Javascript areas can be used to further customize the look and functionality of your submission directory.

You can use the CSS area to add some custom style to your submission listing, without actually unchecking the "Auto Generate Layout" checkbox, or modify any of the RSForm!Pro files.

Note:

  • JavaScript code added here will be placed in the directory submission page's header area.
  • CSS declarations specified here may be later overridden by other declarations (inline styles, template CSS files, etc.).
 
Emails

The emails that are setup here will be sent whenever a submission's information has been saved in the frontend area. This is useful because you can send notifications to your desired admin(s) or even notifying the initial submitter that his or hers information was changed.

The following fields can be configured:

  • From: whenever the user receives the email, this will be the sender's address (i.e. from who the mail came from).
  • From Name: whenever the user receives the email, this will be the sender's name (i.e. the person's name the mail came from).
  • Reply To: this is the email that will be used when the user uses the Reply option from his email account.
  • TO: the address where the email should be sent.
  • CC: carbon copy sent to secondary recipients.
  • Bcc: blind carbon copy sent to tertiary recipients.
  • Subject: the subject of the email.
  • Mode: you can send your email as plain text or if you wish to add more "color" to your message, you can send a HTML email.
  • Message: the actual text of the email. If you set the last parameter (Mode) to HTML, then you'll be able to put HTML code here for a nicer email look.
 

Notes:

  1. If you write HTML tags but haven't set the Mode option to HTML, the HTML tags will not be interpreted and the user, instead of seeing a nice bold message for example, may see the actual HTML code.
    • You can use the form's specific placeholders when configuring these emails(they can be viewed by clicking inside the above configurable fields).
    • You can also use the "If" statement pseudo-code (allowing you to easily control whether or not to display certain placeholder information) and the form's global placeholders (these provide general information of your form). These are explained here.
 
Scripts

The RSForm!Pro script sections offer an increased flexibility. With the proper PHP / MySQL / Javascript knowledge you can do just about anything on form directory related.

PHP Scripts

  • Scripts called on listing layout:
    • Scripts added in this area are executed just before the directory listing page is displayed.
    • The $directoryLayout string contains the HTML code of the directory listing page.
  • Scripts called on details layout:
    • Scripts added in this area are executed just before the details page is displayed.
    • The $detailsLayout string contains the HTML code of the directory details page.

PHP Email Scripts

  • Script called when Directory Emails are created.
    • Scripts added in this area are executed before your configured emails are sent.
    • The $directoryEmail array contains the email contents without placeholders replaced. You can use the $placeholders and $values variables to make your own adjustments to them.
  • Script called before the Directory Emails are sent:
    • Scripts added in this area are executed before your configured emails are sent, after the scripts added in the Scripts called when Directory Emails are created field.
    • The $directoryEmail array contains all the information that will be sent in the email.

18 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 View Menu Item HOT

How to display a Community Builder profile HOT