[[PageOutline(2-5,Contents,pullout)]]
= Add ticket keywords from a configured list =

== Description ==

This plug-in allows you to add entries to the Keywords entry field from a configured list of keywords by clicking on them.

See also KeywordSuggestPlugin.

== Bugs/Feature Requests == 

Existing bugs and feature requests for TracKeywordsPlugin are 
[report:9?COMPONENT=TracKeywordsPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=TracKeywordsPlugin&owner=thomasvs new ticket].

== Download ==

Download the zipped source from [download:trackeywordsplugin here].

== Source ==

You can check out TracKeywordsPlugin from [http://trac-hacks.org/svn/trackeywordsplugin here] using Subversion, or [source:trackeywordsplugin browse the source] with Trac.

== Install/Configuration ==
 
  1. Proceed with normal installation of plugins.
  1. Update the ticket template page to include this plugin page section `keywords.html`.[[BR]]
      * You can do this by including the following line somewhere in the ''html'' code:
{{{
<xi:include href="keywords.html" />
}}} 
          * Suggested place: right before `</body>`. 
      * Trac 0.12 files:
          * `<trac_egg>/trac/ticket/templates/ticket.html`
          * `<trac_egg>/trac/wiki/templates/wiki_edit.html` (For a slight integration with TagsPlugin, see #8799)
      * Trac 0.10 `ticket.cs` file:
{{{
...
</fieldset><?cs /if ?>;

<?cs include "keywords.cs" ?>

 <?cs if:ticket.actions.accept || ticket.actions.reopen ||
         ticket.actions.resolve || ticket.actions.reassign ?>
...
}}}
  1. In `trac.ini` file, set up the keywords like:
{{{
[keywords]
dupsearch = find duplicates for this ticket
deploy = waiting to be deployed
backport = ask for a decision on whether to backport
}}}
     * The format is `name = description`

== Recent Changes ==

[[ChangeLog(trackeywordsplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:thomasvs] [[BR]]
'''Maintainer:''' [wiki:thomasvs] [[BR]]
'''Contributors:''' rea