[[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 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. [[Image(cc_selector.png, border=2)]] 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 [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 You can check out CcSelectorPlugin from [/svn/ccselectorplugin here] 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 the //assign to// field all you have to do is set `restrict_owner` option in TracIni: {{{#!ini [ticket] restrict_owner = true }}} This [TracTickets#Assign-toasDrop-DownList page] has more info on this. == 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 1. 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