WTF::Pages::Input - Page generation and action methods for the time and notes input screens

VERSION

This document describes WTF::Pages::Input version 1.02

SYNOPSIS

        use WTF::Pages::Input;
        return WTF::Pages::Input->screen_name($r);

DESCRIPTION

This module is a subclass of WTF::Page that houses page generation and action methods for the time and notes input screens.

METHODS

All methods are broken into two types: screen method and action methods. Both screen and action methods require one input, an Apache request (Apache2::RequestRec) object. Screen methods return XHTML, typically as a result of running the ``output()'' method of an HTML::Template object. Action methods set a new URL location and return an Apache redirect. Other input into either type of method is through an Apache2::Request object:

        my $req = WTF::Utils::get_req($r);

screen_input()

This is a page generation method that generates the main home page using the ``input.tmpl'' HTML::Template template. The page that gets rendered contains a basic page with a navigation bar and three IFRAMEs that link into projects, tasks, and tracking sub-pages.

screen_projects()

This is a page generation method that generates the ``Open Projects'' sub-page using the ``input/projects.tmpl'' HTML::Template template. This page lists out every active project (as defined by Bugzilla tracking bugs) in an interactive table, allowing the user to select a project in which to log time.

screen_tasks()

This is a page generation method that generates the ``Project Tasks'' and ``Non-Project Tasks'' sub-page using the ``input/tasks.tmpl'' HTML::Template template. This page lists out every active task in an interactive table, allowing the user to select a task in which to log time.

screen_tracking()

This is a page generation method that generates the ``Daily Timesheet'' sub-page using the ``input/tracking.tmpl'' HTML::Template template. This page allows users to see what time they have tracked to projects and tasks for a given day. It also allows the user to make changes and submit. The vast majority of functionality on this page is handled by Javascript.

action_save_timesheet()

This action method saves changes to daily time and notes data submitted by users from the ``Daily Timesheet'' page under ``screen_tracking()''.

DEPENDENCIES

WTF::Pages::Input depends on the following modules:

WTF::Pages::Input is a subclass of WTF::Pages.

COPYRIGHT, LICENSE, AND DISCLAIMER OF WARRANTY

Use of this module implies the reading and agreement with the license under which this software is release. That license can be found in the ``license.txt'' file included with this distribution.