wiki:TicketCreateButtonsPlugin

Version 12 (modified by figaro, 9 years ago) (diff)

Rearranged paragraphs, further cosmetic changes

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.

Bugs/Feature Requests

Existing bugs and feature requests for TicketCreateButtonsPlugin.

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

defect

0 / 1

task

2 / 2

Source and Download

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

Installation

  1. Note:
    1. Below instructions could be specific to some operating systems. Please help expanding these instructions.
    2. Generic installation guidelines are available at TracPlugins.
    3. [sudo], when used, is optional case you already have enough authority to modify your server.

  2. Install plugin:
    • with easy_install, globally:
      [sudo] easy_install https://trac-hacks.org/svn/ticketcreatebuttonsplugin
      
      • You might be required to select a specific tag, branch. Defaults to select from trunk

  3. Enable this component as follows:
    • by updating trac.ini file under appropriate configuration section:
      [components]
      ...
      ticketcreatebuttons.* = enabled
      ...
      
    • or accessing your Admin panel under selected Trac environment ..admin/general/plugins .

  4. Configure Trac environment as follows:
    • by updating trac.ini file under appropriate configuration section:
      1. case using this plugin with SubticketsPlugin
        [ticket-create-buttons]
        parents.tag = .//td[@headers="h_parents"]
        parents.label = Create
        parents.title = Create a new sibling
        parents.inherit = type, milestone, parents
        
    • or accessing your Admin panel (under selected Trac environment ..admin/general/plugins ).

  5. Restart web server:
    • Apache on Ubuntu, example command line:
      [sudo] /etc/init.d/apache2 restart
      


  6. Test if this component is working properly (main environment and secondary ones if also exists).
    1. If the plugin is installed correct, the configuration you have made should reflect on tickets.

Configuration and examples

  1. Under the appropriate section inside a TracIni file you can customize ticket properties as below:
      [ticket-create-buttons]
      <field-name>.<argument> = value
    
    where <field-name>.<argument> = value can be one or many from below:
    • R - Required
    • O - Optional
Argument Version R / O Description Default
tag >= 0.1 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 >= 0.1 O The label for the button.
* Example: blockedby.label = Create
<field-name>
title >= 0.1 O The HTML title element used as a tool tip for the button.
* Example: blockedby.title = Create predecessor
None
inherit >= 0.1 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
No fields are inherited.
link >= 0.1 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 >= 0.1 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 this plugin with MasterTicketsPlugin, the following configuration creates buttons to create predecessor and successor tickets:
    [ticket-create-buttons]
    blockedby.tag = .//td[@headers="h_blockedby"]
    blockedby.label = Create
    blockedby.title = Create a new predecessor
    blockedby.inherit = type, milestone
    blockedby.link = blocking:id
    
    blocking.tag = .//td[@headers="h_blocking"]
    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:
    [ticket-create-buttons]
    parents.tag = .//td[@headers="h_parents"]
    parents.label = Create
    parents.title = Create a new sibling
    parents.inherit = type, milestone, parents
    

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: Chris Nelson
Contributors: