[[PageOutline(2-5,Contents,pullout)]]

= Team availability calendar

== Description

This plugin adds a new navigation tab, "Team calendar", that can be used to keep track of team availability in a project. The data is stored in the Trac database, which means it can be used in reports and queries.

See also: GoogleCalendarPlugin, GanttCalendarPlugin

== Bugs/Feature Requests

Existing bugs and feature requests for TeamCalendarPlugin are 
[report:9?COMPONENT=TeamCalendarPlugin here].

If you have any issues, create a 
[/newticket?component=TeamCalendarPlugin new ticket].

[[TicketQuery(component=TeamCalendarPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:teamcalendarplugin here].

== Source

You can check out TeamCalendarPlugin from [/svn/teamcalendarplugin here] using Subversion, or [source:teamcalendarplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Technical notes

This plugin adds a new tab '''Team Calendar''' to users with the `TEAMCALENDAR_VIEW` permission. This shows a table with dates running down the rows and team members across the columns. Users with `TEAMCALENDAR_UPDATE_OWN` permissions can change the state of the tick boxes under their own name, and save the results. Users with `TEAMCALENDAR_UPDATE_OTHERS` permission can update everyone else's.

The table is populated form the `team_availability` table in the database.

The 'availability' column will contain 0 or 1 if populated through the GUI.
It is left as a float to make it possible to store more granular availability, eg half-day, but there is no business logic for this at present.

The calendar does not do anything else by itself. However, the `team_availability` table can be used in reports.

== Recent Changes

[[ChangeLog(teamcalendarplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:optilude] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''