2021-03-15 23:44:57 +01:00
|
|
|
|
1. {!create-stream.md!}
|
2017-06-05 19:45:52 +02:00
|
|
|
|
|
2021-03-15 23:44:57 +01:00
|
|
|
|
1. {!download-python-bindings.md!}
|
2017-06-05 19:45:52 +02:00
|
|
|
|
|
2021-03-15 23:44:57 +01:00
|
|
|
|
1. {!change-zulip-config-file-indented.md!}
|
2017-06-22 05:31:39 +02:00
|
|
|
|
|
2021-03-15 23:44:57 +01:00
|
|
|
|
1. Also, change the following lines:
|
2017-06-05 19:45:52 +02:00
|
|
|
|
|
2021-03-15 23:44:57 +01:00
|
|
|
|
```
|
|
|
|
|
STREAM_FOR_NOTIFICATIONS = "trac"
|
|
|
|
|
TRAC_BASE_TICKET_URL = "https://trac.example.com/ticket"
|
|
|
|
|
```
|
2017-06-05 19:45:52 +02:00
|
|
|
|
|
2021-03-15 23:44:57 +01:00
|
|
|
|
1. Set `STREAM_FOR_NOTIFICATIONS` to the name of the stream
|
|
|
|
|
you'd like the notifications to be sent to.
|
2017-06-22 05:31:39 +02:00
|
|
|
|
|
2021-03-15 23:44:57 +01:00
|
|
|
|
1. Copy `integrations/trac/zulip_trac.py` and
|
|
|
|
|
`integrations/trac/zulip_trac_config.py` into your Trac installation’s
|
|
|
|
|
`plugins/` subdirectory. Once you’ve done that, edit your Trac
|
|
|
|
|
installation’s `conf/trac.ini` to add `zulip_trac` to the
|
|
|
|
|
`[components]` section, as follows:
|
2017-06-05 19:45:52 +02:00
|
|
|
|
|
2021-03-15 23:44:57 +01:00
|
|
|
|
```
|
|
|
|
|
[components]
|
|
|
|
|
zulip_trac = enabled
|
|
|
|
|
```
|
2017-06-05 19:45:52 +02:00
|
|
|
|
|
2021-03-15 23:44:57 +01:00
|
|
|
|
1. You may then need to restart Trac (or Apache) so that Trac will load
|
|
|
|
|
our plugin.
|
2017-06-05 19:45:52 +02:00
|
|
|
|
|
2021-03-15 23:44:57 +01:00
|
|
|
|
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.
|
2017-06-05 19:45:52 +02:00
|
|
|
|
|
2017-06-22 05:31:39 +02:00
|
|
|
|
{!congrats.md!}
|
2017-06-05 19:45:52 +02:00
|
|
|
|
|
2020-08-05 11:50:17 +02:00
|
|
|
|
![Trac bot message](/static/images/integrations/trac/001.png)
|
2017-06-05 19:45:52 +02:00
|
|
|
|
|
2021-03-15 23:44:57 +01:00
|
|
|
|
### Additional trac configuration
|
2017-06-05 19:45:52 +02:00
|
|
|
|
|
|
|
|
|
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`.
|