Changes between Version 77 and Version 78 of AnnouncerPlugin
- Timestamp:
- Jun 7, 2015, 10:18:26 AM (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
AnnouncerPlugin
v77 v78 1 1 [[PageOutline(2-5,Contents,pullout)]] 2 2 3 {{{ 4 #!NewsFlash 5 = News = 6 2012-11-04:: Major db code changes, '''requires a Trac environment upgrade''' `announcer-1.0dev` to address many pending issue. 7 2012-10-20:: Set the stage: On the way to `announcer-1.0` now, that should be compatible for Trac 0.11, but also will work up to current stable Trac 1.0. 8 3 {{{#!NewsFlash 9 4 = !ToDo = 10 5 * "downgrade db API code for compatibility with Trac 0.11 (currently only 0.12)" … … 22 17 === Improve '''users''' Trac experience 23 18 24 With growing number of both tickets and wiki pages, keeping yourself up-to-date on recent changes is a time consuming task and easy to miss someimportant information. The bigger your Trac application and user base, the more important is a flexible announcement system. At the very least, it will allow users to receive ''notices about attachments'', and to ''opt-out from receiving messages'' due to the always_notify_(owner|reporter|updater) options. AnnouncerPlugin has ''wiki subscription'' capabilities ^[1]^ and provides each registered user with a large set of options to adapt change notifications to individual demand.19 With growing number of both tickets and wiki pages, keeping yourself up-to-date on recent changes is a time consuming task and easy to miss important information. The bigger your Trac application and user base, the more important is a flexible announcement system. At the very least, it will allow users to receive ''notices about attachments'', and to ''opt-out from receiving messages'' due to the always_notify_(owner|reporter|updater) options. AnnouncerPlugin has ''wiki subscription'' capabilities ^[1]^ and provides each registered user with a large set of options to adapt change notifications to individual demand. 25 20 26 21 === Get room for promising '''development''' … … 50 45 * You can check out AnnouncerPlugin from [/svn/announcerplugin here] using Subversion, or [source:announcerplugin browse the source] with Trac. 51 46 52 '''Note:''' Don't use anything older than current `trunk`, or be prepared tolose some of your settings when upgrading. This might, but is not guaranteed to get addressed later on due to a number of rather experimental db schema versions (see comments in [12296] to [12302]).53 54 After installing AnnouncerPlugin, run `trac-admin /path/to/env upgrade`. This is needed because the plugin adds two tables to the Trac db. The upgrade script allows the plugin to create the needed table or update any older schema. Note th ough, that data conversion is still worked on and even might never get fully done for the more ancient revisions.47 '''Note:''' Don't use anything older than `trunk`, or you may lose some of your settings when upgrading. This might, but is not guaranteed to get addressed later on due to a number of rather experimental db schema versions (see comments in [12296] to [12302]). 48 49 After installing AnnouncerPlugin, run `trac-admin /path/to/env upgrade`. This is needed because the plugin adds two tables to the Trac db. The upgrade script allows the plugin to create the needed table or update any older schema. Note that data conversion is still worked on and even might never get fully done for the more ancient revisions. 55 50 56 51 As of r3107 (dubbed v0.2), the AnnouncerPlugin has been working in a basic way in our corporate Trac installation. This includes all the mentioned modules above, in particular the notification of Wiki additions/changes/deletions to anyone interested, 'watching' interesting resources, HTML ticket notifications, and such. … … 62 57 The easiest way to install AnnouncerPlugin is to use easy_install from the t-h.o SVN repository: 63 58 64 {{{ 65 #!python 59 {{{#!python 66 60 easy_install http://trac-hacks.org/svn/announcerplugin/trunk 67 61 }}} … … 69 63 Alternatively, you may download the source via one of the above methods, go into the `trunk` directory and then run: 70 64 71 {{{ 72 #!python 65 {{{#!python 73 66 python setup.py install 74 67 }}} … … 84 77 ==== Fast path 85 78 86 For a system that is basically compatible with your existing setup and allowing minimally invasive wiki features, the following is suggested in `trac.ini`: 87 88 {{{ 89 #!ini 79 For a system that is basically compatible with your existing setup and allowing minimally invasive wiki features, the following is suggested for `trac.ini`: 80 81 {{{#!ini 90 82 [components] 91 83 announcer.* = enabled … … 99 91 ==== Save on migration 100 92 101 If you configured the [t:wiki:TracNotification TracNotification] system before, another approach to Announcer configuration is to simply rename the `[notification]` section in your ''trac.ini'' to `[announcer]`. 93 If you configured the [t:wiki:TracNotification TracNotification] system before, another approach to Announcer configuration is to simply rename the `[notification]` section in your ''trac.ini'' to `[announcer]`. Where possible, the option names are the same. Additional options that may be available are specified above in the modules section. 102 94 103 95 ==== Deep waters … … 126 118 * '''!SessionEmailResolver''' (recommended, will use the session's email address (authenticated or otherwise) to send mail) 127 119 * '''!DefaultDomainEmailResolver''' (recommended if you used the smtp_default_domain option previously) 128 * '''!SpecifiedEmailResolver''' (not recommended -- a proof of concept if nothing else)129 130 To better collaborate with the [WatchlistPlugin#AnnouncerPlugin WatchlistPlugin] the two contextual navigation items ''Watch This''/''Unwatch This'' on the wiki page can be renamed by specifying the following in the `[announcer]` section . An empty value removes them completely.131 {{{ 132 #!ini 120 * '''!SpecifiedEmailResolver''' (not recommended, because it is a proof of concept) 121 122 To better collaborate with the [WatchlistPlugin#AnnouncerPlugin WatchlistPlugin] the two contextual navigation items ''Watch This''/''Unwatch This'' on the wiki page can be renamed by specifying the following in the `[announcer]` section of your `trac.ini` file. An empty value removes them completely. 123 {{{#!ini 124 [announcer] 133 125 ctxtnav_names = Notify me, Do not notify me 134 126 }}} … … 136 128 === Modular per-user configuration 137 129 138 The plugin itself is very modular, and exactly what features you have will depend on which modules you enable. You select modules in the 'Plugins' page of the 'Admin' section of your trac as stated the [#Centralconfiguration previous section].130 The plugin itself is very modular, and exactly what features you have will depend on which modules you enable. You select modules in the 'Plugins' page of the 'Admin' section of your Trac as stated the [#Centralconfiguration previous section]. 139 131 140 132 ==== Legacy Modules 141 133 142 These mimic the standard trac notification that has been in Trac for awhile. In all cases, they are configured via the [announcer] section of the trac.ini. In most cases, the options are identical to what was previously in the [notification] section. In fact its recommended that you simplyrename [notification] to [announcer] if you are going to be using any of these compatibility modules.134 These mimic the standard Trac notification that has been in Trac for a while. In all cases, they are configured via the [announcer] section of the trac.ini. In most cases, the options are identical to what was previously in the [notification] section. In fact it is recommended that you rename [notification] to [announcer] if you are going to be using any of these compatibility modules. 143 135 144 136 * ''!StaticTicketSubscriber'': If enabled, this module will obey the ''smtp_always_bcc'' option to deliver a copy of every announcement sent out to a single address. … … 156 148 This feature is provided by ''!JoinableGroupSubscriber'', and is meant to create targeted groups of people that should be notified about certain important issues. One example might be 'security' that security-related bugs should notify everyone about. Another might be 'sitedown' that represents a critical failure at a customer's site where you want to be sure to notify certain high level management in your company. 157 149 158 In any case, by prepending the group with an @ and adding it into the CC box, everyone who has opted into that group will receive notification of changes to that ticket. E.g., adding '@security' to the CC field will send the security team a message whenever someone alters it. The !CarbonCopySubscriber ignores any such entries (if its enabled at all) 159 160 Configure like so: 161 {{{ 162 #!ini 150 In any case, by prepending the group with `@` and adding it into the CC box, everyone who has opted into that group will receive notification of changes to that ticket. For example adding '@security' to the CC field will send the security team a message whenever someone alters it. The !CarbonCopySubscriber ignores any such entries, if it is enabled at all. 151 152 Configure as follows in your `trac.ini` file: 153 {{{#!ini 163 154 [announcer] 164 155 joinable_groups = group1,group2,group3 … … 179 170 In particular, you may use a pattern of '*' and you'll see any wiki changes that happen on the site. 180 171 181 This is particularly useful in situations where the wiki uses a hierarch al structure; so if you use a pattern such as 'Project*', then 'Project/Plan' and 'Project/Concerns' will all match.172 This is particularly useful in situations where the wiki uses a hierarchical structure; so if you use a pattern such as 'Project*', then 'Project/Plan' and 'Project/Concerns' will all match. 182 173 183 174 [[Image(AnnouncerPlugin:GeneralWiki.png)]] … … 200 191 ==== Distributors 201 192 202 Although the goal is to allow many kinds of distribution, at this point we're only delivering to email addresses. The ''!EmailDistributor'' uses the same options as the old trac notification, just (as above) in the ''announcer'' section and not the ''notification'' section. Some options it doesn't quite use yet but will in the future.193 Although the goal is to allow many kinds of distribution, at this point we're only delivering to email addresses. The ''!EmailDistributor'' uses the same options as the old trac notification, just (as above) in the ''announcer'' section and not the ''notification'' section. 203 194 204 195 There are a few additional ones: … … 217 208 The order is important. If you specify resolvers as follows: 218 209 219 {{{ 220 #!ini 210 {{{#!ini 221 211 [announcer] 222 212 email_address_resolvers = DefaultDomainEmailResolver, SpecifiedEmailResolver, SessionEmailResolver … … 227 217 The recommended setting is: 228 218 229 {{{ 219 {{{#!ini 230 220 [announcer] 231 221 email_address_resolvers = SpecifiedEmailResolver, SessionEmailResolver … … 243 233 Existing bugs and feature requests for WantedPagesMacro are [report:9?COMPONENT=AnnouncerPlugin here]. 244 234 245 If you have any issues, create a [ http://trac-hacks.org/newticket?component=AnnouncerPlugin&owner=hasiendanew ticket].235 If you have any issues, create a [/newticket?component=AnnouncerPlugin new ticket]. 246 236 247 237 [[TicketQuery(component=AnnouncerPlugin&group=type,format=progress)]] … … 249 239 == Development Version 250 240 251 The trunk branch is under development again. Despite AnnouncerPlugin was already developed against Trac 0.12 and Python2.6 before, we're reaching back to Trac 0.11 and Python2.4 again (see #9106), before branching out and following Trac 1.0 for all new features.252 253 If you upgrade from early versions of AnnouncerPlugin, be prepared for a number of changes, even in the name space '''AnnouncerPlugin becomes TracAnnouncer'''. You will need to edit your `trac.ini` components section accordingly (announcerplugin -> announcer). There are many other module changes, so it's probably best to use the Trac plugin admin to configure TracAnnouncer after an upgrade.241 The development branch is called `trunk`. Despite AnnouncerPlugin was already developed against Trac 0.12 and Python2.6 before, we're reaching back to Trac 0.11 and Python2.4 again (see #9106), before branching out and following Trac 1.0 for all new features. 242 243 If you upgrade from early versions of AnnouncerPlugin, be prepared for a number of changes, even in the name space '''AnnouncerPlugin becomes TracAnnouncer'''. You will need to edit your `trac.ini` components section accordingly: announcerplugin -> announcer. There are many other module changes, so it's probably best to use the Trac plugin admin to configure TracAnnouncer after an upgrade. 254 244 255 245 As stated before, as of [8087] there is preliminary support for sending encrypted and/or cryptographically signed emails. OpenPGP support provided by [http://www.gnupg.org/ GnuPG] should be barely working by now as an intermediate solutions, but this will be rebased on CryptoPlugin methods later on. See more details at the corresponding [wiki:AnnouncerPlugin/MessageEncryption development page]. 256 246 257 Email delivery configuration has been changed significantly. Sendmail functionality has been added. SMTP configuration has been split out into it's own section. Save yourself some trouble and install !IniAdmin.See new settings with default [#EmailConfig below].258 259 Want to get started hacking TracAnnouncer? Here's what I would do.Replace vim with the editor of your choice. Replace git with the SCM of your choice.247 Email delivery configuration has been changed significantly. Sendmail functionality has been added. SMTP configuration has been split out into its own section. Save yourself some trouble and install !IniAdmin. See new settings with default [#EmailConfig below]. 248 249 Want to get started hacking TracAnnouncer? Replace vim with the editor of your choice. Replace git with the SCM of your choice. 260 250 261 251 1. Make sure you have virtualenv installed. 262 252 1. Get the code: 263 {{{ 264 #!sh 253 {{{#!sh 265 254 ~ $ cd src 266 255 ~/src $ git svn init http://trac-hacks.org/svn th-announcer … … 296 285 (th-announcer)~/src/th-announcer $ python setup.py develop 297 286 }}} 298 1. It is also very helpful to install iniadmin`pip install -U http://trac-hacks.org/svn/iniadminplugin/0.11`.299 1. Create a trac instance for testing`trac-admin ~/th-announcer/trac initenv`.300 1. Add `root` as a TRAC_ADMIN `trac-admin ~/th-announcer/trac/ permission add root TRAC_ADMIN`.287 1. It is also useful to install iniadmin: `pip install -U http://trac-hacks.org/svn/iniadminplugin/0.11`. 288 1. Create a Trac instance for testing: `trac-admin ~/th-announcer/trac initenv`. 289 1. Add `root` as a TRAC_ADMIN: `trac-admin ~/th-announcer/trac/ permission add root TRAC_ADMIN`. 301 290 1. Create an htpasswd file so you can log in: `echo root:Xy2PtsPf0839Y > ~/th-announcer/trac/htpasswd` (that's 'password'). 302 1. Fire her up!`cd ~/th-announcer/trac && tracd -p 7421 . -sr --basic-auth *,${HOME}/th-announcer/trac/htpasswd,*`.303 1. Browse to it .`chromium http://localhost:7421/admin` and login as root:password.291 1. Start the plugin: `cd ~/th-announcer/trac && tracd -p 7421 . -sr --basic-auth *,${HOME}/th-announcer/trac/htpasswd,*`. 292 1. Browse to it: `chromium http://localhost:7421/admin` and login as root:password. 304 293 1. Enable all the announcer and iniadmin stuff. 305 294 1. Edit your config with iniadmin. … … 309 298 The development version of this plugin is prepared for localization. After recent major changes an additional name-space has been introduced to separate maintenance efforts from development for upcoming versions. Be part of the shift, prefer contributions to the new stuff.[[BR]] 310 299 But English message texts are still the (POSIX) default. If this isn't your preferred language, you can 311 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/tracannouncer Transifex] (catalogs for [http://www.transifex.net/projects/p/Trac_Plugin-L10N/c/announcer older versions] available as well)or300 1. check if it is already available from the [TracPluginTranslation Trac plugin l10n project] at [http://www.transifex.net/projects/p/Trac_Plugin-L10N/c/tracannouncer Transifex] (catalogs for [http://www.transifex.net/projects/p/Trac_Plugin-L10N/c/announcer older versions] available as well) or 312 301 2. do it yourself (see the [http://trac.edgewall.org/wiki/CookBook/PluginL10N#Dotranslatorswork l10n cookbook page for Trac plugins] for more details). 313 302 … … 319 308 320 309 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: 321 {{{ 322 #!sh 310 {{{#!sh 323 311 cd announcer 324 312 python ./setup.py egg_info … … 333 321 Add the following to your `trac.ini` file: 334 322 335 {{{ 336 #!ini 323 {{{#!ini 337 324 [announcer] 338 325 default_email_format = text/plain