[[PageOutline(2-5,Contents,pullout)]]
[[html(
)]]
'''!ToDo'''
* long-term: research reducing JavaScript logic in favor of a more capable Genshi template, or even a JS free plugin implementation
'''News'''
18-Nov-2010:: add some enhancements and i18n support (open: 0)
13-Nov-2010:: changed repository layout, long-standing enhancement (#6266) added to ''trunk'' branch (open: 1)
12-Nov-2010:: Maintainership handed over from [wiki:vnaum] to [wiki:hasienda] (open: 3 tickets)
[[html(
)]]
= CC selector plugin =
== Description ==
This plugin allows "visual" CC field editing.
A pop-up window with bunch of checkboxes is opened, user checks boxes,
email addresses are added to and removed from Cc ticket field.
[Comment for the original author: Pretty useless, if you ask me, but my PM team finds this useful.]
'''!JavaScript is required''' and working with Firefox, Mozilla and Internet Explorer 6.
Opera / Safari reports are welcome.
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 Trac DB. 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 [http://trac-hacks.org/changeset/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
[query:?status=new&status=assigned&status=reopened&group=&component=CcSelectorPlugin&order=priority here]. If you have any issues, create a
[/newticket?component=CcSelectorPlugin&owner=hasienda new ticket].
== Download and Source ==
Download the [download:ccselectorplugin zipped source], check out [http://trac-hacks.org/svn/ccselectorplugin using Subversion], or [source:ccselectorplugin browse the source] with Trac.
== Configuration ==
Following options have been added to `trunk` branch recently:
{{{
[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 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 [http://trac.edgewall.org/wiki/TracIni trac.ini] like:
{{{
[ticket]
restrict_owner = true
}}}
[http://trac.edgewall.org/wiki/TracTickets#Assign-toasDrop-DownList This]
page has more info on this.
== Example ==
A pop-up window with bunch of checkboxes is opened, user checks boxes,
email addresses are added and removed to CC field.
[[Image(cc_selector.png, border=1, align=center)]]
=== 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. look, if it's already available from the [TracPluginTranslation Trac plugin l10n project] at [http://www.transifex.net/projects/p/Trac_Plugin-L10N/c/cc_selector Transifex] or
2. do it yourself (see the [t:wiki:CookBook/PluginL10N#Dotranslatorswork l10n cookbook page for Trac plugins] for more details).
You've done a new translation? Superb! 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/c/cc_selector/ cc_selector][[BR]]
[[Image(http://www.transifex.net/projects/p/Trac_Plugin-L10N/c/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/c/cc_selector/)]]
Kindly provided by [[Image(http://sw.transifex.net/2/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:
{{{
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:''' [wiki:hasienda] [[BR]]
'''Contributors:''' terje