Loading...
 

PluginTracker Advanced

On this page we describe some special uses of the very talented PluginTracker and how it integrates with the wiki, for example how pretty tracker is created.

Setting default values for the tracker (form)

set some default values in the tracker from the plugin:
For each field, you have to specify a value. If you do not want a default value set nothing

Copy to clipboard
{TRACKER(trackerId="1" fields="1:2:3" values="first::second")}Thank for your contribution!{TRACKER}

Will default fieldId 1 to first, and fieldId3 to second

Note: For JS Calendar fields, enter the date and time using a Unix-style timestamp

Having different defaults by linking to different pages

set some default values in the tracker from the url:
Example: I have a trackerplugin in a page A with fields=1:2:3 If I call the page with
tiki-index_raw.php?page=A&values[]=first&values[]=&values[]=second , I will have at the first access of the page, the field 1 prefilled with first and the field 3 prefilled with second.
If I want only some fields to be default I need to use prefills . Example:
tiki-index_raw.php?page=A&prefills=1:3&values[]=first&values[]=second
This kind of url can be built with the tracker PluginTrackerPrefill

Multi-page tracker forms

fill up a tracker item on different pages
The tracker must have a field 'user selector' with option 1. On one page you can use

Copy to clipboard
{tracker trackerId="1" view="user" fields="1:2" action="Save and Next" url="tiki-index_raw.php?page=next"}
in the first page

and in the page Next

Copy to clipboard
{TRACKER(trackerId="1" view="user" fields="3:4" action="Save")}Thank you{TRACKER}


In TIki 8, there is also a way to use autosavefields and levelupfields to store a value in the field that keeps track of at what stage the user has completed the multi-page form.

Conditional display of input fields

Custom designed (using wiki, css or html layout) forms

To use TRACKER plugin to place data-entry fields anywhere you want on a page

    • First, create a wiki page that will be used as a template file, call it something like TrackerWikiTpl. Somewhere in it, put your field placeholders.
Copy to clipboard
||{$f_2085}|{$f_1019} {$f_1020}| {$f_1021}||

Note:replace the numbers above with your actual fieldIds - check "edit fields" in the tracker list.

    • Change the perms on the template as described in the big table above. (Note: seems to work without that permission set, but don't be fooled--set tiki_p_use_as_template on your templates.)
    • Do NOT have tiki_p_admin_trackers as special perm on the user tracker (tiki-objectpermissions.php).
    • If you want the user tracker data private only to each user, set tiki_p_create_tracker_items and tiki_p_modify_tracker_items permissions for the user group on the user tracker (there may be a bug here...) (tiki-objectpermissions.php).
    • Set "Item creator can modify his items" to yes (checked) on the user tracker (tiki-admin_trackers.php).
    • Set "Only one item per user or IP" to yes (checked) on the user tracker (tiki-admin_trackers.php).
    • Create another wiki page, call it something like DataEntry. In it, place code such as this:
Copy to clipboard
{tracker trackerId="4" wiki="TrackerWikiTpl" view="user"}

(trackerId seems to be required at the moment).

    • Request the DataEntry page in your browser: http://yoursite.com/tiki-index_raw.php?page=DataEntry
    • Tiki will replace your TRACKER tag in DataEntry with the contents of the TrackerWikiTpl with the editable fields arranged as you wished.
    • Here is a simple example of the kinds of complex data-entry tables you can create:

Image
See also http://doc.tiki.org/PluginTrackerlist the section pretty tracker

List Slides