zulip/templates/zerver/integrations/trac.md

1. {!create-stream.md!}

2. {!download-python-bindings.md!}

3. {!change-zulip-config-file.md!}

4. Also, change the following lines:

   STREAM_FOR_NOTIFICATIONS = "trac"
   TRAC_BASE_TICKET_URL = "https://trac.example.com/ticket"
   

5. Set STREAM_FOR_NOTIFICATIONS to the name of the stream you'd like the notifications to be sent to.

6. 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:

   [components]
   zulip_trac = enabled
   

7. You may then need to restart Trac (or Apache) so that Trac will load our plugin.

8. 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!}

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.