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 then 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] .

Editing the Cc field without using the pop-up window remains possible: all email addresses you enter manually are shown and can subsequently be removed with checkboxes.

See AutocompleteUsersPlugin for another way to help with populating 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 or 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.

Bugs/Feature Requests

Existing bugs and feature requests for CcSelectorPlugin are here.

If you have any issues, create a new ticket.

defect

14 / 16

enhancement

9 / 10

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

18624 by stoecker on 2024-03-27 12:25:54
drop typo
18597 by stoecker on 2023-11-17 10:50:21
CcSelectorPlugin: fix #12161 - incorrect button alignment
18596 by stoecker on 2023-11-17 07:55:48
shorter translation
(more)

Author/Contributors

Author: vnaum
Maintainer: Dirk Stöcker
Contributors: terje

Last modified 3 years ago Last modified on May 15, 2022, 7:16:11 AM

Attachments (1)

Download all attachments as: .zip