NAME
    RT::Extension::AwayMode - Automatically hand off tickets while an owner
    is away

DESCRIPTION
    This extension lets any user flag themselves as "away" (on holiday, out
    of office, ...) on their own Preferences page, optionally scoped to a
    start and/or end date. While a user's away flag is active, any new reply
    (Correspond transaction) on a ticket they own causes the ticket to be
    reassigned to Nobody, with an internal comment explaining why. Because
    unowned tickets are visible to the whole queue/team, this ensures
    tickets aren't silently stuck waiting on someone who is on holiday.

    While their away flag is active, the user also sees a prominent warning
    banner on every page of RT, reminding them (and anyone looking over
    their shoulder) that Away Mode is on.

RT VERSION
    Works with RT 6.0.3.

INSTALLATION
    "perl Makefile.PL"
    "make"
    "make install"
        May need root permissions.

    "make initdb"
        Only run this the first time you install this module.

        If you run this twice, you may end up with duplicate scrips.

    Edit your /opt/rt6/etc/RT_SiteConfig.pm
        Add this line:

            Plugin('RT::Extension::AwayMode');

    Clear your mason cache
            rm -rf /opt/rt6/var/mason_data/obj

    Restart your webserver

CONFIGURATION
    Users manage their own away status from Settings -> Away Mode
    (/Prefs/AwayMode.html): a checkbox to enable away mode, and optional
    start/end dates. With no dates set, away mode applies for as long as the
    checkbox stays on. With dates set, away mode is only active while today
    falls within the (inclusive) start/end range.

METHODS
  IsAwayForPrefs
    Pure logic, independent of RT, so it can be unit tested without an RT
    installation. Takes the stored AwayMode preference hashref (as produced
    by the /Prefs/AwayMode.html page: "{ Enabled => 0|1, StartDate =>
    'YYYY-MM-DD'|'', EndDate => 'YYYY-MM-DD'|'' }") and an optional "today"
    in "YYYY-MM-DD" form (defaults to the current local date). Returns true
    if away mode is currently active for those preferences.

    Both "StartDate" and "EndDate" are optional and, when present, are
    inclusive bounds.

  IsUserAway
    Takes an "RT::User" object, loads its "AwayMode" preference, and returns
    whether away mode is currently active for that user. Thin wrapper around
    "IsAwayForPrefs".

AUTHOR
    Christian Mehlmauer

LICENSE AND COPYRIGHT
    This is free software, licensed under version 3 of the GNU General
    Public License.