zulip/templates/zerver/integrations/trac.md

44 lines
1.3 KiB
Markdown
Raw Normal View History

1. {!create-stream.md!}
1. {!download-python-bindings.md!}
1. {!change-zulip-config-file-indented.md!}
1. Also, change the following lines:
```
STREAM_FOR_NOTIFICATIONS = "trac"
TRAC_BASE_TICKET_URL = "https://trac.example.com/ticket"
```
1. Set `STREAM_FOR_NOTIFICATIONS` to the name of the stream
you'd like the notifications to be sent to.
1. Copy `integrations/trac/zulip_trac.py` and
`integrations/trac/zulip_trac_config.py` into your Trac installations
`plugins/` subdirectory. Once youve done that, edit your Trac
installations `conf/trac.ini` to add `zulip_trac` to the
`[components]` section, as follows:
```
[components]
zulip_trac = enabled
```
1. You may then need to restart Trac (or Apache) so that Trac will load
our plugin.
1. When people open new tickets (or edit existing tickets), notifications
will be sent to the stream `trac` (or whatever you
configured above) with a topic that matches the ticket name.
{!congrats.md!}
![Trac bot message](/static/images/integrations/trac/001.png)
### Additional trac configuration
After using the plugin for a while, you may want to customize which
changes to tickets result in a Zulip notification using the
`TRAC_NOTIFY_FIELDS` setting in `zulip_trac_config.py`.