NAME
    RT::Extension::SummaryByUser - portlets to show ticket counters per user

DESCRIPTION
    This extension ships with OwnerSummary and RequestorSummary portlets you
    can use in a dashboard and/or RT at glance. Summary can be displayed not
    only by user, but by users' organization or other fields. For example
    RequestorSummary portlet displays summary by requestors' organization.
    Read more about this below in "CONFIGURATION" section.

VERSION
    This module works on RT 4.0. It is not currently compatible with RT 4.2.

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

    Edit your /opt/rt4/etc/RT_SiteConfig.pm
        If you are using RT 4.2 or greater, add this line:

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

        For RT 4.0, add this line:

            Set(@Plugins, qw(RT::Extension::SummaryByUser));

        or add RT::Extension::SummaryByUser to your existing @Plugins line.

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

    Restart your webserver

CONFIGURATION
    To make a OwnerSummary or RequestorSummary available in the Web UI you
    must register it in the RT config using $HomepageComponents option. Once
    a portlet is registered in $HomepageComponents it can be added to your
    homepage using the Edit link on RT at a Glance, or added to a Dashboard.

    More portlets can be created using this extension. Look into the
    RequestorSummary file, it just calls OwnerSummary with arguments:

        <%INIT>
        return $m->comp( 'OwnerSummary', Role => 'Requestor', Field => 'Organization' );
        </%INIT>

    As you can see there is two arguments: 'Role' and 'Field'. Role can be
    'Owner', 'Creator', 'Requestor', 'Cc' and 'AdminCc'. Field can be any
    column from Users table or empty. The following fields make sence:
    'Organization', 'Country', 'State' or 'City'. Empty value means that the
    report is groupped by particular users.

    You can copy this file into local/html/Elements directory with different
    name, for example with RequestorCountrySummary, change arguments,
    register the new portlet in $HomepageComponents, restart server and use
    new portlet.

AUTHOR
    Best Practical Solutions, LLC <modules@bestpractical.com>

BUGS
    All bugs should be reported via email to

        L<bug-RT-Extension-SummaryByUser@rt.cpan.org|mailto:bug-RT-Extension-SummaryByUser@rt.cpan.org>

    or via the web at

        L<rt.cpan.org|http://rt.cpan.org/Public/Dist/Display.html?Name=RT-Extension-SummaryByUser>.

LICENSE AND COPYRIGHT
    This software is Copyright (c) 2014 by Best Practical Solutions

    This is free software, licensed under:

      The GNU General Public License, Version 2, June 1991