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
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