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).
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:
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:
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: