zulip/templates/zerver/integrations/trac.md

44 lines
1.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

1. {!create-stream.md!}
1. {!download-python-bindings.md!}
1. {!change-zulip-config-file.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`.