Loading...
 
Display or test the value of a tracker item field

Plugin Tracker Item Field

Introduced in Tiki2

Use this wiki plugin to display or test the value of a field of a tracker item.

Requirements

  • The field must not be hidden
  • To test or display a field, you must have the tiki_p_view_trackers (or tiki_p_view_trackers_pending or tiki_p_view_trackers_closed permission depending on the status of the item
  • The status can be tested without permission

Parameters

Introduced in Tiki2. Required parameters are in bold.
Preferences required: wikiplugin_trackeritemfield, feature_trackers
Parameters Accepted Values Description Default Since
(body of plugin) Wiki text containing an {ELSE} marker.
value text Value to compare against. 2.0
fieldId digits Numeric value representing the field ID displayed or tested 2.0
itemId digits Numeric value representing the item ID. Default is the user tracker item for the current user. 2.0
status (blank)
o
p
c
op
oc
pc
opc
Status of the tracker item 2.0
test (blank)
1
0
Set to Yes (1) to test whether a field is empty (if value parameter is empty) or has a value the same as the value parameter. 2.0
trackerId digits Numeric value representing the tracker ID. 2.0
fields text
separator: :
Colon-separated list of field IDs. Default is all fields 2.0


Limitation

The field must be a simple value (not computed, not item list). The tracker item can be specified by its ID with the itemId plugin param. If it is not specified and the url used to access the page has a itemId parameter, the value of itemId parameter will be used. If after this test is not set and if the User Tracker feature is set on, the user item of the user will be selected.

Examples

For example, you have a user tracker with a field containing the phone number of the user, you can use this plugin with the fieldId=phone_field_id to display in the page the phone number of the user looking at the page:
{trackeritemfield fieldId="1"}


Another example, you want to add a link in a page to a page where a user can fill his user tracker only if the user has no user tracker. You can use this plugin with the fieldId that is the user selector field.
{TRACKERITEMFIELD(fieldId="1" test="1")}Welcome new member, please visit ((this_page)) to fill up your information{TRACKERITEMFIELD}

A field can be tested against a value
{TRACKERITEMFIELD(fieldId="1" test="1" value="toto")}Yes your name is toto{TRACKERITEMFIELD}

See Tracker Field Type for values to match for special fields such as checkboxes.

If you want to do the same thing with a tracker that is not the user tracker but has only one item per user and has a field user selector/1, you can specify the tracker ID like this
{trackeritemfield trackerId="1" fieldId="1"}
{TRACKERITEMFIELD(trackerId="1" fieldId="1" test="1")}Please fill out your review{TRACKERITEMFIELD}


It is also possible to test the status of the user item. For instance if you want to display something only if the item is pending or closed:
{TRACKERITEMFIELD(status="pc")}Sorry, your survey is being processed{TRACKERITEMFIELD}


It is also possible to test if all the fields of as item are not empty:
{TRACKERITEMFIELD(trackerId="1" fields="")}Thank you your form is complete{TRACKERITEMFIELD}


It is also possible to test an alternative:
{TRACKERITEMFIELD(fieldId="1" test="1")}OK{ELSE}NOT OK{TRACKERITEMFIELD}


It is possible to have multiple levels of ELSE:
{TRACKERITEMFIELD(fieldId="1" test="1")}OK{ELSE}{TRACKERITEMFIELD(fieldId="2" test="2")}super ok{ELSE}NOT OK{TRACKERITEMFIELD}{TRACKERITEMFIELD}

Note the order the other test with always be in the ELSE part.

Aliases


doc.tiki.org


Bootstrap

AdminGuide

UserGuide

Keywords

Keywords serve as "hubs" for navigation within the Tiki documentation. They correspond to development keywords (bug reports and feature requests):

Accessibility (WAI and 508)
Accounting (7.x)
Articles and Submissions
Backlinks
Banners
Batch (6.x)
BigBlueButton audio/video/chat/screensharing (5.x)
Blog
Bookmark
Browser Compatibility
Link Cache
Calendar
Category
Chat
Clean URLs
Comments
Communication Center
Compression (gzip)
Contacts (Address Book)
Contact us
Content Templates
Contribution (2.x)
Cookie
Copyright
Credit (6.x)
Custom Home and Group Home Page
Date and Time
Debugger Console
Directory of hyperlinks
Documentation link from Tiki to doc.tiki.org (Help System)
Docs 8.x
Draw 7.x
Dynamic Content
Dynamic Variable
External Authentication
FAQ
Featured links
File Gallery
Forum
Friendship Network (Community)
Gmap Google maps
Groups
Hotword
HTML Page
i18n (Multilingual, l10n, Babelfish)
Image Gallery
Import-Export
Install
Integrator
Interoperability
Inter-User Messages
InterTiki
Kaltura video management (4.x)
Karma
Live Support
Login
Logs (system & action)
Look and Feel
Lost edit protection
Mail-in
Map with Mapserver
Menu
Meta Tags
Mobile Tiki and Voice Tiki
Mods
Module
MultiTiki
MyTiki
Newsletter
Notepad
Payment
Performance Speed / Load
Permissions
Platform independence (Linux-Apache, Windows/IIS, Mac, BSD)
Polls
Profiles
Profile Manager
Report
Toolbar
Quiz
Rating
Feeds
Score
Search engine optimization
Search
Search and Replace
Security
Semantic links (3.x)
Shadowbox
Shadow Layers
Share
Shopping cart
Shoutbox
Slideshow
Smiley
Social Networks
Spam protection (Anti-bot CATPCHA)
Spellcheck
Spreadsheet
Stats
Surveys
Tags (2.x)
Task
Tell a Friend, alert + Social Bookmarking
TikiTests (2.x)
Theme CSS & Smarty
Trackers
Transitions (5.x)
TRIM
User Administration including registration and banning
User Files
User Menu
Watch
WebHelp
WebDAV (5.x)
Webmail
Web Services
Wiki 3D
Wiki History, page rename, etc
Wiki Page Staging and Approval (2.x)
Wiki Plugin extends basic syntax
Wiki Syntax
Wiki structure (book and table of content)
Workspace
WSOD
WYSIWYCA
WYSIWYG (2.x)
XMLRPC


Tiki Newsletter

Delivered fresh to your email inbox!
Newsletter subscribe icon
Don't miss major announcements and other news!
Contribute to Tiki