Loading...
 

History: Tracker Handler

Preview of version: 6

This handler allows to create trackers and the related fields. This page describes the syntax and available options. To use trackers in profiles, Object References are required.

Item creation is not supported yet.

Tracker Handler Example

Bug Tracker
preferences: feature_trackers: y objects: - type: tracker ref: bug_tracker data: name: Bugs description: Simple Bug Tracker default_status: open show: [status, creation_date, modification_date, list_modification_date ] allow: [comments] - type: tracker_field ref: bug_summary data: name: Summary tracker: $bug_tracker type: text_field flags: [searchable, public, list, mandatory] order: 1 - type: tracker_field ref: bug_priority data: name: Priority tracker: $bug_tracker type: numeric flags: [searchable, public, list] order: 2 - type: tracker_field ref: bug_description data: name: Description tracker: $bug_tracker type: text_area flags: [public, mandatory] order: 3 - type: tracker_field ref: bug_assignee data: name: Assigned to tracker: $bug_tracker type: user flags: [searchable, public, list] order: 4 - type: tracker_item ref: bug_001 data: tracker: $bug_tracker status: open values: - [ $bug_summary, No interface to install profiles ] - [ $bug_assignee, lph ] - [ $bug_priority, 3 ] - [ $bug_description, "If profiles are to help non-programmers and beginners to set-up tikiwiki, why is writing code required to install a profile?" ]


Tracker Object

Field NameMandatoryValue
nameyesTracker name
description Full tracker description
list_default_status A single value or multiple values from (open,pending,closed)
email The email address to contact for any activity on the tracker
email_simplified Send the emails in a simplified format
default_status Status applied to new items from (open,pending,closed)
modification_status Status applied on item modification (open,pending,closed)
show List of display options to activate
statusDisplay the field status field
status_admin_onlyMake the status field only visible to admins
creation_dateDisplay the creation date in the full view
list_creation_dateDisplay the creation date in the item list
modification_dateDisplay the last modification date in the full view
list_modification_dateDisplay the last modification date in the item list
allow List of permissions granted
creator_modificationAllow the creator to modify the item
creator_group_modificationAllow users in the same default group as the creator to edit the item
ratingEnable ratings on items
commentsEnable comments on items
attachmentsEnable attachments on items
creation_date_format Format to display the creation date in
modification_date_format Format to display the last modification date in
sort_default_field The field to sort the tracker list with (creation,modification,item)
sort_default_order Sort order (asc,desc)
restrict_start Only allow items to be added from the provided date
restrict_end Only allow items to be added until the provided date
hide_list_empty_fields (y,n)


Tracker Field Object

Field NameMandatoryValue
nameyesThe label of the field
trackeryesThe ID of the tracker, usually a reference to a tracker object
description A full description of the field
type Tracker field type (list below)
optionsno*Option string, same as tracker field form. Not always needed.
order numeric field to indicate the display order of the tracker fields
visible Field accessibility (public,adminonly,admin_editable,creator_editable)
flags List of field options
listDisplay field in item list
linkLink field to full item view
searchableAllow to filter on field
publicDisplay field in trackerlist
mandatoryIf field is required
multilingualIf field is multilingual


Field types

These are the field names as recognized by TikiProfiles. For more information about the options argument, see Trackers Documentation.
  • text_field
  • text_area
  • checkbox
  • numeric
  • dropdown
  • dropdown_other
  • radio
  • user
  • group
  • ip_address
  • country
  • datetime
  • calendar
  • image
  • action
  • header
  • static
  • category
  • item_link
  • item_list
  • item_list_dynamic
  • email
  • multimedia
  • auto_increment
  • user_subscription
  • map
  • system
  • computed
  • preference
  • attachment

Tracker Item Object

Field NameMandatoryValue
trackeryesThe tracker to add the item to.
status The status of the tracker item (open,pending,closed)
valuesyesA list of field-value pairs. For each item in the list, the first value is the ID of the tracker field and the second value is the value to attribute to it.


History

Advanced
Information Version
Sat 23 of Aug, 2008 08:52 GMT-0000 idealpragmatist 6
Mon 09 of Jun, 2008 14:21 GMT-0000 System Administrator 5
Thu 05 of Jun, 2008 18:20 GMT-0000 System Administrator 4
Thu 05 of Jun, 2008 18:20 GMT-0000 System Administrator 3
Thu 05 of Jun, 2008 18:17 GMT-0000 System Administrator 2
Thu 05 of Jun, 2008 16:56 GMT-0000 System Administrator 1
  • 1
  • 2 (current)
  • »