The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
RT-Extension-SummaryByUser-1.01
River stage zero No dependents
1 ++
/ RT::Extension::SummaryByUser

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

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