Data Entry Form: Select the data-entry form you wish to associate with this module. This will determine what data XMod will retrieve and also which form XMod will present to users when appropriate.
Choose Category: This optional setting allows you to filter the results returned to the user. By selecting a category, you're telling XMod to only retrieve records associated with the data-entry form and assigned to the selected category.
Page Size: This determines how many records are displayed per page when XMod is displaying a list of records.
Ignore Display/Expiry Dates: XMod allows you to set a "show" and "hide" date for each record so that records can be scheduled to appear at a certain time and will then expire at a certain time. Checking this box allows you to bypass this functionality and see records, regardless of their display and expiration dates.
Result Set Size: Use this to limit the number of records returned by XMod. Setting this to a reasonably low number can improve performance but it also allows you to create "newest additions" type of views.
Filter Using Form Values: Checking this box allows you to further refine the result set XMod returns. Once you've selected a data-entry form (see above), the drop-down list box will be populated with fields from that form. You can specify that only records that have a field with a certain value will be displayed.
Filter Using URL Parameter: Beginning with XMod 3, you can pass a value to an XMod module via URL parameter (also called a query string parameter). You tell XMod what parameter to look for and which field to look in for that parameter's value.
Show Only Current User's Records: This filter type, added in XMod 3, allows you to setup modules that are specific to a given user. If the user is logged-in he/she will only see records that he/she has added. If the user is allowed (by the form's permissions) to edit/delete records prior to a record's approval, then the user will have the option of seeing his un-approved records (via the Show Approved and Unapproved Items checkbox). If the current user is an "admin" "host" or in an "approver" role, all users records will be visible.
Encrypt URL's: XMod sometimes sends data "in the clear" to itself via the URL. Most of the time this isn't a problem. However, if you want to keep users from attempting to view data they don't have access to by changing parameters in the URL, you can check this box. XMod will then encrypt the data it sends so users can't manipulate the URL's data.
"No Items Found" Message: When XMod can't find any records based on the given settings, it displays a message to the user. You can customize what that message using this setting.
Default Sorting: Once you've chosen a data-entry form (see General Settings), you can specify a default sort order for the results XMod displays. Simply select the field and whether results should be sorted in ascending or descending order.
User Searching: Here you can enable/disable the ability of users to search through XMod's data, tell XMod which fields it should search for the user's search terms, and what text to use for the search box. You can define the caption used identify the search terms input box as well as the text of the link the user clicks to perform a search.
NOTE: If possible, restrict the number of fields you allow the user to search in. A large number of fields may severely impact performance.
User Sorting: Much the same as the User Searching settings, the User Sorting settings allow you to enable/disable the user's ability to sort, choose which fields XMod will make available to the user to sort on, and set the captions used in conjunction with the sorting user interface.
NOTE 1: only single-value fields can be sorted.
NOTE 2: To enable user sorting XMod constructs a list control which displays allows the user to select from the fields you've chosen. To present them in a more user-friendly manner, XMod uses the value of the <label> tag for each field.
Detail View Template: This is the template XMod uses when the user clicks a detail link or is otherwise taken to a detailed view of a single record.
NOTE: The detail view template is required. However, if you know you won't be providing a detailed view of your data (i.e. you won't provide any detail links in your list view template) you can set this to any template you want. XMod will only try to use the template if it's called on to display a record's details.
List View Template: XMod uses this template when it displays a list of records.
NOTE: A template doesn't have to be a List View template to be used in this capacity. Since both Detail and List View templates describe the display for a single record, it's possible to use a Detail View template for the List View. Generally this is done if the view is simple and won't be taking advantage of list/grid styles, etc.
Show Only List View Templates: If you have a large number of templates, checking this box can help by showing you only templates that have been marked as List View templates.
List View Header/Footer: When XMod builds the display for your list view, it will add a header and footer row (unless the list view template turns these off). You can put anything you want in these areas, including HTML tags. Most people use the header section to provide a description of the results the user is viewing.