[[PageOutline(2-5,Contents,pullout)]]

= 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. A pop-up window with bunch of checkboxes is opened, user checks boxes, email addresses are added to and removed from Cc ticket field.

'''!JavaScript is required''' and working 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.

It 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.

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

[[Poll(Do you need the fixed list option and would like to get it back to an upcoming release?; Yes, got stuck with old release because of this; Yes, because I badly miss it; No, found another solution/like to patch on my own; No, don't care/don't need such stuff)]]

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 new, shiny checkboxes.

See [wiki:AutocompleteUsersPlugin AutocompleteUsersPlugin] for another way to help with filling the Cc ticket field.

== Bugs/Feature Requests

Existing bugs and feature requests for CcSelectorPlugin are 
[report:9?COMPONENT=CcSelectorPlugin here].

If you have any issues, create a 
[/newticket?component=CcSelectorPlugin new ticket].

[[TicketQuery(component=CcSelectorPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:ccselectorplugin here].

== Source 

Check out [/svn/ccselectorplugin using Subversion], or [source:ccselectorplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Configuration

The following options should be added to the `trac.ini` file to configure this plugin:
{{{#!ini
[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 "assign to" field - it's already in Trac since 0.9. All you have to do is set restrict_owner option in TracIni like:
{{{#!ini
[ticket]
restrict_owner = true
}}}

This [t:TracTickets#Assign-toasDrop-DownList page] has more info on this.

== Example

A pop-up window with a list of checkboxes is opened. The user can the check/uncheck boxes, and email addresses are added and/or removed to CC field as needed.

[[Image(cc_selector.png, border=2)]]

== About i18n/l10n support

The development version of this plugin is prepared for localization.[[BR]]
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 [TracPluginTranslation Trac plugin l10n project] at [http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/cc_selector Transifex] or
 2. do it yourself (see the [t:wiki:CookBook/PluginL10N#Dotranslatorswork l10n cookbook page for Trac plugins] for more details).

Contributing your translation is highly appreciated.[[BR]]
You could send it to the plugin's maintainer or contribute to [TracPluginTranslation Trac plugin l10n project]
via [http://www.transifex.net/projects/p/Trac_Plugin-L10N/ Transifex]:

Top translations: Trac_Plugin-L10N » [http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/cc_selector/ cc_selector][[BR]]
 [[Image(http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/cc_selector/chart/image_png, title=Go to Trac_Plugin-L10N project page on Transifex.net, link=http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/cc_selector/)]]
Top translations: Trac_Plugin-L10N » [http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/cc_selector-js/ cc_selector-js][[BR]]
 [[Image(http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/cc_selector-js/chart/image_png, title=Go to Trac_Plugin-L10N project page on Transifex.net, link=http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/cc_selector-js/)]]
Kindly provided by [[Image(https://ds0k0en9abmn1.cloudfront.net/static/charts/images/tx-logo-micro.png, link=http://www.transifex.net/, title=the open translation platform, valign=bottom)]]

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:

{{{#!sh
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.[[BR]]
Again, for more details see the [t:wiki:CookBook/PluginL10N#Compileanduseit l10n cookbook page for Trac plugins].

== Recent Changes

[[ChangeLog(ccselectorplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:vnaum] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' terje