Personal tools
Namespaces

Variants
Actions

Premium Support Tickets For WHMCS

From ModulesGarden Wiki
Revision as of 15:32, 27 May 2019 by Karolina (Talk | contribs)

Jump to: navigation, search

Contents

About Premium Support Tickets For WHMCS

Premium Support Tickets For WHMCS will allow you to control access to your support services and charge fees for submitting tickets into certain departments.

The module enables your clients to purchase products and product addons containing Support Credit Points used for opening support tickets in chosen departments.
At the same time, you will be free to establish rules for credit points application, and closely supervise each action taken by your customers.

  • Module Features:
✔ Store And Manage Support Credit Points Per Department
✔ Dedicated Points - Used Only For Specific Departments
✔ Shared Points - Used Freely Among All Selected Departments
✔ Add Support Credit Points Upon Ordering Specified Product Or Addon - Depending On Applied Rule
✔ Remove Fixed Number Of Support Credit Points Upon Ticket Opening
✔ Block Ticket Opening If Client Has Insufficient Number Of Support Credit Points
  • Admin Area Features:
✔ Define Number Of Support Credit Points Required To Open Ticket - According To Chosen Department And Priority
✔ Create/Edit/Remove Rules
✔ Create/Edit/Remove Rules
✔ Enable/Disable Rules
✔ View Support Credit Points Owned By Clients
✔ Modify Number Of Support Credit Points Owned By Clients
  • Client Area Features:
✔ Order Support Credit Points
✔ View Available Support Credit Points Per Ticket Department
✔ View Number Of Support Credit Points Required To Open Ticket - According To Chosen Department And Priority
  • Rules Configuration:
✔ Set Rule Type - Product/Product Group/Product Addon
✔ Define Items That Shall Be Ordered By Client To Obtain Support Credit Points
✔ Define Number Dedicated Points And Select Department They Should Be Added To
✔ Define Number Of Shared Points To Be Applied To Client's Account
✔ Define If Support Credit Points Are Added To Client's Account Once Or After Each Billing Cycle
✔ View Rule Status
  • General Info:
✔ Multi-Language Support
✔ Supports PHP 5.6 Up To PHP 7.3
✔ Supports WHMCS Template Six
✔ Supports WHMCS V7.5 And Later
✔ Easy Module Upgrade To Open Source Version

Installation

This tutorial will show you how to successfully install and configure Premium Support Tickets For WHMCS.

We will guide you step by step through the whole installation and configuration process.

1. Log in to our client area and download the module.
PST 1.png
2. In the downloaded file you might find one or two packages that support different PHP versions.

In the most recent versions of the module, you will find only one package that supports PHP 7.1 and later.
If you need a package for the previous versions of PHP, please contact our support.

PHP71 73.png
Previous updates of the module may contain two packages dedicated to various PHP versions.

The first one that supports PHP 5.6 up to PHP 7.0, and the second one addressed to PHP 7.1 up to PHP 7.3.
Note: Keep in mind that PHP versions 5.6 up to 7.0 are no longer officially supported and their security issues are not fixed or released any more. Find more info here.

PHP56 73.png
Important: This situation does not affect the open source version of this module which can be applied to any PHP from version 5.6 and later.
Note: You can check the current PHP version in your WHMCS. To do so, proceed to 'Utilities' → 'System' → 'PHP Info'.
3. Once you have chosen the package with the right PHP version, extract it and upload its content into the main WHMCS directory.

The content of the chosen PHP version files to upload should look like this.

PST 2.png
4. When you install Premium Support Tickets For WHMCS for the first time you have to rename 'license_RENAME.php' file.

File is located in '/modules/addons/PremiumSupportTickets/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php' .

PST 3.png
5. In order to configure your license key, you have to edit a previously renamed 'license.php' file.

Enter your license key between quotation marks as presented on the following screen. You can find your license key in our client area → 'My Products'.

PST 4.png
6. Now you have to activate the module in your WHMCS system.

Log in to your WHMCS admin area. Go to 'Setup' 'Addon Modules'. Afterwards, find 'Premium Support Tickets' and press 'Activate' button.

PST 5.png
7. In the next step you need to permit access to this module.

To do so click on 'Configure' button, tick 'Access Control' near desired admin role groups and press 'Save Changes'.

PST 6.png
8. Proceed to 'Addons' 'Premium Support Tickets' 'Integration Code' and follow steps listed there to apply code snippets to your template.

Note: The following integration is based on default WHMCS template 'Six'.
Find and open file 'supportticketsubmit-stepone.tpl' located in the template directory you are using, follow the steps described below:

PST 7.png
Find and open file 'supportticketsubmit-steptwo.tpl' located in the template directory you are using, follow the steps described below:

Please mind the lines numbers, they might differ in your files!

PST 8.png
9. You have just successfully installed Premium Support Tickets For WHMCS!

Configuration and Management

At this section we will show you possibilities of Premium Support Tickets For WHMCS.

Our module allows you to limit the quantity of new support tickets through introducing Support Credit Points.
Those Support Credit Points will be required to open new tickets.
The amount of Support Credit Points required to do so may vary depending on tickets' status and department they are created in.
Support Credit Points may be obtained along with your products or by ordering special products or product addons.

Rules List

Rules section defines which products or product addons your clients can receive Support Credit Points for.
Additionally, they define which department they can be spent in and if they are granted one time or with product's each billing cycle.

As you can see, basic information related to the rules is listed under 'Rules' → 'Show Rules' tab.

PST 9.png
You can view items assigned to the rule as well as departments, which Support Credit Points (Dedicated and Shared) will be granted to, by pressing buttons marked on the following screen.
PST 10.png
Additionally, you can easily manage each of the rules by using buttons in the 'Actions' column.
PST 11.png

Add Rule

Lets create a new rule by pressing 'Add Rule' to proceed.
PST 12.png
Step 1. Fill in rule name and choose rule type through pressing 'Select' button next to the desired item.

Item type selected here defines the type of the item, for ordering which, your clients will receive Support Credit Points.

PST 13.png
Step 2. Select items the order and activation of which will result in receiving Support Credit Points.

Alternatively, you can switch 'Select All' to 'On', then, this rule will be applied to all items in the selected items type.
Press 'Next' or 'Step 3' to continue.

PST 14.png
Step 3. Now, define departments to apply Support Credit Points to by selecting desired ones or switching 'Select All' to 'On'.

Next, select billing options for this rule, you can choose one time, for credits to be applied only for the fist bough of the product, or recurring, to apply them also every time the client renews it.

Finally fill in amount of 'Dedicated Points' and 'Points' which will be added by the rule to client's Support Credit Points and select the rule status.
Note: If you want points to be added only for one type (Shared or Dedicated), leave the second one to '0' value.
Go to Tips and Shared Points Departments section for more information on the differences between these types.

Confirm creation of this rule through pressing 'Finish' button.

PST 15.png
As you can see on the following screen, the rule has been successfully added.
PST 16.png

Department Settings

By default, all tickets are free to open. In the 'Department Settings' tab you can define price per ticket.

Let's set up Support Credit Points required to open tickets in the 'General Support' department.
Press 'Show Details' next to the selected department as shown on the following screen to proceed.

PST 17.png
Now, start by defining base price per ticket, it will be added to the price per ticket status.

Afterwards, fill in the additional prices for low, normal and high status tickets. They will be sum up as 'Total' with the base price.
Confirm those settings through pressing 'Save'.

PST 18.png

Shared Points Departments

Shared Points are a common support credits that are assigned to a client's account, instead by a single support departments.
Thanks to this, the clients can freely distribute their shared credits among any departments you have selected here.
Once the departments are chosen, the Support Credit Points will be used from a shared balance to open a ticket.

Important: If you choose departments for Shared Points, this does not mean that their Dedicated Points will no longer be applied.
If the customer still owns a Dedicated Points for the specific department, then these credits will be used first and only after they've been run out, the Shared Points will be applied.
For this reason, the number of 'Support Credit Points' balance displayed next to the specific department is shown as the sum of the Dedicated Points and Shared Points.

Note: If you want, you can also not configure any Dedicated Points credits in the module, so all clients will only use their Shared Points freely for all chosen departments.

PST 37.png

Clients

In the 'Clients' tab you can view the amount of Support Credit Points owned by your clients.

You can use filter to search for a specific client.

PST 19.png
To display/hide client's Support Credit Points, press 'Show Detailed Information' / 'Hide Detailed Information' as shown on the screen below.
PST 20.png
You can also manually add/remove credit points to a client, press 'Modify Support Credit Points' to do so.
PST 21.png
Now, fill in the amount of Support Credit Points to be added or removed and then press 'Save'.
PST 22.png

Client Area

Let's proceed to the client area in order to create a ticket.

As you can see, one of the departments is unavailable because this client does not own any Support Ticket Points assigned to this department.
Let's create a ticket in '24/7 Support' department.

PST 23.png
Clients can view their Support Credit Points for chosen department.

Additionally, they can see the price per each ticket priority as shown on the following screen.

PST 24.png
As you can see the number of client's points in the department has been reduced from 200 to 100 once the ticket has been correctly submitted.
PST 25.png

Sample Workflow

In this section we will show you basic workflow of Premium Support Ticket For WHMCS usage.

New Product Department

1. Let's start by creating a new ticket department, proceed to 'Setup' 'Support' 'Support Departments'.

Now, press 'Add New Department'.

PST 26.png
2. Fill in department name, description and email address.

Additionally, assign administrators to it, mark 'Clients Only' and press 'Add New Department'.

PST 27.png

New Product Addon

3. Now, let's create a rule, which will add Support Credit Points to the new department.

In our case, Support Credit Points will be added through product addon.
Therefore, we need to create the product addon first.
Proceed to 'Setup' 'Products/Services' 'Product Addons' and press 'Add New Addon'.

PST 28.png
4. Fill in addon name and description. Additionally mark 'Show on Order' option.
PST 29.png
5. Move to the Pricing tab, choose one time billing type, and set the desired price.
PST 29 1.png
6. Finally in Applicable Products, assign desired services and proceed through pressing 'Save Changes' .
PST 29 2.png

New Rule

  1. Go to 'Addons' 'Premium Support Ticket' and press 'Add Rule'.
  2. Fill in the rule name and select 'Product Addon' rule type.
  3. Now, select previously created product addon and press 'Next'.
  4. Set up previously created department and select 'One Time' from 'Support Credit Points Frequency' dropdown menu.
    Now, fill in 200 into 'Dedicated Points' or 'Shared Points' field and press 'Finish'.
  5. As you can see, rule appeared in rule list and is ready for use.
PST 30.png

Department Configuration

12. Let us now set up amount of points required to open tickets in the previously created departments.

Proceed to the 'Department Settings' tab and press 'Show Details' next to the previously created department.

13. Leave 'Required Points' at 0, and fill in 'Low' , 'Normal' and 'High' ticket statuses with 30, 60 and 120 values respectively.

Press 'Save' to confirm changes.

PST 31.png

Example Order

14. Log in to client account and order one of product with the previously created product addon.
PST 32.png

New Ticket

15. After payment, both the product and product addon ordered along with it are now active.

200 Support Credit Points were granted to this account and now can be spent in the '24/7 Support' department.

PST 33.png
16. Let us use Support Credit Points by opening a new ticket in the '24/7 Support' department with the 'High' status.

It will cost 120 Support Credit Points. There should be 200 points on your account so you can afford creating only one ticket with the 'High' status.

PST 34.png
17. As you can see on the following screen, the ticket was successfully created.
PST 35.png
18. Adequate number of Support Credit Points was removed from the '24/7 Support' department points bundle.
PST 36.png

Tips

1. It is advised to set one of the departments as free of any charge. Remember to assign it the lowest priority of support to keep the other competitive.
2. Since version 1.2.0 of the module, there are two types of Support Credit Points:
  • Dedicated Points - as in previous versions of the module, these credits are assigned to departments and can only be used for these specific ones when opening a ticket
  • Shared Points - these credits are assigned to client's account and can be freely used among departments you previously enabled

However, if the client owns both types of support credits, they will be displayed as a sum under the Support Credits Points balance per department, with dedicated points being used first and shared points only afterwards.

Update Instructions

Essential guidance through the process of updating the module is offered here.

If you are upgrading the module from a version prior to 1.2.0, there are also some minor changes with the code integration, so remember to apply it again.

Keep in mind there is a quick and easy option in our client area that will let you upgrade the license of your module to an open source version at any time - and at a lower price!
To take advantage of it, simply use the License Upgrade button located on the product's page and a discounted invoice will be generated automatically.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
Navigation
WHMCS Modules
WHMCS Widgets
Translations
cPanel Modules
General
FAQ
Community
Premium Support Tickets For WHMCS