Changes between Version 26 and Version 27 of BlackMagicTicketTweaksPlugin


Ignore:
Timestamp:
Mar 23, 2016, 6:56:17 PM (8 years ago)
Author:
figaro
Comment:

Cosmetic changes

Legend:

Unmodified
Added
Removed
Modified

  • BlackMagicTicketTweaksPlugin

    v26 v27  
    33= Various hacks to alter Ticket form behaviour and Ticket Permissions
    44
     5{{{#!box info
    56'''Note:''' This hack is available for adoption.
     7}}}
    68
    79== Description
    810
    9 Trac 0.11 provides developers and administrators us with the ability to apply Genshi Transformers to the templates before they are presented to the user. This plugin adds the ability to tweak any of the Ticket fields, be they custom or standard, in the following ways:
     11Trac 0.11 provides developers and administrators with the ability to apply Genshi Transformers to the templates before they are presented to the user. This plugin adds the ability to tweak any of the Ticket fields, be they custom or standard, in the following ways:
    1012 * disable - The field won't be editable.
    1113 * hide - The field will be invisible.
    … …  
    2123== Bugs/Feature Requests
    2224
    23 Existing bugs and feature requests for BlackMagicTicketTweaksPlugin are [query:status!=closed&component=BlackMagicTicketTweaksPlugin&order=priority here].
     25Existing bugs and feature requests for BlackMagicTicketTweaksPlugin are
     26[report:9?COMPONENT=BlackMagicTicketTweaksPlugin here].
    2427
    2528If you have any issues, create a
    26 [/newticket?component=BlackMagicTicketTweaksPlugin&owner=obs new ticket] please cc yourself if you're anonymous or you won't be notified of when I respond.
     29[/newticket?component=BlackMagicTicketTweaksPlugin new ticket].
     30Please cc yourself if you're anonymous or you won't be notified of when I respond.
    2731
    2832[[TicketQuery(component=BlackMagicTicketTweaksPlugin&group=type,format=progress)]]
    … …  
    3034== Download
    3135
    32  * Download the zipped source from [export:blackmagictickettweaksplugin here].
    33  * You can check out BlackMagicTicketTweaksPlugin [/svn/blackmagictickettweaksplugin using Subversion], or [source:blackmagictickettweaksplugin browse the source] with Trac.
     36Download the zipped source from [export:blackmagictickettweaksplugin here].
     37
     38== Source
     39
     40You can check out BlackMagicTicketTweaksPlugin from [/svn/blackmagictickettweaksplugin here] using Subversion, or [source:blackmagictickettweaksplugin browse the source] with Trac.
    3441
    3542== Installation
    … …  
    4350The easiest way to install the BlackMagicTicketTweaksPlugin is to point `easy_install` at the t-h.o SVN repository, such as:
    4451
    45 {{{
    46 #!sh
    47 easy_install http://trac-hacks.org/svn/blackmagictickettweaksplugin/0.11
     52{{{#!sh
     53easy_install https://trac-hacks.org/svn/blackmagictickettweaksplugin/0.11
    4854}}}
    4955
    5056Alternatively, you may download the source and go into the Trac 0.11 directory and then run:
    5157
    52 {{{
    53 #!sh
     58{{{#!sh
    5459python setup.py install
    5560}}}
    … …  
    5762After you have installed the BlackMagicTicketTweaksPlugin, you must enable it. You can do so in the Administration panel of Trac, or in the `trac.ini` file by adding:
    5863
    59 {{{
    60 #!ini
     64{{{#!ini
    6165[components]
    6266blackmagic.* = enabled
    … …  
    6569== Configuration
    6670
    67 Any fields that you would like to tweak with this plugin must be listed in the ''tweaks'' option of the [blackmagic] section in your TracIni. This list is comma-separated and lower case. For example:
     71Any fields that you would like to tweak with this plugin must be listed in the ''tweaks'' option of the `[blackmagic]` section in your TracIni. This list is comma-separated and lower case. For example:
    6872
    69 {{{
    70 #!ini
     73{{{#!ini
    7174[blackmagic]
    7275tweaks = cc, priority, severity
    … …  
    7780The actions are specified as `<field>.<action> = <value>`:
    7881
    79 {{{
    80 #!ini
     82{{{#!ini
    8183[blackmagic]
    8284tweaks = priority
    … …  
    8486}}}
    8587
    86 The following are considered True settings in trac.ini:
     88The following are considered True settings in `trac.ini`:
    8789 * true
    8890 * yes
    … …  
    103105You may create new permissions in Trac for use above (or anywhere you like) by specifying the ''permission'' option, as in:
    104106
    105 {{{
    106 #!ini
     107{{{#!ini
    107108[blackmagic]
    108109permissions = TICKET_CHG_PRIORITY, TICKET_CHG_CC
    … …  
    114115
    115116`ticket_type.* = PERMISSION` replacing * with the ticket type, for example `defect`. So to only allow users with the `TICKET_MODIFY` permission access to defect tickets you would set the following:
    116 {{{
    117 #!ini
     117{{{#!ini
    118118[blackmagic]
    119119ticket_type.defect = TICKET_MODIFY
    … …  
    122122Denying access to a ticket type will prevent users from seeing them in reports, viewing the tickets of that type and creating tickets of that type.
    123123
    124 Currently the ticket_type.* option can only hold one permission, if you want a comma separated list [/newticket?component=BlackMagicTicketTweaksPlugin&owner=obs raise a ticket] and request it.
     124Currently the ticket_type.* option can only hold one permission, if you want a comma separated list [/newticket?component=BlackMagicTicketTweaksPlugin raise a ticket] and request it.
    125125
    126126To use this option you will need to add BlackMagicTicketTweaks to the permission_policies option in the [trac] section of the `trac.ini` file:
    127127
    128 {{{
    129 #!ini
     128{{{#!ini
    130129[trac]
    131130permission_policies =  BlackMagicTicketTweaks, DefaultPermissionPolicy
    … …  
    134133== Example
    135134
    136 {{{
    137 #!ini
     135{{{#!ini
    138136[blackmagic]
    139137permissions = MASTER_OF_PERMISSIONS, TICKET_RAISE_DEFECT