This guide will explain how to extend Open Atrium Work Tracker.

Architecture of Work Tracker

Because every organization has different needs when it comes to tracking work, making it possible to easily extend Work Tracker was a very high priority in it's design!

Work Tracker is a Feature implemented using standard components like Fields, Views, Panels, and Comment Alter, with as little custom code as possible.

This means you can easily extend it, almost entirely in the user interface, and export those changes using Features Override into your own extension module.

IMPORTANT NOTE: If you don't put your changes into an extension module, you risk losing your customizations when new versions of Work Tracker come out!

Tutorial: Add a "Due date" field to Tasks

One of the most common extensions is adding a new field to Tasks, that you want to be updated via posting a comment and displayed in the "Task List".

This guide will help you to configure Open Atrium Work Tracker.

What is configurable?

Since Work Tracker is a Feature implemented using standard components like Fields, Views, Panels, and Comment Alter, you can extend it to do pretty much anything. :-)

However, there is special support for easily configuring the things that users will most commonly want to change for your organization, namely the values for the Type, Priority and Status field.

Global configuration

To change configuration for the whole site, go to /admin/openatrium/worktracker on your site or open the "Admin" menu and go to "Open Atrium" -> "Work Tracker".

Then you can configure the field values for Type, Priority and Status for any Space that hasn't customized them.

Per-Space configuration

This guide will help you get started with Open Atrium Work Tracker.

1. Install OpenAtrium 2.0

Open Atrium 2.0-rc1 and later install Work Tracker by default!

See the Open Atrium 2.0 Installation Guide for more information about how to install.

2. Create a new Space

Click the dropdown next to "Spaces" and select "Create new Space".

Fill in all the required fields and then click the "Publish" button.

3. Create a new "Tasks Section"

Click the dropdown next to your new space name, and select "Create a new Section".

Fill in all the required fields and under "Section Type" (it's below the body and "Weight" fields) chose "Tasks Type".

4. Add your first Task!

Work Tracker is a tracker for Open Atrium 2.0 (similar to the Case tracker in Open Atrium 1.0) which allows you to create Tasks in order to collaborate on work.