Version 37 (modified by 12 years ago) (diff) | ,
---|
Contents
Autocomplete feature for the keywords field
Description
The KeywordsSuggestPlugin provides an autocomplete function for the keywords ticket field or any other text-based ticket field. Optionally, it is possible to restrict the list of allowed keywords.
The plugin requires a JavaScript enabled browser. The JavaScript portion was derived from the jQuery UI autocomplete example.
See also LoomingCloudsPlugin.
Bugs/Feature Requests
Development News
Version 0.5dev of this plugin is now available. The 0.11 branch is undergoing frequent change. If you want to test out the latest version, report back how it is working and possibly do some debugging, then the latest version is for you. Otherwise, r11004 should be fairly stable.
Recent changes are:
- Upgraded from the jQuery Autocomplete Plugin to jQuery UI 1.8.16.
- Added support for the TagsPlugin (#4201).
- The autocomplete list can be attached to a text-based field other than the Keywords field (#5831).
- The
helppage
link can point to any resource in any realm. For example, it can be a link to the/tags
page. Previously, it could only point to a wiki page (#5907). - Several bug fixes.
- Regressions introduced in #8141 are being fixed.
Compatibility notes:
- Previously, the
multipleseparator
configuration option was defined in quotes (e.g.", "
). Now, only the separator character should be specified (e.g.multipleseparator = ,
). The default is a single whitespace character. - Several of the configuration options will be renamed before 0.5 is released. Please revisit this section for additional notes before installing a new version.
Planned enhancements before 0.5 is released:
- Allow the autocomplete list to be attached to more than one text-based ticket field. Additionally, different configurations will be supported for each ticket field. For example, one of the ticket fields could be using keywords from the TagsPlugin and the other could be using keywords defined in trac.ini (#5831).
- A new boolean option
usetagsplugin
. Currently, the TagsPlugin will be used when it is installed and enabled. - Offer all keywords used up until now for use, even if the TagsPlugin is not installed (#3816).
- There is the possibility of supporting multiple themes (comment:8:ticket:8141). Please comment in that ticket if you have any thoughts on the issue.
Existing bugs and feature requests for KeywordSuggestPlugin are here.
If you have any issues, create a new ticket.
Download and Source
Download the [download:keywordsuggestplugin zipped source], check out KeywordSuggestPlugin using Subversion, or browse the source with Trac.
Example
The Keywords Label can be the link to a wiki page.
Configuration
Following section must be added to trac.ini configuration file:
[keywordsuggest] field = keywords keywords = tag1,tag2,tag3 mustmatch = False helppage = wiki/TicketKeywords helppage.newwindow = False matchcontains = True multipleseparator = ,
There are two parameters to configure:
- field - field to which the suggestion will be attached (default: keywords)
- keywords - specifies list of comma separated values available for input
- mustmatch - optional, if specified, 'keywords' field accepts values from the keywords list only
- helppage - optional, if specified, 'keywords' label will be turned into the link to a resource. This could be a wiki page, or any resource in any realm, such as the tags page (
helppage = tags
). - helppage.newwindow - optional, whether wiki page opened in new window or not`
- matchcontains - optional, whether keywords which matched not from the beginning must be included into list
- multipleseparator - which character(s) is used as separator between keywords. Must be enclosed with quotas or other characters. If not specified, ', ' is used.
Recent Changes
- 17470 by rjollos on 2019-08-26 21:18:24
-
TracKeywordSuggest 0.5.0dev: Drop support for Trac < 1.0
- 17469 by rjollos on 2019-08-26 20:37:51
-
TracKeywordSuggest 0.5.0dev: Fix failing test cases
- 17189 by rjollos on 2018-06-03 23:14:12
-
TracKeywordSuggest 0.5.0dev: Fix rename error in r12103
Fixes #13433.
(more)
Author/Contributors
Author: scratcher
Maintainer: rjollos
Contributors: itamarost, falkb, hasienda
License: 3-Clause BSD
Attachments (2)
-
autocomplete.png (3.5 KB) - added by 16 years ago.
Sample picture of autocomplete feature
-
keywords.png (514 bytes) - added by 16 years ago.
'helppage' option turned on
Download all attachments as: .zip