"ARI Smart Content - Data Table" module shows HTML tables in module positions. The module can be enabled/disabled and configured on "Extensions → Module Manager" page on Joomla! backend. The module offers the following parameters:
- Data source is a main and required parameter. It is used to select the data source which will be used to populate the table with data. It is possible to select data sources from Database data section.
- Use constant ID if the parameter is set to 'Yes', table container will have the constant ID based on module ID. It can be useful for caching or other purposes.
- Load method is used to specify load method on client side. If it is set to 'On Load', the datatable will be created when page and all resources (images, styles and etc.) are loaded by a browser. If it is set to 'DOM Ready', the datatable will be created immediately when page is loaded (it doesn't wait till all resources are loaded, they will be loaded in parallel). In other words, 'DOM Ready' event occurs before 'On Load' and if possible it is preferable to use it instead of 'On Load'. This parameter can be useful to resolve conflict with some 3rd party extensions, if the extension doesn't work properly when it's set to 'DOM Ready', try to switch it to 'On Load'.
- Module Class Suffix will be applied to the CSS class of the module. This allows for individual module styling.
- Theme is used to select a theme.
- Loading pane if this option is enabled, loading icon will be shown till data are loaded.
- Loading message is used to specify text which will be shown when data are loaded.
- Server side pagination if the parameter is set to "Yes", the extension will do requests to the server to load only necessary part of data (if it is supported by the selected data source) when a user changes page, sort data and etc.
"HTML table settings" parameters section is used to define some parameters for HTML table which is created by the extension:
- Caption is used to specify caption of the table.
- Advanced styling if the parameter is enabled then unique CSS classes will be added to each cell and row in the table. Rows will have ari-tbl-row-ROWINDEX class name. Where ROWINDEX is zero-based row index. It means the first row will have ari-tbl-row-0 class name, the seconds row will have ari-tbl-row-1 class name and etc. Cells will have ari-tbl-col-COLINDEX class name. Where COLINDEX is zero-based cell index. It means the first column will have ari-tbl-col-0 class name, the seconds column will have ari-tbl-col-1 class name and etc.
- Show header is used to show/hide table header.
- Show footer is used to show/hide table footer.
- Width is table width. Possible values: auto, 100%, 350px and etc.
- Cell padding is used to specify cell padding. Possible values: 0, 1, 5, 12 and etc.
- Cell spacing is used to specify cell spacing. Possible values: 0, 1, 5, 12 and etc.
- Border is used to specify border width. Possible values: 0, 1, 7 and etc.
- Border collapse property sets whether the table borders are collapsed into a single border or detached as in standard HTML.
- Table CSS class is used to add custom CSS class(es) to the table. Can be used in custom CSS rules to customize table styles.
- Rows CSS classes is used to specify rows CSS classes, CSS classes for different groups separate by semicolons. These CSS classes will be applied to rows in cyclic order. For example if you want to add row_odd class for each odd rows and row_even class for each even rows, use row_odd;row_even value.
- CSS Styles is used to specify additional CSS styles. It is possible to use {$id} predefined variable which will be replaced with ID of the datatable. For example the following code can be used to set text color to red for all columns in the table:
#{$id} TD {color:red;}
- Scroll Height if you want to add vertical scrolling to the table set height of visible area in pixels, otherwise leave this parameter empty. Possible values: 250, 400 and etc.
- Scroll Width if you want to add horizontal scrolling to the table set width of visible area in pixels, otherwise leave this parameter empty. Possible values: 430, 600 and etc.
- Save state is used to enable/disable state saving. When it is enabled a cookie will be used to save table display information such as pagination information, display length, filtering and sorting. As such when the end user reloads the page the display display will match what thy had previously set up.
- Duration of cookie is duration of the cookie which is used for storing session information. This value is given in seconds.
- Filter is used to enable/disable ability to filter data (enter a search string in a textbox).
- Default search string is used to specify a default search string which will be used to filter data.
- Sorting is used to enable/disable sorting of columns.
- Show export buttons if this parameter is set to 'Yes' then 'Copy', 'CSV', 'Excel', 'PDF' and 'Print' buttons will be shown about the table. Export feature is working correctly for data with English characters.
"Paging settings" parameters section is used to configure paging:
- Using paging is used to enable/disable pagination.
- Pagination type is used to select pagination type.
- Paging list is used to show/hide drop-down where page size (number of records which will be shown per page) can be selected.
- Number of rows to display is number of rows to display on a single page when using pagination.
- Choose custom paging mode is used to specify paging parameters. The following modes are supported:
- Simple is used to define page size for page size drop-down. Defined page sizes will be also shown the drop-down. The following parameters are supported for this mode:
- Custom pagination is used to specify page sizes separated by commas. For example: 1,5,10,25,50,100
- Advanced is used to define page sizes and labels for them which will be shown in page size drop-down. If label is not defined then page size value will be shown into the drop-down. The following parameters are supported for this mode:
- Page size is used to define page size option.
- Label is a label which will be shown into page size drop-down.
"Fixed columns" parameters section is used to configure fixed columns. These columns will be frozen and not scrollable. It is useful if scrolling table is used and you want to not scroll some important column(s). The following parameters are available:
- Fixed left columns is used to specify number of columns which will be frozen from left side. Possible values: 0, 1, 3 and etc.
- Width of left columns is used to specify width which will be reserved for fixed left columns. Possible values: 150, 220 and etc.
- Fixed right columns is used to specify number of columns which will be frozen from eight side. Possible values: 0, 1, 3 and etc.
- Width of left columns is used to specify width which will be reserved for fixed rght columns. Possible values: 150, 220 and etc.
"Additional settings" is used to specify some additional parameters for datatable. The following parameters are supported:
- Table information is used to enable/disable the table information display. This shows information about the data that is currently visible on the page, including information about filtered data if that action is being performed.
- Show processing is used to enable/disable the display of a 'processing' indicator when the table is being processed (e.g. a sort). This is particularly useful for tables with large amounts of data where it can take a noticeable amount of time to sort the entries.
- Processing label is text which is displayed when the table is processing a user action (usually a sort command or similar).
- Auto width is used to enable/disable automatic column width calculation.
- Row CSS classes is an array of CSS classes that should be applied to displayed rows. This array may be of any length, and DataTables will apply each class sequentially, looping when required.
- Length menu label detail the action that will be taken when the drop down menu for the pagination length option is changed. The _MENU_ variable is replaced with a default select list of 10, 25, 50 and 100.
- Zero records label is text which is shown inside the table records when the is no information to be displayed. This includes when the table is filtered to zero records.
- Info label this string gives information to the end user about the information that is current on display on the page. The _START_, _END_ and _TOTAL_ variables are all dynamically replaced as the table display updates, and can be freely moved or removed as the language requirements change.
- Info empty label display information string for when the table is empty.
- Info filtered label when a user filters the information in a table, this string is appended to the information (sInfo) to give an idea of how strong the filtering is. The variable _MAX_ is dynamically updated.
- Info postfix label if can be useful to append extra information to the info string at times, and this variable does exactly that. This information will be appended to the information at all times.
- Search label details the actions that will be taken when the user types into the filtering input text box.
- First label is string which will be used as a label for "first page" link.
- Previous label is string which will be used as a label for "previous page" link.
- Next label is string which will be used as a label for "next page" link.
- Last label is string which will be used as a label for "last page" link.