Abuse Manager Pro (WHMCS Module)
This article is being updated for the latest release v3.x
Abuse Manager Pro (AMP) is a WHMCS addon module that helps admins with the daily chores linked to abuse reports, and turns their lives into a walk in the park!
Although many people use support tickets, that method requires a lot of work and many different strategies to help define an inefficient process for admins - that method can never be relied on. With AMP, everything is within the module, and there is no need to use multiple pages, external applications, or even other 3rd party solutions.
The system allows you to receive abuse reports from 3rd parties, either by emails (using a fetching technique by PHP_IMAP - great for automatically processing your [email protected] address for example) or by enabling a public facing abuse reporting page. As well as that, you can create abuse reports of your own.
When an abuse report is submitted by 3rd parties (public facing page or via the email address that is to be fetched), it goes into a queue and awaits your moderation. This allows you to vet the abuse report, and when you are satisfied, you can assign it to a customer. Queued abuse reports also try to help you by showing you which customer and service the abuse report could be linked to.
Admins can have conversations with clients, and vice versa - all in favour of reaching a solution and ultimately closing/resolving the abuse report.
Admins have the ability of not suspending the service that relates to the abuse report, or suspend it immediately, or suspend it after a certain time limit passes. They also have the option to allow a customer to unsuspend themselves if required.
To understand the module better, please have a look at the screenshots, as well as the different feature sets for admins, registered users, and public guests below.
Proud to say that Ajax is supported, and no template modifications are required at all!
Screen Shots
Admin Features
Abuse Dashboard that shows you quick statistics and important information
Admin Widget on WHMCS admin home page which shows abuse reports that require your attention
Filter records using a filter on top of open, closed, queued abuse reports pages to quickly find what you are looking for
Quick links to client's details and service from within reports and from open, closed, and queued report pages
Ability to create a new abuse report using ajax to quickly select a customer, their product, and IP address
Ability for the admin to set a custom IP address or use one of the IPs assigned to the service when creating a report
Ability to set the service in question to either not suspend, suspend immediately, or suspend after a time limit
Ability to allow the client to unsuspend their service on their own
Ability to view, edit, close, reopen, and delete - open and closed abuse reports
Ability to view, and download attachments from open, closed and queued abuse reports
Ability to assign to client, and delete - queued abuse reports (from 3rd parties from Public Page & Mail Fetch)
Ability to see suggestions on which customer and service the queued abuse report might belong to
Ability to use the new magic import “use these values” button to use the suggested customer details & service the queued abuse report might belong to
Ability to see details of abuse report from within an abuse report
Ability to start a conversation with the client from within open abuse reports
Ability to see a read-only abuse report, when an abuse report is closed
Ability to see the imported email body with attachments or abuse report from 3rd parties from within queued abuse reports
Ability to lock down client area if a customer has any open abuse reports
Ability to set a maximum amount of open abuse reports before a customer is flagged on admin side
Ability to specify amount of time before a service is automatically suspended (only if report is set to suspend a service after a time limit)
Ability to lift the automatic suspension, before the service is suspended from within an open abuse report
Ability to create as many different abuse categories as you see fit
Ability to rename links in WHMCS navbar
Ability to reroute/disable/modify admin notifications (new WHMCS notifications system)
Admin notifications on 3rd party queued abuse reports
Multiple staff can work on the same abuse report
reCaptcha Support
gravatar Support in admin replies
Custom email templates which are sent to staff and customers, which can also be edited and include merge fields
Customer Features
Resolution Center link in top navigation bar (automatically shown), which shows a customer all their abuse reports - open and closed, with the ability to view both
Added 'last reply by' & 'service' columns to the overview page
Report details show vital information to the customer, including the service in question, the IP, date of incident, the category of the abuse report, as well as the abuse report it self.
Ability to view a read-only abuse report if an abuse report is set as closed
Ability to start a conversation with staff from within open abuse reports
Ability to self unsuspend a service (if enabled for a customer on abuse report creation or assigning)
gravatar Support in client replies
Public Features
Report Abuse link in top navigation bar (automatically shown), which is a public facing abuse report page, which allows 3rd parties to send you abuse reports easily
reCaptcha Support to avoid spam
Requirements
To be able to make use of Abuse Manager Pro, you have to make sure that the following requirements are fulfilled:
Latest Ioncube Loaders
Non strict firewall (to perform software license checks)
Latest version of WHMCS
A License Key to run the script
FTP client to assist with file upload
PHP_IMAP if fetching/importing emails & attachments
Quick Setup Guide
Purchase the script, and get a license code
Download the latest .zip file from the client area
Unzip the .zip file and place the contents into the WHMCS directory
Login to the admin side of WHMCS, and go to Setup > Addon Modules
Activate Abuse Manager Pro (AMP), then click on configure
Enter your license key, and fill the settings according to your choices and press save
Remember to give administrators access by ticking the check boxes respectively in access control
To fetch mail automatically, simply put the mail server hostname and port (i.e. mail.domain.com:143), email address, password, and select the SSL/TLS options. The emails will be fetched and queued into abuse manager pro.
(Optional) To enable the WHMCS's admin widget to be displayed on home page (admin side), go to Setup > Staff Management > Administrator Roles and edit the role you want it to be displayed for, and tick the check box under Widgets that says “Abuse Manager Pro - Reports Requiring Your Reply”
-
-
Upgrade Guide
Common Issues
Issue | Resolution |
Emails are imported twice when using PHP_IMAP Fetch | This usually happens when there is more than one cron entry, and can be fixed by keeping the main/default WHMCS cron entry only |
[WHMCS Application] ERROR: Error: Call to undefined function imap_open() | This usually happens when 'IMAP_OPEN' function is missing in PHP. Make sure IMAP is installed correctly. Also, this could be an issue with the CRON invoking wrong PHP (e.g. if invoking CRON from web works fine) |
Changelog
A Changelog will be posted on the page linked here, upon any updates.