Help Center

Every little secret about Usersnap

Connecting Usersnap with Trac

Usersnap and Trac (installed on premise) can be connected easily.

To use Usersnap’s Trac integration, you need to enable the xmlrpc-plugin for trac. Download it from XML RPC-Plugin, copy the egg inside your plugins-directory or install it system wide. You need to enable it by adding tracrpc.* = enabled to your [components]-section of trac.ini.

Next step is to create a user account for delivering the screenshots to your Trac instance.

You can pick an arbitrary username, but it's important that the user has the following permissions:XML_RPC, TICKET_CREATE, TICKET_MODIFY, TICKET_VIEW:

trac usersnap

If you are using HtDigest-based auth together with trac (skip this if you are using Apache Auth or Trac Basic Auth), you need to switch to Basic Auth, because XML-RPC does not work very well together with HtDigest-Auth. You should use SSL anyways, so there is no change of your security level if you switch to Basic Auth.

After creating the Trac user, you can connect Usersnap to your Trac instance. Enter the username of the previously created user and the password on the connection dialog:

trac usersnap

After a successful connection, you can set up the properties how your tickets should be created, including Component, Issue Type, Priority, Version, Severity, Milestone CC and Owner. You can leave any of the fields empty and Trac will fill in your instance's default value.

It's always a good idea to create a special Component or Issue Type for Usersnap reports. That way it's super easy to create ticket reports containing only Usersnap reports within Trac.

trac usersnap

Finally you will receive Usersnap screenshots delivered directly into your Trac instance.

trac usersnap

The screenshot is automatically attached to the ticket and displayed inline.

Let's connect and get in touch!