The OUTPUT control block defines what the output 'template' will be for the results.

Below the simple Wiki Formatting Within Plugin is discussed as well as the standard/built-in templates, e.g., table, medialist and carousel. For user defined wiki or smarty templates see PluginList advanced output control block.

• PluginList output control block
  • Parameters
  • Built-in templates
  • Basic Wiki Formatting Within Plugin
  • Table Formatting
    • Table Column Control
      • Column Parameters
      • Column Mode Parameter
      • Format parameters
    • Download CSV of Table Results
    • Table formatting with tablesorter
    • Table: expand table, number of items found, optional title
  • Media List Formatting
  • Carousel Formatting
    • Carousel parameters
    • Example
    • Wikisuite Bpm Mobile
    • Wikisuite Security Mobile
    • Test3
    • colorbox
    • Wikisuite Os Mobile
    • Wikisuite Chat Mobile
    • Wikisuite Commerce Mobile
    • Tiki19 Slide1
    • Tiki Slideshow2
    • Test
    • forum_and_list_synchro_admin_v3.png
    • Layout Bg Optimized
    • Screenshot2
    • Tikislideshowmobile2Artboard 1 Copy
    • Wikisuite Web Mobile
    • 9.zip
    • Tiki19 Slide5
    • Tiki19 Slide4
    • Tiki19 Slide6
    • 5.zip
    • Wikisuite Files Mobile
    • Wikisuite Email Mobile
    • Tiki19 Slide3
    • Tiki19 Slide2
    • TikislideshowmobileArtboard 1
    • Fade Example
    • Wikisuite Bpm Mobile
    • Wikisuite Security Mobile
    • Test3
    • colorbox
    • Wikisuite Os Mobile
    • Wikisuite Chat Mobile
    • Wikisuite Commerce Mobile
    • Tiki19 Slide1
    • Tiki Slideshow2
    • Test
    • forum_and_list_synchro_admin_v3.png
    • Layout Bg Optimized
    • Screenshot2
    • Tikislideshowmobile2Artboard 1 Copy
    • Wikisuite Web Mobile
    • 9.zip
    • Tiki19 Slide5
    • Tiki19 Slide4
    • Tiki19 Slide6
    • 5.zip
    • Wikisuite Files Mobile
    • Wikisuite Email Mobile
    • Tiki19 Slide3
    • Tiki19 Slide2
    • TikislideshowmobileArtboard 1
  • Count Formatting
  • Report Formatting
  • Wiki Formatting (Within Plugin)
    • All the LIST Plugin control blocks

By placing Wiki syntax directly in the OUTPUT body content, along with the required objects to be displayed, the control block allows a template for each row of output to be constructed within the LIST plugin itself.

In the example below a table is constructed with the table 'header' row placed before the LIST and the table closing characters placed after the LIST. Each row of the table is then created by the LIST plugin with each table cell element generated by the display control block and separated by the usual table separator, i.e., a |

||Type|Object
{LIST()}
{list max="10"}
    {OUTPUT()}{display name="object_type"}|{display name="object_id"}
    {OUTPUT}
    {ALTERNATE()}This will display if no results are found{ALTERNATE}
{LIST}
||

A simple built-in templating method can be used by setting the OUTPUT template parameter to table and then using a column control block in the OUTPUT body content to define the individual columns of the table.

Column Parameters

Column Mode Parameter

When you use table output with a column generating HTML output (like objectlink and trackerrender formatted values), you should include the mode="raw" in the column specification. In the sample below, the column "title" mode is set to raw as in the format we want to display an objectlink. Other formats are available; see more about it here: PluginList display control block

Format parameters

Added in Tiki 11+ editable=inline will set the field to be editable inline.
Required: "Inline editing (found in trackers)", format="tracker render" and column should be set to mode=raw.

{LIST()}
{pagination max="12"}
{filter field="tracker_id" content="17"}
{filter type="trackeritem"}
{OUTPUT(template="table")}
  {column sort="title" label="Title" translatelabel="y" field="title_link" mode="raw"}
  {column label="Started" field="started" mode="raw"}
  {column sort="tracker_field_18" field="completed" label="Completed"}
{OUTPUT}
  {FORMAT(name="title_link")}{display name="title" format="objectlink"}{FORMAT}
  {FORMAT(name="started")}{display name="tracker_field_started" format="trackerrender" editable=inline}{FORMAT}
  {FORMAT(name="tracker_field_completed")}{display name="tracker_field_completed"}{FORMAT}
{LIST}

Note that the column controls (within OUTPUT) are converted to a data array sent to the template. The table formatting uses Smarty formatting and provides the same capabilities.

(Tiki 18+) translatelabel="y" will translate the column label provided the translation is known to Tiki.

The use of the FORMAT control blocks allows individual objects to be 'formatted' and then referenced in the various OUTPUT methods - see PluginList format control block for more details.

(Tiki 18+) downloadable=filename.csv parameter can be used to add a Download button which generates a CSV file with all data found in the table. Header row is based on the table headers formatted via column mode parameter.

{OUTPUT(template="table" downloadable="Sample file.csv")}
...column specification...
{OUTPUT}

(Tiki 25+) downloadable-position="top|bottom|both" parameter controls position of the Download button. Values are top,-+bottom+- or both. Default is "bottom".

{OUTPUT(template="table" downloadable="Sample file.csv" downloadable-position="top")}
...column specification...
{OUTPUT}

Starting with Tiki15, PluginList can be used with tablesorter. Use a {tablesorter} tag to add the tablesorter parameters. See below, which uses the same syntax as above except for the addition of the tablesorter tag:

{LIST()}{pagination max="12"}
{filter field="tracker_id" content="17"}
{OUTPUT(template="table")}
{column label="Month" field="month" mode="raw"}
{column label="Started" field="started"}
{column label="Completed" field="completed"}
{column label="Status" field="status"}
{tablesorter server="n" sortable="type:reset" tsortcolumns="type:text|type:none|type:none|type:text" tsfilters="type:nofilter|type:nofilter|type:nofilter|type:dropdown;empty:empty" tstotals="| |type:col;label:Total hours|" tstotaloptions="ignore|ignore| |ignore" tstotalformat="#,###."}
{OUTPUT}
{FORMAT(name="month")}{display name="tracker_field_month" format="objectlink"}{FORMAT}
{FORMAT(name="started")}{display name="tracker_field_started"}{FORMAT}
{FORMAT(name="completed")}{DIV(type="span" class="float-right")}{display name="tracker_field_completed"}{DIV}{FORMAT}
{FORMAT(name="status")}{display name="tracker_field_status" default=""}{FORMAT}
{LIST}

Will produce the following (note that a span and bootstrap class are added to align the numbers as by default tablesorter calculation are numbers aligned right)

{LIST()}
   {filter type="trackeritem"}
   {filter content="water"}
   {OUTPUT(template="table")}
       {column sort="title" label="Title" field="title_link" mode="raw"}
       {column label="Description" field="description"}
       {column sort="tracker_field_18" field="event_date" label="Event Date"}
       {tablesorter server="n" sortable="type:reset" tsortcolumns="type:text|type:text|type:digit" tsfilters="type:text|type:dropdown|type:digit" tspaginate="max:10" tscolselect="critical|5|6"}
   {OUTPUT}
   {FORMAT(name="title_link")}{display name="title" format="objectlink"}{FORMAT}
   {FORMAT(name="event_date")}{display name="tracker_field_18" format="date"}{FORMAT}
{LIST}

Please note that in some cases, if you want to use the tsfilters, you will need to take into account an extra column at the beginning for the:

• status field
• checkbox to perform actions on the listed items through the PluginListExecute
  you can safely pre-pend, for instance, a "type:nofilter|" at the begining of the parameters of the tsfilter in such cases.

Starting with Tiki20, PluginList has a few optional parameters that work in conjunction with the table built-in template. Use a {tableparams} tag to add these parameters:

• allowtableexpansion: for allowing table expansion (a toggle button to allow wide tables to overflow to the right of the content area rather than be scrollable in a limited-width area) (backported to 19.1 and 18.4)
• shownbitems: to show the number of items found. (backported to 19.1 and 18.4)
• title: whatever string you use here will be shown above the results table, with tiki syntax. The main purpose of this parameter is to allow for the title not to show when there are no results found. (backported to 19.2 and 18.4)

See usage example below:

{LIST()}
  {filter content="1" field="tracker_id"}
{OUTPUT(template="table")}
    {tableparams allowtableexpansion="y" shownbitems="y" title="!This is the title
And this is the subtitle"}
    {column label="Book Title" field="book_title"}
    {column label="Author" field="author"}
    {column label="Pages" field="pages"}
    {column label="Year" field="year"}
{OUTPUT}
  {FORMAT(name="book_title")}{display name="tracker_field_bookTitle"}{FORMAT}
  {FORMAT(name="author")}{display name="tracker_field_bookAuthor"}{FORMAT}
  {FORMAT(name="pages")}{display name="tracker_field_bookPages"}{FORMAT}
  {FORMAT(name="year")}{display name="tracker_field_bookYear"}{FORMAT}
{LIST}

Tiki13+
This sample presents a list of badges obtained by the current user.

{LIST()}
  {filter relation="" objecttype="user" qualifier="tiki.badge.received.invert"}
  {OUTPUT(template="medialist")}
    {icon field="tracker_field_image"}
    {body field="tracker_field_description"}
  {OUTPUT}
{LIST}

Tiki14+

Parameters

This sample presents agile gallery of images as a Bootstrap Carousel.

{LIST()}
  {filter field="gallery_id" content="1"}
  {OUTPUT(template="carousel")}
    {carousel interval="2000" wrap="true" pause="hover" id="mycarousel"}
    {body field="pic" mode="raw"}
    {caption field="caption"}
  {OUTPUT}
  {FORMAT(name="pic")}{display format="wikiplugin" name="wikiplugin_img" fileId="object_id" styleimage="width:100%"}{FORMAT}
  {FORMAT(name="caption")}
!!! {display name="title" default="Untitled"}
{display name="description" default=""}{FORMAT}
{LIST}

New parameters are added regularly and you can check them by looking at "templates/search/list/carousel.tpl"

• interval
• pause
• wrap
• indicators (y/n; to hide or show the small indicators below the content)
• controls
• pagination

In Tiki 18 you can use a fade transition by adding mode="fade" to the carousel tag, and after Tiki 19+ you should use mode="carousel-fade"

Tiki15+
This sample shows how to return a simple count of the number of tracker items in tracker 7. For best performance, it is advised to set the max returned results to 1 to prevent having the index to send all the info for all the results (which will slow the request down unnecessarily).

{LIST()}
  {pagination max=1}
  {filter type="trackeritem"}
  {filter field="tracker_id" content="7"}
  {OUTPUT(template="count")}
  {OUTPUT}
{LIST}

111

Tiki20+
This allows you to have specific output format in a wiki page using the CALC extension (extend the wiki plugin List) to execute a formula on the whole result set returned by the list plugin, thus - do aggregations on the data. Useful for reports on more than one tracker item or the whole search result set.

(also see Calculations Syntax)

Example:

{LIST()}
{filter field="tracker_id" content="45"}
{filter type="trackeritem"}
{OUTPUT(report="y")}
There are {CALC()}(count results){CALC} entries.
The total amounts are {CALC()}
(add (for-each (list results) (formula (if (equals tracker_field_trCurrency (str USD)) tracker_field_trAmount 0))))
{CALC} USD and {CALC()}
(add (for-each (list results) (formula (if (equals tracker_field_trCurrency (str MOP)) tracker_field_trAmount 0))))
{CALC} MOP.
{OUTPUT}
{LIST}

The new subtotal function aggregates data based on a single column (username in our case) and applies an aggregate function to the rest of the columns (you can choose which ones and what functions to apply). The example aggregates time sheet entries based on the username and applies the 'add' function to the time sheet minutes and 'count' function to the invoice number field. At the end, we have the data in this format:
user1|1250|3
user2|140|1
which is suitable for PluginFancyTable. As you can see in the example, we put the results in a fancytable, so a nice-looking report is done. You can add as many filters to the LIST plugin as you want, so time-constrained data is returned.

{LIST()}
{filter field="tracker_id" content="22"}
{filter type="trackeritem"}
{OUTPUT(report="y")}
{FANCYTABLE()}
Username|Duration|Invoice
{CALC()}
(subtotal (list results) (group tracker_field_TimeSheetWorkerUsername) (aggregate tracker_field_TimeSheetMinutesWorked tracker_field_TimeSheetInvoiceFromFreelancer) (formula add count) (separators (str |) (str ~nl~)))
{CALC}
{FANCYTABLE}
{OUTPUT}
{LIST}

For each result, the plugin allows to apply a template. See PluginList advanced output control block.

All the LIST Plugin control blocks