wiki:TicketCreateButtonsPlugin

Version 3 (modified by Adrian Fritz, 12 years ago) (diff)

Page re-factor. Retrieves code documentation (as in [9441]). Still requires some minor review.

Ticket Create Buttons plugin

Description

The TicketCreateButtons plugin creates configurable buttons in the ticket header to create related tickets. The new ticket can inherit field values from the current ticket.

Usage

  1. Inside a TracIni file you can customize ticket properties
      [ticket-create-buttons]
      <ticket-name>.<argument> = value
    
    • Where <ticket-name>.<argument> = value can be one or many from:
Argument
Version
Required (R)
Optional (O)
Description
Default
tag R Argument to genshi.filters.Transfomer used to find the ticket form element to which the button will be prepended. Typically a custom field name.
* Example: blockedby.tag = .//td[@headers="h_blockedby"]
None
label R The label for the button.
* Example: blockedby.label = Create
None
title R The HTML title element used as a tool tip for the button.
* Example: blockedby.title = Create a new predecessor
None
inherit O Comma-separated list of fields whose values should be inherited from the current ticket. If present but blank, no fields are inherited.
* Example: blockedby.inherit = type, milestone
None
link O Comma-separated list of newfield:currentfield pairs used to link the two tickets. The link field override inherit field.
* Example: blockedby.link = blocking:id sets the new ticket's blockedby field to the current tickets id.
None
set O Comma-separated list of field:value pairs for setting values in the new ticket. The set field override inherit and link fields.
* Example: set = keywords:Foo sets the new ticket's keywords field to Foo.
None
  1. Example - Using the plugin with MasterTicketsPlugin, the following configuration creates buttons to create predecessor and successor tickets:
    [ticket-create-buttons]
    blockedby.tag = .//td[@headers=&#34;h_blockedby&#34;]
    blockedby.label = Create
    blockedby.title = Create a new predecessor
    blockedby.inherit = type, milestone
    blockedby.link = blocking:id
    
    blocking.tag = .//td[@headers=&#34;h_blocking&#34;]
    blocking.label = Create
    blocking.title = Create a new successor
    blocking.inherit = type, milestone
    blocking.link = blockedby:id
    
  2. Example - When used with SubticketsPlugin, new siblings can be created with:
    parents.tag = .//td[@headers=&#34;h_parents&#34;]
    parents.label = Create
    parents.title = Create a new sibling
    parents.inherit = type, milestone, parents
    

Installation

  1. Be noticed
    1. below instructions should be specific for some O.S. Please, help improving them.
    2. broader installation guidelines are made available on TracPlugins
  2. Install plugin:
    • globally, on Linux, with easy_install:
      $ [sudo] easy_install https://trac-hacks.org/svn/ticketcreatebuttonsplugin
      
      • [sudo] is optional case you already have enough authority to modify your server.
      • You might be required to select a specific tag, branch. Defaults to select from trunk

  3. Enable this component by updating TracIni file as follows:
    [components]
    ticketcreatebuttons.* = enabled
    
  4. Configure this component in its own configuration section, by updating TracIni file as follows:
    1. case using this plugin with SubticketsPlugin
      parents.tag = .//td[@headers=&#34;h_parents&#34;]
      parents.label = Create
      parents.title = Create a new sibling
      parents.inherit = type, milestone, parents
      
  5. Restart web server on command line:
    $ [sudo] /etc/init.d/apache2 restart
    
    • [sudo] is optional case you already have enough authority to modify your server.

  6. Test if this component is working properly.
    1. If the plugin is installed correct, the example shown in the #Usage section on this page should reflect on tickets.

Bugs/Feature Requests

Existing bugs and feature requests for TicketCreateButtonsPlugin.

If you have any issues, create a new ticket (please review base before creating).

Source & Download

You can check out TicketCreateButtonsPlugin using Subversion, or browse the source with Trac, or [download:ticketcreatebuttonsplugin download] the zipped source.

Recent Changes

14013 by rjollos on 2014-07-23 19:27:52
Added COPYING file and author email. Refs #11871.
14011 by rjollos on 2014-07-23 16:51:36
Added 3-Clause BSD license, with permission of author. Fixes #11871.
14002 by rjollos on 2014-07-11 20:58:28
Fixed rendering of example on plugin admin page.
(more)

Author/Contributors

Author: ChrisNelson
Maintainer: ChrisNelson
Contributors: