Personal tools
Namespaces

Variants
Actions

Hosting Quota Notifications 1.X For WHMCS

From ModulesGarden Wiki
(Difference between revisions)
Jump to: navigation, search
(Extension Configuration)
 
(154 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<meta name="keywords" content="product auto upgrade for whmcs, product auto upgrade configuration, product auto upgrade  management, product auto upgrade installation, product auto upgrade guide, modulesgarden product auto upgrade, product auto upgrade  wiki, product auto upgrade  tutorial, product auto upgrade tips, whmcs billing module wiki, product auto upgrade common problems, about product auto upgrade, product auto upgrade documentation, product auto upgrade faq, product auto upgrade help"></meta>
+
<meta name="keywords" content="hosting quota notifications for whmcs, hosting quota notifications configuration, whmcs hosting quota notifications management, whmcs hosting quota notifications installation, whmcs hosting quota notifications common problems, about whmcs hosting quota notifications, whmcs hosting quota notifications documentation, whmcs hosting quota notifications faq, whmcs hosting quota notifications help, whmcs hosting quota notifications guide, whmcs hosting quota notifications wiki, whmcs hosting quota notifications tutorial, whmcs hosting quota notifications tips, whmcs hosting quota notifications wiki"></meta>
<meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About The Product Auto Upgrade For WHMCS Module."></meta>
+
<meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About The Hosting Quota Notifications For WHMCS Module."></meta>
  
=About [https://www.modulesgarden.com/products/whmcs/product-auto-upgrade Product Auto Upgrade For WHMCS]=
+
=About [https://www.modulesgarden.com/products/whmcs/hosting-quota-notifications Hosting Quota Notifications For WHMCS]=
 
{|
 
{|
|style="padding: 10px 0px 10px 0px;"|'''Product Auto Upgrade For WHMCS''' permits to automatically shift products on the basis of the server resource usage tracked with Advanced Billing For WHMCS module.<br/>Additionally, you will be able to modify rules related to the server resource usage according to which the module will upgrade/downgrade products and their configurable options at the same time.<br/>Thanks to this module, your clients can decide if they want their products to be adjusted as well as freely set the rules on their own.
+
|style="padding: 10px 0px 10px 0px;"|'''Hosting Quota Notifications For WHMCS''' allows you to send automatic notifications to your clients whenever they exceed previously set bandwidth or disk usage.
 +
Notifications can be sent in two ways: upon exceeding given resource tier or after exceeding given resource limit in a specified time period.<br />
 +
You can also define email templates and view details of each sent notification owing to logs.
 
|}
 
|}
<!--Comment-->
+
<!--a comment maybe? -->
 
*'''Admin Area Features:'''
 
*'''Admin Area Features:'''
 
{|
 
{|
|style="padding: 10px 0px 0px 30px;"|✔ Define Product Auto Upgrade Groups
+
|style="padding: 10px 0px 0px 30px;"|✔ Automatically Notify Your Clients Upon Exceeding Defined Limits Of Bandwidth And Disk Usage
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 30px;"|✔ Enable/Disable Product Auto Upgrade Groups
+
|style="padding: 0px 0px 0px 30px;"|✔ Configure Notification Groups
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 30px;"|✔ Create Product Auto Upgrade Options
+
|style="padding: 0px 0px 0px 30px;"|✔ Choose Between Two Types Of Group Counting:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 30px;"|✔ Assign Product To An Option - Configurable Option Support
+
|style="padding: 0px 0px 0px 45px;"|✔ Tiered - Define Tiers Of Usage
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 30px;"|✔ Define Options Upgrade/Downgrade Rules
+
|style="padding: 0px 0px 0px 45px;"|✔ Fixed - Define Usage Grow Over Time
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 30px;"|✔ Set Up Minimal Upgrade/Downgrade Interval
+
|style="padding: 0px 0px 0px 30px;"|✔ Assign Multiple Products To Single Notification Group
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 30px;"|✔ Enable/Disable Any Product Auto Upgrade Option
+
|style="padding: 0px 0px 0px 30px;"|✔ Assign Email Templates Per Notification Group
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 30px;"|✔ Drag & Drop To Reorder Options
+
|style="padding: 0px 0px 0px 30px;"|✔ Enable/Disable Notification Groups
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 30px;"|✔ Define Client Area Features
+
|style="padding: 0px 0px 10px 30px;"|✔ View Logs Of Sent Notifications
|}
+
{|
+
|style="padding: 0px 0px 0px 30px;"|✔ View List Of All Hostings Affected By Product Auto Upgrade
+
|}
+
{|
+
|style="padding: 0px 0px 10px 30px;"|✔ Access Product Auto Upgrade History Of Any Hosting
+
|}
+
*'''Client Area Features:'''
+
{|
+
|style="padding: 10px 0px 0px 30px;"|✔ Enable/Disable Product Auto Upgrade And Product Auto Upgrade Options
+
|}
+
{|
+
|style="padding: 0px 0px 0px 30px;"|✔ Manage Rules Of Product Auto Upgrade Options
+
|}
+
{|
+
|style="padding: 0px 0px 0px 30px;"|✔ Set Up Minimal Upgrade/Downgrade Interval
+
|}
+
{|
+
|style="padding: 0px 0px 0px 30px;"|✔ View Products' Product Auto Upgrade History
+
|}
+
{|
+
|style="padding: 0px 0px 0px 30px;"|✔ Set Up Rules Of Notifications
+
|}
+
{|
+
|style="padding: 0px 0px 10px 30px;"|✔ Define Minimal Notification Interval
+
 
|}
 
|}
 
*'''General Info:'''
 
*'''General Info:'''
 
{|
 
{|
|style="padding: 10px 0px 0px 30px;"|✔ Requires <u>Advanced Billing For WHMCS</u> - Server Resource Usage Billing [http://www.modulesgarden.com/products/whmcs/advanced_billing/features (read more)]
+
|style="padding: 10px 0px 0px 30px;"|✔ Multi-Language Support
|}
+
{|
+
|style="padding: 0px 0px 0px 30px;"|✔ Multi-Language Support
+
|}
+
{|
+
|style="padding: 0px 0px 0px 30px;"|✔ Supports PHP 5.3 Up To PHP 7
+
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS Templates Five and Six
+
|style="padding: 0px 0px 0px 30px;"|✔ Supports PHP 5.6 Up To PHP 7.2
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 30px 30px;"|✔ Supports WHMCS V6 and V7
+
|style="padding: 0px 0px 30px 30px;"|✔ Supports WHMCS V7
 
|}
 
|}
  
=Installation and Configuration=
+
=Installation=
 
{|
 
{|
|style="padding: 10px 0px 0px 0px;"|'''In this tutorial we will show you how to successfully install and administer Product Auto Upgrade For WHMCS.'''<br />
+
|style="padding: 10px 0px 30px 15px;"|'''This tutorial will show you how to successfully install and configure Hosting Quota Notifications For WHMCS.''' <br />
 
We will guide you step by step through the whole installation and configuration process.
 
We will guide you step by step through the whole installation and configuration process.
 
|}
 
|}
 +
==Installation==
 
{|
 
{|
|style="padding: 20px 0px 20px 15px;"|'''1. Log in to your client area and download the module.'''
+
|style="padding: 10px 0px 20px 15px;"|'''1. Log in to our client area and download the module.'''
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:AB2_AS_1.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HQN_1.png]]
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 10px 15px;"|'''2. In the downloaded file you will find two packages that support different PHP versions.'''<br/>As shown on the screen below, the first one is dedicated to PHP 7, while the second one is aimed at PHP 5.3 up to PHP 5.6.<br/>It does not apply to open source versions.<br/>
+
|style="padding: 0px 0px 10px 15px;"|'''2. In the downloaded file you will find two packages that support different PHP versions.'''<br/>As presented on the screen below, the first one is dedicated to PHP 5.6 up to PHP 7.0, while the second one is aimed at PHP 7.1 up to PHP 7.2.<br/>It does not apply to open source versions.<br/>
'' '''Note''': You can check current PHP version in your WHMCS. To do so, go to ''' 'Utilities' 'System' 'PHP Info'.'''
+
'' '''Note''': You can check the current PHP version in your WHMCS. To do so, proceed to ''' 'Utilities' 'System' 'PHP Info'.'''
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 30px 25px;"|[[File:AB2_AS_2.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:PHP56_72.png]]
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|'''3. Extract the downloaded file and choose the one with matching PHP version. Upload and extract the PHP file into the main WHMCS directory.'''<br />
+
|style="padding: 0px 0px 15px 15px;"|'''3. Extract the downloaded file and choose the one with the right PHP version. Upload and extract the PHP file into the main WHMCS directory.'''<br />
Files in your WHMCS directory should look like this.
+
The content of PHP version files should look like this.  
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 30px 25px;"|[[File:drte4.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:drfere.png]]
 
|}
 
|}
 
==Module Configuration==
 
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|'''4. Now you need to activate the module in your WHMCS system.'''<br/>
+
|style="padding: 0px 0px 15px 15px;"|'''4. When you install Hosting Quota Notifications For WHMCS for the first time you have to rename '' 'license_RENAME.php' '' file.'''<br />
Move to '' 'Setup' 'Addon Modules', '' find '' 'Advanced Billing' '' and press '' 'Activate' '' button.<br/>
+
File is located in '' 'modules/addons/hosting_quota_notifications/license_RENAME.php' '' . Rename it from '' 'license_RENAME.php' '' to '' 'license.php' '' .
''Note: Skip this subsection, if you have Advanced Billing For WHMCS already installed.''
+
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_5.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HQN_3.png]]
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|'''5. At this point you are asked to assign access permissions for the module.'''<br/>
+
|style="padding: 0px 0px 15px 15px;"|'''5. In order to configure your license key, you have to edit a previously renamed '' 'license.php' '' file.'''<br />
In order to do that, press '' 'Configure', '' choose desired admin roles and press '' 'Save Changes'. ''
+
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' ''.  
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_6.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:HQN_4.png]]
|}
+
{|
+
|style="padding: 0px 0px 20px 15px;"|'''6. Now, set up a cron job, you can find it in your WHMCS → '' 'Addons' → 'Advanced Billing' '' as demonstrated on the following screen.'''
+
|}
+
{|
+
|style="padding: 0px 0px 30px 25px;"|[[File:PAU_7.png]]
+
 
|}
 
|}
  
==Extension Configuration==
+
==Configuration of Addon==
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|'''7. In the next step you have to activate the extension in your Advanced Billing For WHMCS.'''<br/>
+
|style="padding: 10px 0px 15px 15px;"|'''6. Now you have to activate the module in your WHMCS system.'''<br />
Log in to your WHMCS admin area and proceed to '' 'Addons' '' → '' 'Advanced Billing' '' '' 'Settings' '' '' 'Extensions'. ''<br/>
+
Log in to your WHMCS admin area. Go to '' 'Setup' '' → '' 'Addon Modules' ''. Afterwards, find '' 'Hosting Quota Notifications' '' and press '' 'Activate' '' button.
Afterwards, find '' 'Product Auto Upgrade' '' and enable the extension.
+
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_8.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HQN_5.png]]
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|'''8. Next, you need to provide your license key.'''<br/>
+
|style="padding: 0px 0px 15px 15px;"|'''7. In the next step you need to permit access to this module.'''<br />
Press '' 'Configure' '' next to the extension.
+
To do so click on '' 'Configure' '' button, tick '' 'Access Control' '' near required admin role groups and press '' 'Save Changes' ''.
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_8_1.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:HQN_6.png]]
|}
+
{|
+
|style="padding: 0px 0px 20px 15px;"|'''9. Paste your license and confirm the changes.'''
+
|}
+
{|
+
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_9.png]]
+
|}
+
{|
+
|style="padding: 0px 0px 30px 15px;"|'''Your Product Auto Upgrade For WHMCS is now ready to use! '''
+
 
|}
 
|}
  
=Management=
 
{|
 
|style="padding: 10px 0px 10px 15px;"|'''In order to link any product with Product Auto Upgrade For WHMCS, first you need to enable and then configure it in Advanced Billing For WHMCS.'''<br/>
 
Advanced Billing For WHMCS is used to collect information about hosting's resource usage.<br/>
 
'''Important:''' Product Auto Upgrade For WHMCS uses '' 'Change Package' '' option to switch the products.<br/>Therefore it is required that the products are compatible with this feature.
 
|}
 
==Admin Area==
 
{|
 
|style="padding: 0px 0px 20px 15px;"|At first you are asked to enable the products you want to work with for Advanced Billing.
 
|}
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_10.png]]
 
|}
 
{|
 
|style="padding: 0px 0px 15px 15px;"|Now, you have to switch on the extension Product Auto Upgrade For WHMCS for each of the products.<br/>Move to '' 'Settings', '' find appropriate section and enable the extension.
 
|}
 
{|
 
|style="padding: 0px 0px 30px 25px;"|[[File:PAU_10_1.png]]
 
|}
 
===Groups of Rules===
 
{|
 
|style="padding: 10px 0px 15px 15px;"|As you might have already noticed, a new tab dedicated to the extension appeared in main menu of your Advanced Billing For WHMCS module .<br/>The whole management of the extension is located under this section.<br/>
 
Firstly, move on to '' 'Configuration' ''.
 
|}
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_11.png]]
 
|}
 
{|
 
|style="padding: 10px 0px 15px 15px;"|What you will find there is a full list of autoscaling groups.<br/>
 
Here you can find information such as status of a group, its name and used submodule.<br/>What is more, you can prepare rules for scaling services by managing groups while using buttons in '' 'Actions' '' column to prepare rules for scaling services.
 
|}
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_11_1.png]]
 
|}
 
{|
 
|style="padding: 10px 0px 15px 15px;"|Right now let's see how to create a new group.<br/>
 
Press '' 'Create New Group' '' button and a short formula will appear.
 
|}
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_12.png]]
 
|}
 
{|
 
|style="padding: 0px 0px 15px 15px;"|You can select products and define rules in each group which will result in upgrading/downgrading client's hosting.<br/>
 
Name your new group - this name is only for your information and convenience. Then select the product you want to be automatically upgraded or downgraded according to current resource usage.<br/>Optionally, you can enable and choose configurable option group that will be used to define products' options.<br/>
 
Save the group once it is ready.
 
|}
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_13.png]]
 
|}
 
{|
 
|style="padding: 0px 0px 20px 15px;"|Your newly created group appeared on the list. Now you can configure it according to your preferences.
 
|}
 
{|
 
|style="padding: 0px 0px 30px 25px;"|[[File:PAU_13_1.png]]
 
|}
 
====Group Configuration====
 
{|
 
|style="padding: 10px 0px 15px 15px;"|There are two main sections where a group can be configured.
 
#'' 'Settings' '' - a place where general and client area arragnements can be made.
 
#'' 'Options' '' - detailed configuration of rules to scale services automatically.
 
|}
 
{|
 
|style="padding: 0px 0px 30px 25px;"|[[File:PAU_14.png]]
 
|}
 
=====Group Settings=====
 
{|
 
|style="padding: 10px 0px 15px 15px;"|'''General Configuration'''
 
*'''Group Name''' - name of a group, can be changed at any time and is visible only to the admin.
 
*'''Server Type''' - module type of the product allowed in the group.
 
*'''Time Interval''' - minimum time period between the two products changes that can be made on a single hosting.
 
*'''Notifications Time Interval''' - defines time between notifications sent to a client.
 
|}
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_14_1.png]]
 
|}
 
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|'''Client Area Configuration'''
+
|style="padding: 0px 0px 15px 15px;"|'''8. You have just successfully installed Hosting Quota Notifications For WHMCS!'''<br />
*'''Display Client Rules Configuration''' - shows rules of this group for clients with products configured in the group.
+
You can access your module in '' 'Addons' '' '' 'Hosting Quota Notifications' ''.
*'''Modify Rules Configuration''' - client can modify group rules, changes will affect their product only.
+
*'''Modify Time Interval''' - client can modify the minimum time between two switches on a single hosting.
+
*'''Allowed Time Interval Values''' - specifies what time interval a client can use (they will be displayed in the form of a dropdown menu or a textbox with a limited range).
+
*'''Enable Notifications''' - allows the client to enable/disable notifications.
+
*'''Modify Notifications Time Interval''' - allows the client to modify minimum time between two notifications.
+
*'''Allowed Notifications Time Interval Values''' - defines values which can be used by client.<br/>
+
Do not forget to save the configuration when it is ready.
+
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 30px 25px;"|[[File:PAU_14_2.png]]  
+
|style="padding: 0px 0px 30px 25px;"|[[File:HQN_7.png]]
 
|}
 
|}
  
=====Group Options=====
+
=Configuration and Management=
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|The second place where the group rules can be modified is '''Options''' section.<br/>
+
|style="padding: 10px 0px 30px 15px;"|'''In this section we will show you how to properly set up and use Hosting Quota Notifications For WHMCS.'''
These rules will be used by the extension to determine which service should be changed.<br/>Service will be changed according to the parameters set in rules options if the condition of either downgrade rules or upgrade rules has been met.  
+
 
|}
 
|}
 +
==Configuration==
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_15.png]]
+
|style="padding: 10px 0px 15px 15px;"|In '' 'Configuration' '' page you can find the list of configured notification groups.<br />
 +
You can enable/disable any of them, as well as alter or completely remove them.<br />
 +
Press '' 'Create New Group' '' to proceed.
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|Every group has already some predefined basic options - disabled at the start.<br/>You can base your rules configuration on them or add your own ones in case they are not sufficient.<br/>Let us show how to set the autoscaling rules on the basis of these options.<br/>
+
|style="padding: 0px 0px 20px 25px;"|[[File:HQN_9.png]]
Before you can do anything, you must configure the upgrade and downgarade rules.
+
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_16.png]]
+
|style="padding: 0px 0px 15px 15px;"|Now, you can define all products related to this configuration and email template which will be used to notify your clients.<br />
 +
You can choose between two types of resource usage counting:<br />
 +
*Fixed - define amount of resources over specific time period. If client usage growth has exceeded the given limit in specified time, a notification will be sent.
 +
*Tiered - defines amount of resources. If client exceeds given limit, a notification will be sent.
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|'' 'Upgrade Rules'/'Downgrade Rules' '' can have multiple rules defined.<br/>
+
|style="padding: 0px 0px 20px 25px;"|[[File:HQN_10.png]]
To add a new rule, select it from a dropdown menu marked on the following screen and press '' 'Add'.''
+
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_17.png]]
+
|style="padding: 0px 0px 15px 15px;"|For example, shown below module uses fixed counting type.<br />
 +
As you can see, we have defined limits for both bandwidth and disk.<br />
 +
Settings shown below result in sending notification to client upon:
 +
*bandwidth usage growth by 5GB during 21 days.
 +
*disk usage growth by 100GB over period of 14 days.
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|You can define comparison type and threshold of any added rule.<br/>
+
|style="padding: 0px 0px 30px 25px;"|[[File:HQN_11.png]]
To add a rule which will be fulfilled when the product has more or equal than 3 FTP accounts, choose '' '≥' '' from '' 'Comparison Type' '' and type '' '3' '' into '' 'Threshold' '' field.<br/>
+
This example can be seen on the following screen.
+
 
|}
 
|}
 +
==Logs==
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_18.png]]
+
|style="padding: 10px 0px 15px 15px;"|Under '' 'Logs' '' page you can view information about sent notifications.
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|You also have to define a product for each package that will be used when upgrading/downgrading.<br/>Press button marked on the screen to go on.
+
|style="padding: 0px 0px 30px 25px;"|[[File:HQN_12.png]]
 
|}
 
|}
 +
==Notifications==
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_18_1.png]]
+
|style="padding: 10px 0px 15px 15px;"|You can create as many notifications as you wish.<br />
 +
The only requirement is their type being set to '' 'Product/Service' ''.<br />
 +
Additionally, you can use {if} statement, as shown below:
 +
{if $bw_over} Your bandwidth usage is over {$bw_over}MB{if $bw_current} (current: {$bw_current}MB){/if}.{/if}
 +
{if $disk_over}Your disks usage is over {$disk_over}MB{if $disk_current} (current: {$disk_current}MB){/if}.{/if}
 +
It will allow you to use this email template for bandwidth and disk notifications at the same time.
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|Select the product you need from the available options in the dropdown menu.<br/>
+
|style="padding: 0px 0px 30px 25px;"|[[File:HQN_13.png]]
Then select option you wish to be used by clients and add it. Save the changes.<br/>
+
'''Important!''' Options selection is available only if a supported configurable options group has been enabled for the group of rules on its creation.
+
|}
+
{|
+
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_18_2.png]]
+
|}
+
{|
+
|style="padding: 0px 0px 20px 15px;"|Every selected option appears in the box above. Here you can specify available selection under '' 'Setting' '' or delete it.
+
|}
+
{|
+
|style="padding: 0px 0px 30px 25px;"|[[File:PAU_18_3.png]]
+
|}
+
{|
+
|style="padding: 0px 0px 15px 15px;"|Repeat that for all the packages you want to enable.<br/>
+
Note that only the packages with selected products can be enabled!
+
|}
+
{|
+
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_19.png]]
+
|}
+
{|
+
|style="padding: 0px 0px 20px 15px;"|Additionally, you can change the order the rules are displayed, simply drag and drop a rule and make a previously downgrade rule an upgrade one.
+
|}
+
{|
+
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_20.png]]
+
|}
+
{|
+
|style="padding: 0px 0px 20px 15px;"|Add new option, just type in its name, press '' 'Add New Option' '' and then configure it like the previous ones.
+
|}
+
{|
+
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_21.png]]
+
|}
+
{|
+
|style="padding: 0px 0px 15px 15px;"|Finally, you can describe shortly each option. Press ' ''Description' '' and a text area will appear.<br/>Type in your description there. As you can see, you can prepare a few language versions of the description.
+
|}
+
{|
+
|style="padding: 0px 0px 30px 25px;"|[[File:PAU_22.png]]  
+
 
|}
 
|}
  
===Accounts===
+
=Tips=
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|To access the list of hostings affected by the autoscaling groups proceed to '' 'Product Auto Upgrade' '' → '' 'Accounts'. ''<br/>
+
|style="padding: 10px 0px 30px 15px;"|
Information about each hosting can be found here along with the access to the hosting history.<br/>
+
Press '' 'View History' '' near desired hosting to view its history of changes.
+
|}
+
{|
+
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_23.png]]
+
|}
+
{|
+
|style="padding: 0px 0px 20px 15px;"|Hosting history contains the list of changes ever made for the hosting.
+
|}
+
{|
+
|style="padding: 0px 0px 30px 25px;"|[[File:PAU_24.png]]
+
 
|}
 
|}
  
==Client Area==
+
=Update Instructions=
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|In the following section we will show you client area with all autoscaling features enabled.<br/>
+
|style="padding: 10px 0px 30px 15px;"|Essential guidance through the process of updating the module is offered '''[https://www.docs.modulesgarden.com/How_To_Update_WHMCS_Module here]'''.<br/><br/>
As you can see, autoscaling is displayed on the main page of a product right below the Advanced Billing For WHMCS usage records.<br/>
+
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!<br/>
Press '' 'Show' '' to view details.
+
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.<br/>
 
|}
 
|}
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_25.png]]
 
|}
 
{|
 
|style="padding: 0px 0px 15px 15px;"|You can easily enable/disable autoscaling (red) or a selected option (blue) through pressing '' 'Enabled'/'Disabled' '' button and saving the changes.<br/>
 
To browse other options, use their names marked on the following screen.
 
|}
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_26.png]]
 
|}
 
{|
 
|style="padding: 0px 0px 15px 15px;"|Through pressing '' 'Show Rules' '' you can manage switching rules of currently displayed option.<br/>
 
Additionally, you can change the minimum interval between the changes through using marked field.
 
|}
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_27.png]]
 
|}
 
{|
 
|style="padding: 0px 0px 15px 15px;"|Rules are displayed in a table, press pencil icon next to the rule you wish to change.<br/>
 
Do not forget to save changes when you finish.
 
|}
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_28.png]]
 
|}
 
{|
 
|style="padding: 0px 0px 20px 15px;"|Besides the management of autoscaling, you can view the history of switches made on a hosting through pressing '' 'History'. ''
 
|}
 
{|
 
|style="padding: 0px 0px 30px 25px;"|[[File:PAU_29.png]]
 
|}
 
===Notifications===
 
{|
 
|style="padding: 10px 0px 15px 15px;"|Client can also set up notifications, they will be sent when requirements defined by a client are met.<br/>
 
For the settings shown on the following screen, notification will be sent every ten minutes if the following rules are met.<br/>
 
The product number of Installed applications is equal or higher than 10.
 
|}
 
{|
 
|style="padding: 0px 0px 30px 25px;"|[[File:PAU_30.png]]
 
|}
 
 
==Sample Usage==
 
{|
 
|style="padding: 10px 0px 5px 15px;"|In this section we will show you a sample situation when Product Auto Upgrade For WHMCS is used simultaneously with another built-in extension to Advanced Billing - [[Advanced_Billing_For_WHMCS#Recurring_Billing|Recurring Billing]].
 
|}
 
{|
 
|style="padding: 0px 0px 20px 15px;"|Let's say you have configured 3 cPanel Extended products enabled for Advanced Billing.
 
|}
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_31.png]]
 
|}
 
{|
 
|style="padding: 0px 0px 15px 15px;"|Each of the products has different limits set:<br />
 
*'''Product A''': Max 4 FTP accounts and 500 MB storage.
 
*'''Product B''': Max 10 FTP accounts and 1 GB storage.
 
*'''Product C''': Max 20 FTP accounts and 5 GB storage.<br/>
 
Afterwards, you have created an autoscaling group, added products listed above to it and defined them with following rules.
 
|}
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_32.png]]
 
|}
 
{|
 
|style="padding: 0px 0px 15px 15px;"|
 
*'''Product A - Lowest'''
 
**Upgrade Rule: &ge; 3 FTP accounts & &ge; 400 MB storage
 
*'''Product B - Middle'''
 
**Upgrade Rule: &ge; 9 FTP accounts & &ge; 8 GB storage
 
**Downgrade Rule: &le; 3 FTP accounts & &le; 300 MB storage
 
*'''Product C - Highest'''
 
**Downgrade Rule: &le; 8 FTP accounts & &le; 7 GB storage
 
|}
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:PAU_33.png]]
 
|}
 
{|
 
|style="padding: 0px 0px 10px 15px;"|Now, this is what is going to happen:<br />
 
1. A client, John orders product C and creates 3 FTP accounts in it.<br />
 
2. Advanced Billing cron job changes product C to product B with the first run, and further to product A in the second run (if minimum time interval provided has passed).<br />
 
3. John  uploads 450 MB of files, so now his product meets product A top rule requirement.<br />
 
4. Cron runs again, and changes his product to product B.<br />
 
5. John creates additional 7 FTP accounts and uploads files with total size of 550 MB.<br />
 
6. Now, his product meets product B upgrade rules only partially, therefore cron run has no effect.<br />
 
7. Some time passes and total amount of storage used by John reaches 8 GB.<br />
 
8. This time his product meets product B upgrade rules completely and is updated to product C.<br />
 
9. John removes 4 of his FTP accounts and 1 GB of files.<br />
 
10. Therefore his product meets product C bottom rules requirements and is downgraded to product B.<br />
 
|}
 
{|
 
|style="padding: 0px 0px 30px 15px;"|
 
That was all about upgrading/downgrading the products, but let us now see how the payments look like.<br/>
 
If your client orders product C and their product gets downgraded to  product B, they will be billed with product C price.<br/>
 
However, if the prices and free limits are set per resources, you will help your clients to avoid additional payments if their resource usage is low.<br/>
 
If you do it this way, clients will pay fixed price each month, but additional payment will depend on the resource they use.<br/>
 
In case you own only limited amount of resources, Product Auto Upgrade For WHMCS extension will allow you to use them more efficiently.<br/> Whereas the core Advanced Billing For WHMCS features will let you bill your clients adequately.
 
|}
 
 
=Tips=
 
{|
 
|style="padding: 10px 0px 30px 15px;"|1. If you want to allow access to a certain product only through automatic upgrade/downgrade of another product, you may set such product as hidden.<br/>Product Auto Upgrade For WHMCS allows configuration of hidden products.
 
|}
 
 
 
=Common Problems=
 
=Common Problems=
 
{|
 
{|
|style="padding: 10px 0px 10px 15px;"|'''1. When you have problems with connection, check whether your SELinux or firewall does not block ports.'''
+
|style="padding: 10px 0px 30px 15px;"|'''1. When you have problems with connection, check whether your SELinux or firewall does not block ports.'''
|}
+
{|
+
|style="padding: 0px 0px 30px 15px;"|2. In case you encounter any issues when enabling the extension, please make sure you are using Advanced Billing For WHMCS 3.1.3 or later.<br/> Product Auto Upgrade For WHMCS 2.0.0 is not supported by the previous versions of Advanced Billing.
+
 
|}
 
|}

Latest revision as of 11:02, 13 September 2018

Contents

[edit] About Hosting Quota Notifications For WHMCS

Hosting Quota Notifications For WHMCS allows you to send automatic notifications to your clients whenever they exceed previously set bandwidth or disk usage.

Notifications can be sent in two ways: upon exceeding given resource tier or after exceeding given resource limit in a specified time period.
You can also define email templates and view details of each sent notification owing to logs.

  • Admin Area Features:
✔ Automatically Notify Your Clients Upon Exceeding Defined Limits Of Bandwidth And Disk Usage
✔ Configure Notification Groups
✔ Choose Between Two Types Of Group Counting:
✔ Tiered - Define Tiers Of Usage
✔ Fixed - Define Usage Grow Over Time
✔ Assign Multiple Products To Single Notification Group
✔ Assign Email Templates Per Notification Group
✔ Enable/Disable Notification Groups
✔ View Logs Of Sent Notifications
  • General Info:
✔ Multi-Language Support
✔ Supports PHP 5.6 Up To PHP 7.2
✔ Supports WHMCS V7

[edit] Installation

This tutorial will show you how to successfully install and configure Hosting Quota Notifications For WHMCS.

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

[edit] Installation

1. Log in to our client area and download the module.
HQN 1.png
2. In the downloaded file you will find two packages that support different PHP versions.
As presented on the screen below, the first one is dedicated to PHP 5.6 up to PHP 7.0, while the second one is aimed at PHP 7.1 up to PHP 7.2.
It does not apply to open source versions.

Note: You can check the current PHP version in your WHMCS. To do so, proceed to 'Utilities' › 'System' › 'PHP Info'.

PHP56 72.png
3. Extract the downloaded file and choose the one with the right PHP version. Upload and extract the PHP file into the main WHMCS directory.

The content of PHP version files should look like this.

Drfere.png
4. When you install Hosting Quota Notifications For WHMCS for the first time you have to rename 'license_RENAME.php' file.

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

HQN 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' .

HQN 4.png

[edit] Configuration of Addon

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 'Hosting Quota Notifications' and press 'Activate' button.

HQN 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 required admin role groups and press 'Save Changes' .

HQN 6.png
8. You have just successfully installed Hosting Quota Notifications For WHMCS!

You can access your module in 'Addons' 'Hosting Quota Notifications' .

HQN 7.png

[edit] Configuration and Management

In this section we will show you how to properly set up and use Hosting Quota Notifications For WHMCS.

[edit] Configuration

In 'Configuration' page you can find the list of configured notification groups.

You can enable/disable any of them, as well as alter or completely remove them.
Press 'Create New Group' to proceed.

HQN 9.png
Now, you can define all products related to this configuration and email template which will be used to notify your clients.

You can choose between two types of resource usage counting:

  • Fixed - define amount of resources over specific time period. If client usage growth has exceeded the given limit in specified time, a notification will be sent.
  • Tiered - defines amount of resources. If client exceeds given limit, a notification will be sent.
HQN 10.png
For example, shown below module uses fixed counting type.

As you can see, we have defined limits for both bandwidth and disk.
Settings shown below result in sending notification to client upon:

  • bandwidth usage growth by 5GB during 21 days.
  • disk usage growth by 100GB over period of 14 days.
HQN 11.png

[edit] Logs

Under 'Logs' page you can view information about sent notifications.
HQN 12.png

[edit] Notifications

You can create as many notifications as you wish.

The only requirement is their type being set to 'Product/Service' .
Additionally, you can use {if} statement, as shown below:

{if $bw_over} Your bandwidth usage is over {$bw_over}MB{if $bw_current} (current: {$bw_current}MB){/if}.{/if}
{if $disk_over}Your disks usage is over {$disk_over}MB{if $disk_current} (current: {$disk_current}MB){/if}.{/if}

It will allow you to use this email template for bandwidth and disk notifications at the same time.

HQN 13.png

[edit] Tips

[edit] Update Instructions

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

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.

[edit] 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