wiki:TeamCalendarPlugin

Version 8 (modified by anonymous, 4 years ago) (diff)

--

Team 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 database, which means it can be used in reports and queries.

See also: GoogleCalendarPlugin, GanttCalendarPlugin, CalendarPlugin

Bugs/Feature Requests

Existing bugs and feature requests for TeamCalendarPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from here.

Source

You can check out TeamCalendarPlugin from here using Subversion, or browse the source with Trac.

Prerequisites

Note that the plugin is currently tied to MySQL. Updates to make it more database agnostic would be welcome. See #4243 - MySQL Testers needed''

Installation

Install as usual.

Create table in database: (this is MySQL, sqlite version appreciated)

CREATE TABLE `team_availability` (
  `username` varchar(255) NOT NULL DEFAULT '',
  `ondate` date NOT NULL DEFAULT '0000-00-00',
  `availability` float unsigned DEFAULT NULL,
  PRIMARY KEY (`username`,`ondate`)
);

For PostgreSQL 8.3, we created the table with:

CREATE TABLE team_availability (
   username varchar(255) NOT NULL DEFAULT '',
   ondate date NOT NULL,
   availability float DEFAULT NULL,
   PRIMARY KEY (username,ondate)
);

For sqlite3:

create table team_availability (
   username varchar(255) not null default '', 
   ondate date not null default (datetime('now')), 
   availability float default null, 
   primary key (username,ondate)
);

Under the hood

This plugin adds a new tab, Team Calendar, to users with the TEAMCALENDAR_VIEW permission. This shows a simple tables 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'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, e.g. half-day, but there is no UI for this at present.

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

Recent Changes

[14017] by rjollos on 2014-07-23 21:33:05
Removed empty directories that were not removed when moving files using Git.
[14015] by rjollos on 2014-07-23 21:28:21
Removed unneeded intermediate directory.
[14014] by rjollos on 2014-07-23 21:28:04
Added license headers and text. Tidied up indentation. Refs #11871.

Author/Contributors

Author: optilude
Maintainer: optilude
Contributors: