XP-Dev.com Documentation

Trac Hosting

Instead of using XP-Dev.com's own bug tracker, you can use Trac to host your project, tickets and wiki pages.

Create a Trac Project

  • Head to your Projects tab
  • Click on Create a new project
  • Enter a name, an abbreviated name and ensure that Trac is selected as the issue tracker type
    • The abbreviated name that you have chosen will be used in the trac URL. For e.g. if you picked the abbreviated name mytracproject, your Trac project will be installed at https://xp-dev.com/trac/mytracproject
  • Click on Create Project

Trac projects can take a few minutes to be created and configured. The warning (shown below) will disappear after a few minutes and your Trac project will be fully installed.

Repositories with Trac

Just configure a repository like how you would do for any XP-Dev.com project under the Repository tab.

Trac Permissions

Adding and removing users from your Trac project is done using the usual way for any XP-Dev.com project.

Full instructions on how to add/remove users can be found here

Incoming Email Integration

Have a look at our help document that describes how to setup incoming email integration for Trac

Smart Commit Messages for Trac

Once you have configured a repository on your project, you will be able to use smart commit messages to reference your commits with Trac tickets, and even close/fix them.

The smart commit messages is a standard feature with Trac that has been enabled on all Trac projects hosted on XP-Dev.com.

The following text was taken directly from the comments on trac-post-commit-hook

 It searches commit messages for text in the form of:
 command #1
 command #1, #2
 command #1 & #2 
 command #1 and #2

Instead of the short-hand syntax "#1", "ticket:1" can be used as well,
 command ticket:1
 command ticket:1, ticket:2
 command ticket:1 & ticket:2 
 command ticket:1 and ticket:2

In addition, the ‘:' character can be omitted and issue or bug can be
 instead of ticket.

You can have more then one command in a message. The following commands
 are supported. There is more then one spelling for each command, to
 this as user-friendly as possible.

close, closed, closes, fix, fixed, fixes
 The specified issue numbers are closed with the contents of this
 commit message being added to it. 
 references, refs, addresses, re, see 
 The specified issue numbers are left in their current status, but 
 the contents of this commit message are added to their notes.

A fairly complicated example of what you can do is with a commit message of:

Changed blah and foo to do this or that. Fixes #10 and #12, and refs #12.

This will close #10 and #12, and add a note to #12.

Trac Plugins

A full list of plugins installed can be found on our features page

Further Documentation

Feel free to contact us if you need any assistance.