wiki:CcSelectorPlugin

Improve selection of users to be cc-ed

Description

This plugin provides a more helpful experience in the editing of a Trac ticket's CC field than the standard Trac core's functionality. A pop-up window with a list of checkboxes is opened. The user can the check/uncheck boxes, and email addresses are added to or removed from the CC field as needed.

screenshot

Developer list is fetched from the Trac database. Users who logged in at least once (see session table) and have the 'TICKET_VIEW' permission are listed. If you like the old variant better, which is implemented as a hardcoded list in a javascript file, you should stick with the older release [4001] .

Of course, you can always edit the Cc field without all this hassle, all addresses you entered manually will be shown, too and can be removed with checkboxes.

See AutocompleteUsersPlugin for another way to help with filling the Cc ticket field.

Technical notes

JavaScript is required for this plugin to work and it is tested with Firefox, Mozilla and Internet Explorer 6. Reports of this working under Opera / Safari are welcome.

A long-term ambition is to reduce JavaScript logic in favor of a more capable Genshi template, or even a JS-free plugin implementation.

This plugin works with both Trac 0.10, 0.11, and 0.12 (since rev3531). I18n support for Trac >= 0.12 is planned to be added to the 0.11 branch in a backwards-compatible way.

Bugs/Feature Requests

Existing bugs and feature requests for CcSelectorPlugin are here.

If you have any issues, create a new ticket.

defect

12 / 15

enhancement

7 / 8

task

1 / 1

Download

Download the zipped source from here.

Source

You can check out CcSelectorPlugin from here using Subversion, or browse the source with Trac.

Installation

General instructions on installing Trac plugins can be found on the TracPlugins page.

Configuration

The following options should be added to the trac.ini file to configure this plugin:

[cc_selector]
show_fullname = true
username_blacklist = user1, 'user 2'

show_fullname

  • default: false
  • Display full names instead of usernames if available.
  • Use case: If most/relevant Trac users prefer full names over usernames aka login/nicknames.

username_blacklist

  • default: '' (empty string)
  • Usernames separated by comma, that should never get listed.
  • Use case: Hide administrator accounts from the default list.

Want drop-down box for "assign to" field?

If you want a drop-down box for the assign to field all you have to do is set restrict_owner option in TracIni:

[ticket]
restrict_owner = true

This page has more info on this.

About i18n/l10n support

The development version of this plugin is prepared for localization.
But English message texts are still the (POSIX) default. If this isn't your preferred language, you can

  1. check if it's already available from the Trac plugin l10n project at Transifex or
  2. do it yourself (see the l10n cookbook page for Trac plugins for more details).

Contributing your translation is highly appreciated.
You could send it to the plugin's maintainer or contribute to Trac plugin l10n project via Transifex:

Top translations: Trac_Plugin-L10N » cc_selector

http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/cc_selector/chart/image_png

Top translations: Trac_Plugin-L10N » cc_selector-js

http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/cc_selector-js/chart/image_png

Kindly provided by https://ds0k0en9abmn1.cloudfront.net/static/charts/images/tx-logo-micro.png

Preparing the plugin from source requires no additional steps for compiling message catalog files. Only to include translations marked as # fuzzy by the translator, you'll want to do a manual message catalog compilation with the extra -f argument before packaging:

cd ccselectorplugin/
python ./setup.py compile_catalog -f
python ./setup.py bdist_egg

Complaints about missing locale directory are often a side-effect of failure to compile any message catalog for inclusion into Python egg, hence the whole path is missing. Due to a know Trac issue, Babel has to be installed prior to Trac to get it all working as expected.
Again, for more details see the l10n cookbook page for Trac plugins.

Recent Changes

15416 by rjollos on 2016-03-08 21:04:32
0.0.4: Check if js resource exists before adding

Fixes #12695.

15415 by rjollos on 2016-03-08 20:53:05
0.0.3dev: Conform to PEP8
9445 by hasienda on 2010-11-18 20:23:35
CcSelectorPlugin: Change depreciated jQuery call to newer, compliant style.

Inspiration has been taken from #2705.

(more)

Author/Contributors

Author: vnaum
Maintainer: none (needsadoption)
Contributors: terje

Last modified 45 hours ago Last modified on Dec 3, 2016, 8:46:28 AM

Attachments (1)

Download all attachments as: .zip