History: Viewing Tracker Results

            !! View or List the results
^__Step Four__ in: __Four Steps to make a Tracker__
||__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).

^::{img src="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:
{CODE()}
! All Staff (alphabetical)
^{TRACKERLIST(trackerId=>2,fields=>5:11:30:41, showtitle=>n, showlinks=>y,
showdesc=>n, showinitials=>n, showstatus=>n)}Notice{TRACKERLIST}^
{CODE}

This example, when inserted in a wiki page, would produce:

^::{img src="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)):

{CODE()}
{TRACKERFILTER(filters=>5:11:12/d:30,action=>Find items, showtitle=>n,
showlinks=>y, showdesc=>n, showinitials=>n, showstatus=>n)}{TRACKERFILTER} 
{CODE}

This other example would produce:

^::{img src="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:

{CODE()}
!! 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}^
{CODE}

This would produce:

^::{img src="img/wiki_up/trackers_admin_10.png" }::^