NAME
    RT::Extension::ReportSpam - mark tickets as spam with one click

RT VERSION
    Works with RT 4.4 and 5.0

DESCRIPTION
    A simple extension that allows users to report a ticket as a spam
    message.

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

    Edit your /opt/rt5/etc/RT_SiteConfig.pm
            Plugin('RT::Extension::ReportSpam');

        You may also want to set the $SpamAutoDeleteThreshold config option
        to the number of spam reports required before the system will
        automatically delete the ticket. This is useful if none of your
        users have DeleteTicket themselves, but collectively they should be
        able to delete spam tickets for good. Auto-delete is disabled by
        leaving $SpamAutoDeleteThreshold unset or setting it to 0.

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

    Restart your webserver

HOW TO …
  Report Spam
    On any ticket page, you can report the ticket as spam by clicking "S".

    You can also click the "S" on the Tools → Spam → Recent page, which
    lists all the recently created tickets with status "new" and without
    owner.

    If you have rights to delete tickets you mark as spam, then they will be
    deleted automatically at the same time.

  Query All Tickets Reported as Spam
    To find all tickets reported as spam and not deleted you can navigate to
    Tools → Spam → Reported, or use the query builder in advanced mode with
    the following query:

        HasAttribute = 'SpamReports'

    Both of these methods list the tickets reported as spam by others
    without rights to delete tickets themselves.

  Confirm a Ticket as Spam
    You can confirm the reports by clicking "S" after querying all tickets
    reported as spam. If you have rights to delete tickets then they will be
    deleted.

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

BUGS
    All bugs should be reported via email to

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

    or via the web at

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

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

    This is free software, licensed under:

      The GNU General Public License, Version 2, June 1991