Loading...
 

History: Tracker Handler

Preview of version: 10

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 also supported.

Tracker Handler Example for a Bug Tracker

YAML
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.
  • action
  • attachment
  • auto_increment
  • calendar
  • category
  • checkbox
  • computed
  • country
  • datetime
  • dropdown
  • dropdown_other
  • email
  • group
  • header
  • image
  • ip_address
  • item_link
  • item_list
  • item_list_dynamic
  • map
  • multimedia
  • numeric
  • preference
  • radio
  • static
  • system
  • text_area
  • text_field
  • user
  • user_subscription

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.



Questions/bugs


How can I assign specific permissions to a tracker I create? Ex.: tiki_p_create_tracker_items assigned to Anonymous

History

Advanced
Information Version
Wed 19 of Oct, 2016 22:31 GMT-0000 Xavier de Pedro added info about visBy and editBy 32
Wed 18 of May, 2016 08:28 GMT-0000 Xavier de Pedro added immutable as visible value 31
Mon 23 of Feb, 2015 03:24 GMT-0000 Nelson Ko add example of tracker item creation 30
Fri 07 of Feb, 2014 08:48 GMT-0000 Xavier de Pedro added more info to distinguish/find both date & time pickers 29
Wed 05 of Feb, 2014 09:42 GMT-0000 Xavier de Pedro added info on user_see_own (userCanSeeOwn). added in r49721 28
Sun 29 of Dec, 2013 14:12 GMT-0000 dirschneid Code Plugin modified by editor. 27
Sun 27 of Jan, 2013 01:31 GMT-0000 Marc Laporte was backported 26
Wed 23 of Jan, 2013 15:18 GMT-0000 Jonny Bradley Missing tracker options 25
Mon 29 of Oct, 2012 18:44 GMT-0000 Marc Laporte better link 24
Tue 18 of Sep, 2012 18:42 GMT-0000 Louis-Philippe Huberdeau New tracker_option field handler 23
Tue 05 of Jun, 2012 17:04 GMT-0000 Louis-Philippe Huberdeau Adding creation removal options 22
Mon 21 of May, 2012 21:30 GMT-0000 Marc Laporte As discovered when doing CartoGraf profile 21
Sat 21 of Apr, 2012 10:04 GMT-0000 Jean-François B. Wrong typo 20
Sat 11 of Feb, 2012 18:42 GMT-0000 Xavier de Pedro added some names of pref names to enable some tracker fields since tiki8 19
Mon 08 of Aug, 2011 14:00 GMT-0000 Louis-Philippe Huberdeau Adding new parameters in 8.x 18
Mon 13 of Sep, 2010 22:35 GMT-0000 Marc Laporte cleaner 17
Wed 09 of Jun, 2010 12:21 GMT-0000 Jonny Bradley 16
Tue 18 of May, 2010 17:52 GMT-0000 luciash d' being 🧙 15
Tue 18 of May, 2010 16:57 GMT-0000 luciash d' being 🧙 [rollback version 12] 14
Tue 18 of May, 2010 17:17 GMT-0000 luciash d' being 🧙 13
Sat 10 of Apr, 2010 19:18 GMT-0000 Geoff Brickell 11
Wed 10 of Mar, 2010 06:12 GMT-0000 luciash d' being 🧙 added wikiplugin sort 10
Tue 26 of May, 2009 00:05 GMT-0000 Marc Laporte 9
Thu 01 of Jan, 2009 00:29 GMT-0000 Marc Laporte How can I assign specific permissions to a tracker I create 8
Sat 23 of Aug, 2008 15:35 GMT-0000 Marc Laporte 7
  • «
  • 1 (current)
  • 2