View or List the results
Step | Details | Help Page |
1. Create the Tracker | Admin names the tracker, and assign overall parameters and permissions | Creating a Tracker |
2. Add fields to the Tracker | Admin defines the columns and type of information collected | Adding fields to a tracker |
3. Add items to the tracker | Users fill out the forms to create items in the tracker | Adding items to a tracker |
4. View or List the results | Use plugins to view a customized tracker output in a page | Viewing Tracker Results |
5. Assign Trackers to Groups | optional - trackers can also be used upon registration | Assigning Trackers to groups |
Once items have been inserted into a tracker, they can be viewed or listed through the tracker interface itself, or using tracker-related Plugins inside wiki pages.
Listing results through tracker interface
When using the tracker feature itself (i.e., tiki-view_tracker.php?trackerId=N), very little customization is allowed for the end user, plus there is no message shown to the user after insertion of new items (either success or failure messages, for instance).
![Image](img/wiki_up/trackers_admin_12.png)
However, when using tracker plugins inside Wiki pages, much more customization of the fields to be shown in a table with the results is allowed. (PluginTrackerList).
Listing results through Wiki plugins
You can list all items in a tracker, allow a user to select which filters he/she wants to use to have a selection of items shown, or show users a pre-made selection of items in the tracker.
1. PluginTrackerList to list all
In order to list all items in tracker 2 (Staff) you can use something like:
! All Staff (alphabetical) ^{TRACKERLIST(trackerId=>2,fields=>5:11:30:41, showtitle=>n, showlinks=>y, showdesc=>n, showinitials=>n, showstatus=>n)}Notice{TRACKERLIST}^
This example, when inserted in a wiki page, would produce:
![Image](img/wiki_up/trackers_admin_09.png)
2. PluginTrackerFilter to allow filtering for a user
Moreover, another Wiki Plugin can be added in order to allow the user to choose from a Wiki page which items and fields from that tracker want to see within that Wiki page. This can be achieved with the PluginTrackerFilter:
{TRACKERFILTER(filters=>5:11:12/d:30,action=>Find items, showtitle=>n, showlinks=>y, showdesc=>n, showinitials=>n, showstatus=>n)}{TRACKERFILTER}
This other example would produce:
![Image](img/wiki_up/trackers_admin_11.png)
3. PluginTrackerList to list a sub-set of items
Besides that, we can filter for members of a single group as follows, using PluginTrackerList and adding the filterfield and filtervalue parameters. For instance:
!! Staff from GEMM group ^{TRACKERLIST(trackerId=>2,fields=>5:11:30, showtitle=>n, showlinks=>y, showdesc=>n, showinitials=>n, showstatus=>n, filterfield=>41, filtervalue=>GEMM)}Notice{TRACKERLIST}^
This would produce:
![Image](img/wiki_up/trackers_admin_10.png)