Personal tools
Namespaces

Variants
Actions

Hosting Renewals For WHMCS

From ModulesGarden Wiki
(Difference between revisions)
Jump to: navigation, search
Line 5: Line 5:
 
=About [https://www.modulesgarden.com/products/whmcs/hosting-renewals Hosting Renewals For WHMCS]=
 
=About [https://www.modulesgarden.com/products/whmcs/hosting-renewals Hosting Renewals For WHMCS]=
 
{|
 
{|
−
|style="padding: 10px 0px 5px 0px;"|'''Hosting Renewals For WHMCS''' is a module which offers your customers a possibility to manage their billing cycles, recurring payments and services' renewals.<br />
+
|style="padding: 10px 0px 5px 0px;"|'''Hosting Renewals For WHMCS''' is a module which enables you to handle the billing cycles, recurring payments and renewals of services belonging to your customers in a unique and user-friendly way.<br />
−
The module will let your clients turn on/off automatic renewals, decide whether and when to renew their web hosting services and even change billing cycles on the fly.<br />
+
The module will grant your clients the ability to control the activation of their automatic renewals, they will also be able to decide on the renewals of their web hosting services, not to mention it will take less time to change the billing cycle.<br />
−
With our product you will be able to configure billing cycle changing rules, prepare various discounts and send personalized email notifications to your customers.
+
Thanks to Hosting Renewals, you will posses the faculty of configuring billing cycle, changing rules, preparing various discounts and your customers will start receiving fit for purpose email notifications.
 
|}
 
|}
 
<!--a comment maybe? -->
 
<!--a comment maybe? -->
Line 15: Line 15:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Turn On/Off Auto Renewals
+
|style="padding: 0px 0px 0px 30px;"|✔ Renew Domain And Addons Along With Service
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 10px 30px;"|✔ Change Billing Cycle & View Price Difference
+
|style="padding: 0px 0px 0px 30px;"|✔ Toggle Auto Renewals
 +
|}
 +
{|
 +
|style="padding: 0px 0px 10px 30px;"|✔ Change Billing Cycle & View Discounted Price Difference
 
|}
 
|}
  
 
*'''Admin Area Features:'''
 
*'''Admin Area Features:'''
 
{|
 
{|
−
|style="padding: 10px 0px 0px 30px;"|✔ Configure Billing Cycle Switching Rules
+
|style="padding: 10px 0px 0px 30px;"|✔ Choose Available Billing Cycles
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Configure Client Area Features Per Product Or Product Group
+
|style="padding: 0px 0px 0px 30px;"|✔ Configure Client Area Features
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Disable Auto Renewal For New Products
+
|style="padding: 0px 0px 0px 30px;"|✔ Define Application Of Discount For The Change Of Billing Cycle
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Enable/Disable Auto Renewal For All Instances Of Product
+
|style="padding: 0px 0px 0px 30px;"|✔ Choose Between Two Types Of Discounts - One Time And Recurring
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Define Application Of Discount Upon Meeting Defined Rules
+
|style="padding: 0px 0px 0px 30px;"|✔ Toggle Or Force Domain Renewal Along With Service
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Choose Between Two Types Of Discounts - One Time And Recurring
+
|style="padding: 0px 0px 0px 30px;"|✔ Toggle Or Force Addons Renewal Along With Service
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Enable/Disable Domain Renewal Along With Product
+
|style="padding: 0px 0px 0px 30px;"|✔ Toggle Upfront Renewal
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Send Email Notifications About Upcoming Renewals
+
|style="padding: 0px 0px 0px 30px;"|✔ Toggle Recurring Amount From Service Setting
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Multiple Email Templates For Email Notification
+
|style="padding: 0px 0px 0px 30px;"|✔ Disable Auto Renewal For New Services
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Decide Whether Client Should Be Moved To Invoice Immediately After Renewal
+
|style="padding: 0px 0px 0px 30px;"|✔ Send Email Reminders About Upcoming Renewals
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Define Format Of Displayed Billing Cycle Price Difference
+
|style="padding: 0px 0px 0px 30px;"|✔ Define Multiple Email Templates For Email Reminders
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 10px 30px;"|✔ View Logs
+
|style="padding: 0px 0px 0px 30px;"|✔ Perform Bulk Changes On Multiple Services
 
|}
 
|}
−
*'''General Info:'''
 
 
{|
 
{|
−
|style="padding: 10px 0px 0px 30px;"|✔ Support For Default WHMCS Options:
+
|style="padding: 0px 0px 0px 45px;"|✔ Change Settings
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 45px;"|✔ 'Only Auto Provision for Existing'
+
|style="padding: 0px 0px 0px 45px;"|✔ Add Reminders
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 45px;"|✔ 'No Invoice Email on Order'
+
|style="padding: 0px 0px 0px 45px;"|✔ Toggle Auto Renewal
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Multi-Language Support
+
|style="padding: 0px 0px 10px 30px;"|✔ View Logs
 
|}
 
|}
 +
*'''General Info:'''
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Supports PHP 5.4 Up To PHP 7
+
|style="padding: 10px 0px 0px 30px;"|✔ Multi-Language Support
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS Template Five and Six
+
|style="padding: 0px 0px 0px 30px;"|✔ Supports PHP 5.6 Up To PHP 7
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 30px;"|✔ Supports WHMCS V6 and V7
+
|style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS Template Six
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 30px;"|✔ Supports WHMCS V7
 
|}
 
|}
  
Line 84: Line 90:
 
{|
 
{|
 
|style="padding: 10px 0px 0px 0px;"|'''This tutorial will show you how to successfully install and configure Hosting Renewals For WHMCS.''' <br />
 
|style="padding: 10px 0px 0px 0px;"|'''This tutorial will show you how to successfully install and configure Hosting Renewals For WHMCS.''' <br />
−
We will guide you step by step through the whole installation and configuration process. <br />
+
We will guide you step by step through the whole installation and configuration process. <br/><br/>
 +
'' '''Note:''' If you are still using any of the module's previous versions '''prior to v3.x''', [https://www.docs.modulesgarden.com/Hosting_Renewals_2.X_For_WHMCS follow these instructions].''
 
|}
 
|}
 
{|
 
{|
Line 90: Line 97:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR1.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_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 presented on the screen below, the first one is dedicated to PHP 7, while the second one is aimed at PHP 5.4 up to PHP 5.6.<br/>It does not apply to open source versions.<br/>
+
|style="padding: 0px 0px 15px 15px;"|'''2. Extract the downloaded file into the main WHMCS directory.'''<br />
−
'' '''Note''': You can check current PHP version in your WHMCS. To do so proceed to ''' 'Utilities' → 'System' → 'PHP Info'.'''
+
The content of the package should look like this.  
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR2.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:xdfs.png]]
 
|}
 
|}
 
{|
 
{|
−
|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 />
+
|style="padding: 0px 0px 15px 15px;"|'''3. When you install Hosting Renewals For WHMCS for the first time you have to rename '' 'license_RENAME.php' '' file.'''<br />
−
The content of PHP version files should look like this.  
+
File is located in '' 'modules/addons/HostingRenewals/license_RENAME.php'. '' Rename it from '' 'license_RENAME.php' '' to '' 'license.php'. ''
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:xdfs.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_3.png]]
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 15px 15px;"|'''4. When you install Hosting Renewals For WHMCS for the first time you have to rename '' 'license_RENAME.php' '' file.'''<br />
+
−
File is located in '' 'modules/addons/hosting_renewals/license_RENAME.php'. '' Rename it from '' 'license_RENAME.php' '' to '' 'license.php'. ''
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR3.png]]
+
|style="padding: 0px 0px 15px 15px;"|'''4. In order to configure your license key, you have to edit a previously renamed '' 'license.php' '' file.'''<br />
 +
Enter your license key between the quotation marks as presented on the following screen. You can find your license key in your client area'' → 'My Products'. ''
 
|}
 
|}
 
{|
 
{|
−
|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 />
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_4.png]]
−
Enter your license key between quotation marks as presented on the following screen. You can find your license key in your client area'' → 'My Products'. ''
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR4.png]]
+
|style="padding: 0px 0px 15px 15px;"|'''5. Now, you have to set up chmod for the '' 'storage' '' folder located in '' 'your_whmcs/modules/addons/HostingRenewals'. '' '''<br />
 +
You will be now allowed to read the activity logs in the module.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|'''6. Now, you have to set up chmod for the '' 'logs' '' folder located in '' 'your_whmcs/modules/addons/hosting_renewals'. '' '''<br />
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_4_1.png]]
−
You will be now allowed to read activity logs in the module.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR4_1.png]]
+
|style="padding: 0px 0px 15px 15px;"|'''6. The next step concerns setting up a cron job (every hour suggested).'''<br />
 +
Cron will be used for the reminders which you will set later on.<br />
 +
Use cron job below but switch '' 'your_whmcs' '' with your root WHMCS path.<br />
 +
php -q /your_whmcs/modules/addons/HostingRenewals/cron/cron.php
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 15px 15px;"|'''7. Next, you have to activate the module in your WHMCS system.'''<br />
 
|style="padding: 0px 0px 15px 15px;"|'''7. Next, you have to activate the module in your WHMCS system.'''<br />
−
Log in to your WHMCS admin area. Go to '' 'Setup' '' → '' 'Addon Modules'. '' Afterwards, find '' 'Hosting Renewals' '' and press '' 'Activate' '' button.
+
Log in to your WHMCS admin area. Go to '' 'Setup' '' → '' 'Addon Modules'. '' Afterward, find '' 'Hosting Renewals' '' and press the '' 'Activate' '' button.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR5.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_5.png]]
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 15px 15px;"|'''8. In the next step you need to permit access to this module.'''<br />
 
|style="padding: 0px 0px 15px 15px;"|'''8. In the next step you need to permit access to this module.'''<br />
−
To do so, click on '' 'Configure' '' button, tick '' 'Full Administrator' '' and press '' 'Save Changes'. ''
+
To do so, click on the '' 'Configure' '' button, tick '' 'Full Administrator' '' and press '' 'Save Changes'. ''
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR6.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_6.png]]
 
|}
 
|}
 
{|
 
{|
Line 146: Line 152:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:HR7.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:HR3_7.png]]
 
|}
 
|}
  
Line 158: Line 164:
 
{|
 
{|
 
|style="padding: 10px 0px 15px 15px;"|You can enable Hosting Renewals For WHMCS only for the products that have recurring payments configured.<br />
 
|style="padding: 10px 0px 15px 15px;"|You can enable Hosting Renewals For WHMCS only for the products that have recurring payments configured.<br />
−
Proceed to '' 'Addons' '' → '' 'Hosting Renewals' '' → '' 'Configuration' '' and choose product you wish to enable for renewals from a dropdown menu.
+
Proceed to '' 'Addons' '' → '' 'Hosting Renewals' '' → '' 'Product Settings' '' and choose from the list the product you wish to enable for renewals.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR8.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_8.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|Press the name of a product with renewals enabled (previous step) and configure its rules.<br />
+
|style="padding: 0px 0px 20px 15px;"|Press the symbol marked on the screen to configure the rules of your product.
−
Available options:<br />
+
−
1. Option checked automatically, you may disable renewals for the product.<br />
+
−
2. If selected, clients are allowed to enable/disable auto-renewal in the client area.<br />
+
−
3. If selected, clients are allowed to renew hosting before its due date.<br />
+
−
4. Check to let clients manage billing cycles.<br />
+
−
''Note that available billing cycles can be set up in 'Change Billing Cycle Rules' table.''<br/>
+
−
5. Disable auto renewal for a new hosting.<br />
+
−
6. Renew domain assigned to service.<br />
+
−
7. If auto renewal option is enabled, email notifications are not delivered.<br />
+
−
Once you have enabled desired options, press '' 'Save Changes'! ''
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR8_1.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_8_11.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|If you have enabled the option allow changing billing cycle in the client area, you must also define between which billing cycles the switch can be made.<br />
+
|style="padding: 0px 0px 15px 15px;"|Available options:<br />
−
On the screen below you can see'' 'Change Billing Cycle Rules' '' table with available billing cycles. Clients will be able to choose between billing cycles <br/>from the column of their current billing cycle.
+
# Serves simply to enable/disable renewals for the product.<br />
−
For example, settings on the following screen will enable clients to switch any billing cycle only to a longer one.<br/> In our case, if a client currently uses '' 'Quarterly' '' billing cycle, then it can be changed to '' 'Semi-Annual' '' or '' 'Annually'. ''
+
# If selected, clients are allowed to enable/disable automatic renewals.<br />
 +
# If selected, clients are allowed to change the billing cycle.<br />
 +
# Once enabled, automatic renewals will be consequently disabled for all new services.<br />
 +
# Renew a domain along with the renewal of the service it belongs to.<br />
 +
# Allows your clients to renew an addon while setting the renewal of the related service.<br />
 +
# Enable the renewal of a new domain.<br />
 +
# If this option is enabled, the renewals of addons can be arranged.<br />
 +
# Allow clients to renew the service before its renewal date.<br />
 +
# If selected, renewal reminders are not delivered when automatic renewal is on.<br />
 +
# When selected, the custom recurring amount from the service's settings will be used, [https://www.docs.modulesgarden.com/images/8/80/Hr_on.png see this picture].<br /> Any other way, the default one configured along with the product's arrangements will be applied.([https://www.docs.modulesgarden.com/images/7/72/HR_oFF.png check it here])<br /> However, it does not apply to the setup of addons and domains.<br />
 +
# Enable your clients to change the billing cycle in case of an existing unpaid invoice.<br />
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR8_2.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_8_1.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|Additionally, you can enable/disable auto renewal for all products from a selected configuration.<br />
+
|style="padding: 0px 0px 15px 15px;"|If you enabled the option allowing to change the billing cycle in the client area, you must also decide between which billing cycles the switch can be made.<br />
−
To do so, press '' 'Enable Auto Renewal'/'Disable Auto Renewal' '' button as shown on the following screen.
+
On the screen below you can see the '' 'Choose Available Billing Cycles' '' table with available billing cycles.<br />Clients will be able to choose between billing cycles from the column of their current billing cycle.<br />For example, settings on the following screen will enable clients to switch any billing cycle they like.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR8_3.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_8_2.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|It is wise to inform your clients about incoming due date, you can do it by setting up notification emails.<br />
+
|style="padding: 0px 0px 15px 15px;"|Thanks to the 'Mass Action' feature you are allowed to simultaneously control the settings of multiple products.<br />
−
You can configure up to five notification emails and specify the time when they shall be sent to the clients depending on a billing cycle the clients use.<br />
+
Take a look at the screenshot below.
−
Additionally, you can set up different email templates for each email notification.<br />
+
−
On the screen below you can see settings for a product with monthly, quarterly, semi-annually and annually pricing types.<br />
+
−
For each one of them a client receives only 2 notification emails.<br />
+
−
The first notification will be sent a week before the due date for monthly and quarterly billing cycles and 2 weeks before the due date for semi-annually and annually billing cycles.<br />
+
−
The second notification will be sent for each of the billing cycles a day before the due date.<br />
+
−
Save settings through pressing '' 'Save Changes' '' button.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR9.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:HR3_18_2.png]]
 
|}
 
|}
 +
 +
==Reminders==
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|Once you have configured the hosting renewals, new buttons in your admin area product's page should be available.<br />
+
|style="padding: 10px 0px 15px 15px;"|It is wise to inform your clients about an incoming due date, you can do it by setting up '' 'Reminders' ''.<br />
 +
Since along with the module activation not a single email template is created for email notifications, you are advised to generate some by yourself<br />
 +
You can easily create additional email templates for notifications.<br />
 +
Move to '' 'Setup' '' section in your WHMCS admin area and press '' 'Email Templates' ''.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:HR9_1.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_823.png]]
 
|}
 
|}
−
 
−
==Templates==
 
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|When ''Hosting Renewals For WHMCS'' is  activated, only one email template is created for email notifications.<br />
+
|style="padding: 0px 0px 20px 15px;"|Afterward, choose '' 'Product/Service' '' as an email template type and enter the name under which this email template will be visible in your WHMCS.<br/>
−
You can create additional email templates for notifications easily. Move to '' 'Templates' '' section and press '' 'Add Template'. ''
+
Click on the '' 'Create' '' button.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR10.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_10_3.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|If you already have some email templates prepared for notification, select it from a dropdown menu and press '' 'Add' '' button.<br />
+
|style="padding: 0px 0px 15px 15px;"|You will be moved to email template edition page. Start by filling in your company name, email address and email subject.<br />
−
As soon as you do that, it will be visible next to '' 'Upcoming Renewal Notice' '' email template and you will be able to assign it to a notification.
+
Next, create your email template content in the textbox marked on the following screen.<br />
 +
Press the '' 'Save Changes' '' button.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR10_1.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_11.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|If you want to prepare a new email template, press '' 'Create New Template' '' button.
+
|style="padding: 0px 0px 15px 15px;"|You can also use '' 'Merge Fields' '' in your email template.<br />
 +
To view the full list of fields, scroll down. These codes are replaced with the actual data during sending email.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR10_2.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_12.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Afterwards, choose '' 'Product/Service' '' as an email template type and type in the name under which email template will be visible in your WHMCS.<br/>
+
|style="padding: 0px 0px 15px 15px;"|Once you have successfully created your new template and picked its billing cycle, we can move to adding a reminder itself.<br />
−
Press '' 'Create'. ''
+
Simply click the ''Add Reminder'' button to do so.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR10_3.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_112.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|You will be moved to email template edition page. Start by filling in your company name, email address and email subject.<br />
+
|style="padding: 0px 0px 15px 15px;"|The ''Status'' field should be automatically set to active, please note, however, that you can disable the reminder any time you want.<br />
−
Afterwards, create your email template content in a textbox marked on the following screen.<br />
+
Next, choose the desired template from the dropdown menu of custom templates including the previously created '' 'Last Day Notification' ''.<br />
−
Press '' 'Save Changes' '' button.
+
The section named ''Period'' refers to the number of days before the end of the cycle intended for sending a reminder.<br />
 +
Finally, press the '' 'Add' '' button.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR11.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:HR3_9.png]]
 
|}
 
|}
 +
 +
==Discounts==
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|You can also use '' 'Merge Fields' '' in your email template.<br />
+
|style="padding: 10px 0px 15px 15px;"|In the '' 'Discounts' '' section you may set up various discounts for any alterations of renewals of services.
−
To view a full list of fields, scroll down. These codes are replaced with actual data during sending email.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:HR12.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_15.png]]
 
|}
 
|}
−
 
−
==Assign Email Template==
 
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|You can assign any of email templates added at '' 'Templates' '' tab to a desired notification.<br />
+
|style="padding: 0px 0px 20px 15px;"|To start creating and modifying your discount click on ''Add Discount''.
−
To do so, enter product configuration at '' 'Hosting Renewal' '' → '' 'Configuration' '' and select email templates from a dropdown menu next to a desired notification.<br />
+
−
Confirm changes through pressing '' 'Save Changes' '' button.<br />
+
−
On the screen below you can see a previously created '' 'Last Day Notification' '' email template assigned to a notification sent a day before due date.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:HR12_1.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_12_5.png]]
 
|}
 
|}
−
 
−
==Logs==
 
 
{|
 
{|
−
|style="padding: 10px 0px 20px 15px;"|All module activities are recorded in log files. To enable this feature, mark '' 'Enable File Logging' '' checkbox.
+
|style="padding: 0px 0px 15px 15px;"|'''Start with selecting primary attributes including the name and the products eligible for the discount.'''<br />
 +
Then, choose whether the discount is supposed to be a ''Percentage'' or a ''Fixed'' one.<br />
 +
In the next step, decide on its value.<br /><br />
 +
'''Now, you are required to select between two types of discounts:'''<br />
 +
1. One time discount - it applies to a single billing cycle only.<br />
 +
2. Recurring discount - it will be applied to all billing cycle payments, until your client again changes the billing cycle.<br />
 +
For example, if a client switches to a quarterly billing cycle from any other cycle, they will receive a $35 discount for a payment in the first billing period.<br />
 +
''Note: Discount applies only to the price of the service, both addons and domains even whilst being renewed accordingly, are '''not''' qualified for the discount.''
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR12_2.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_12_6.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|You can view any of the logs. Simply, choose it from '' 'File' '' dropdown menu and press '' 'Show' '' button.<br />
+
|style="padding: 0px 0px 15px 15px;"|As you can see on the following screen, all discounts are listed below.<br />
−
''Note: You will not be able to choose a log file if there are no logged actions yet.''
+
Each of them can be either removed or edited by pressing the appropriate button.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR12_3.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:HR3_126.png]]
 
|}
 
|}
 +
 +
==Logs==
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Exemplary info log is shown on the following screen.
+
|style="padding: 10px 0px 15px 15px;"|All module activities are recorded in '' 'Logs' ''.<br />
 +
''Note: You will have no visible logs here if there are no logged actions yet.''
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:HR12_4.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_12_2.png]]
 
|}
 
|}
−
 
−
==Discounts==
 
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|In '' 'Discounts' '' section you may set up various discounts for a changing billing cycle.<br /><br />
+
|style="padding: 0px 0px 15px 15px;"|In case you no longer wish to see a particular log you can easily remove it.<br /> Select a particular entry and click on the bin icon as presented on the screen below .
−
'''You can select two types of items:'''<br />
+
−
1. Products - applies to products selected in '' 'Items' '' field.<br />
+
−
2. Product Groups - applies to all products in a product group which is selected in the '' 'Items' '' field.<br /><br />
+
−
'''You can set up two types of discounts:'''<br />
+
−
1. One time discount - it applies to one billing cycle only.<br />
+
−
2. Recurring discount - it will be applied to all billing cycle payments, until your client again changes the billing cycle.<br />
+
−
Now, we will set up one time discount for '' 'Premium Product XL' '' and '' 'testProduct'. ''<br />
+
−
If a client switches to a quarterly billing cycle from any other billing cycle, they will receive a 50% discount for payment in the first billing period.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR12_5.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_12_3.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|As you can see on the following screen, all discounts are listed below.<br />
+
|style="padding: 0px 0px 20px 15px;"|In order to delete multiple logs at the same time you can simply take advantage of the 'Mass Remove Action'.
−
Each of them can be easily removed by pressing '' 'Delete' '' button.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:HR12_6.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:HR3_12_14.png]]
 
|}
 
|}
  
−
==Integration Code==
+
==Client Area==
 
{|
 
{|
−
|style="padding: 10px 0px 20px 15px;"|In this section you have to do two things. First of all, choose a method the prices will be displayed in your client area to your clients. <br/> You can choose between four options. Simply select the one that seems perfect to you.
+
|style="padding: 10px 0px 20px 15px;"|Depending on the configuration per product your clients will be allowed to manage their renewals in their client area.<br/>
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR13.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_17.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Integration described below allows your customers to manually renew product, turn on/off auto renewal and change billing cycle from their client area.<br/>
+
|style="padding: 0px 0px 15px 15px;"|They can see the current status and use available buttons to perform allowed actions:
−
''These options are available for clients only if you have enabled them in the product's configuration!''
+
*Renew service
 +
*Turn on/off the auto renewal
 +
*Change a billing cycle
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR14.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_18.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|Once the integration has been done correctly, your clients should see buttons in the client area as marked on the screen:<br />
+
|style="padding: 0px 0px 20px 15px;"|Press the ''Choose Billing Cycle'' button in order to change a current billing cycle to a new one.<br />
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:HR17.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_19.png]]
 
|}
 
|}
−
 
−
==Client Area==
 
 
{|
 
{|
−
|style="padding: 10px 0px 20px 15px;"|Depending on the configuration per product your clients will be allowed to manage their renewals in your client area.<br/>
+
|style="padding: 0px 0px 15px 15px;"|In the next place, choose a new billing cycle from the dropdown menu. <br />
 +
Clients will also have their domains and addons renewed, undesired items can be simply unchecked, unless you have chosen either the '' 'Force Domain Renewal' ''<br /> or '' 'Force Addons Renewal' '' during customizing your '' 'Product Settings' '' at the [https://www.docs.modulesgarden.com/images/c/c3/Hr_see.png previous] stage of the configuration.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HR17.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_26.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|They can see the current status and use available buttons to perform allowed actions:
+
|style="padding: 0px 0px 20px 15px;"|Once you do that, check the total amount and click ''Confirm''.<br/>As you can see, the chosen option includes the previously configured discount.
−
*Renew service
+
−
*Turn on/off the auto renewal
+
−
*Select billing cycle
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:HR18.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_27.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|A new invoice has been created.<br />
 +
Therefore, the billing cycle is now set to 'Annually'.<br />
 +
Note, however, that only the cycle related to the service itself has been modified, unlike the cycle of either the addons or domains.<br />
 +
These will be separately billed, according to the introduced cycle's alteration:<br/ > 'Monthly' → 'Annually' results in new 12 cycles visible on the invoice.
 
|}
 
|}
−
 
−
=Additional Information=
 
 
{|
 
{|
−
|style="padding: 10px 0px 30px 15px;"|1. If option '' 'Auto Renewal' '' was enabled, an adequate renewal invoice was generated, but then, due to some reasons, '' 'Auto Renewal' '' option is disabled.<br> In such a situation '''NO''' actions are triggered on the already generated invoice. It will not be either canceled or changed.  <br/>
+
|style="padding: 0px 0px 20px 25px;"|[[File:HR3_28.png]]
−
Additionally, if credit card payment is enabled in your WHMCS, then your system will attempt to charge the credit card. With every failed attempt to charge the credit card,<br/> an email notification will be sent. <br/> <br/>
+
−
''Please be aware that this is due to the WHMCS functionality, not the module itself.''
+
 
|}
 
|}
  
Line 366: Line 365:
 
|style="padding: 0px 0px 5px 15px;"|2. Hosting Renewals For WHMCS supports all billing cycles, from monthly to triennially.<br />
 
|style="padding: 0px 0px 5px 15px;"|2. Hosting Renewals For WHMCS supports all billing cycles, from monthly to triennially.<br />
 
Depending on the chosen billing cycle, displayed value of a renew button is changing according to the following code which is located in '' 'language' '' directory in your language file:<br />
 
Depending on the chosen billing cycle, displayed value of a renew button is changing according to the following code which is located in '' 'language' '' directory in your language file:<br />
−
  $LANG['cyclemonthly']='1 Month';
+
 
−
  $LANG['cyclequarterly']='3 Months';
+
  $_LANG['addonCA']['hostingActions']['Monthly']       = '1 Month';
−
  $LANG['cyclesemiannually']='6 Months';
+
  $_LANG['addonCA']['hostingActions']['Quarterly']    = '3 Months';
−
  $LANG['cycleannually']='1 Year';
+
  $_LANG['addonCA']['hostingActions']['Semi-Annually'] = '6 Months';
−
  $LANG['cyclebiennially']='2 Years';
+
  $_LANG['addonCA']['hostingActions']['Annually']      = '1 Year';
−
  $LANG['cycletriennially']='3 Years';
+
  $_LANG['addonCA']['hostingActions']['Biennially']    = '2 Years';
 +
  $_LANG['addonCA']['hostingActions']['Triennially']  = '3 Years';
 +
 
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|3. You can forward a client directly to invoice page after a successful renew.<br />
+
|style="padding: 0px 0px 30px 15px;"|3. If you want a template message to be sent to users with the auto-renewal '' 'on' '' or '' 'off' '' option, you may use the below example:<br/>
−
To enable this, go to the '' 'Configuration' '' tab in our module and expand '' 'Additional Options'. ''<br />
+
−
Afterwards, mark '' 'Automatically relocate to the invoice ' '' checkbox and press '' 'Save Changes'. ''
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 15px 25px;"|[[File:HR16.png]]
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 30px 15px;"|4. If you want to use a template message to send to users with auto-renewal option either '' 'on' '' or '' 'off', '' you may use the below example:<br/>
+
 
  {if $hosting_auto_renew eq "on"} Service will be automatically renewed in {$service_next_due_date} days.  
 
  {if $hosting_auto_renew eq "on"} Service will be automatically renewed in {$service_next_due_date} days.  
 
  {else} Service will expire in {$service_next_due_date} days.  {/if}
 
  {else} Service will expire in {$service_next_due_date} days.  {/if}
Line 393: Line 386:
 
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/>
 
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/>
 
|}
 
|}
 +
==Migration==
 +
{|
 +
|style="padding: 10px 0px 30px 15px;"|  While using the 2.X version of our module, note that no data can be migrated due to the fact that we did not implement the migration from any of the previous versions of Hosting Renewals, so the module needs to be configured from scratch.<br />
 +
'' '''Note:''' Remember that in case you wish to switch to the latest version, you need to reissue your license first.''
 +
|}
 +
 
=Common Problems=
 
=Common Problems=
 
{|
 
{|
 
|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: 10px 0px 30px 15px;"|'''1. When you have problems with connection, check whether your SELinux or firewall does not block ports.'''
 
|}
 
|}

Revision as of 17:19, 22 December 2017


Contents

About Hosting Renewals For WHMCS

Hosting Renewals For WHMCS is a module which enables you to handle the billing cycles, recurring payments and renewals of services belonging to your customers in a unique and user-friendly way.

The module will grant your clients the ability to control the activation of their automatic renewals, they will also be able to decide on the renewals of their web hosting services, not to mention it will take less time to change the billing cycle.
Thanks to Hosting Renewals, you will posses the faculty of configuring billing cycle, changing rules, preparing various discounts and your customers will start receiving fit for purpose email notifications.

  • Client Area Features:
✔ Renew Services Before Due Date
✔ Renew Domain And Addons Along With Service
✔ Toggle Auto Renewals
✔ Change Billing Cycle & View Discounted Price Difference
  • Admin Area Features:
✔ Choose Available Billing Cycles
✔ Configure Client Area Features
✔ Define Application Of Discount For The Change Of Billing Cycle
✔ Choose Between Two Types Of Discounts - One Time And Recurring
✔ Toggle Or Force Domain Renewal Along With Service
✔ Toggle Or Force Addons Renewal Along With Service
✔ Toggle Upfront Renewal
✔ Toggle Recurring Amount From Service Setting
✔ Disable Auto Renewal For New Services
✔ Send Email Reminders About Upcoming Renewals
✔ Define Multiple Email Templates For Email Reminders
✔ Perform Bulk Changes On Multiple Services
✔ Change Settings
✔ Add Reminders
✔ Toggle Auto Renewal
✔ View Logs
  • General Info:
✔ Multi-Language Support
✔ Supports PHP 5.6 Up To PHP 7
✔ Supports WHMCS Template Six
✔ Supports WHMCS V7

Installation

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

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

Note: If you are still using any of the module's previous versions prior to v3.x, follow these instructions.

1. Log in to your client area and download the module.
HR3 1.png
2. Extract the downloaded file into the main WHMCS directory.

The content of the package should look like this.

Xdfs.png
3. When you install Hosting Renewals For WHMCS for the first time you have to rename 'license_RENAME.php' file.

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

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

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

HR3 4.png
5. Now, you have to set up chmod for the 'storage' folder located in 'your_whmcs/modules/addons/HostingRenewals'.

You will be now allowed to read the activity logs in the module.

HR3 4 1.png
6. The next step concerns setting up a cron job (every hour suggested).

Cron will be used for the reminders which you will set later on.
Use cron job below but switch 'your_whmcs' with your root WHMCS path.

php -q /your_whmcs/modules/addons/HostingRenewals/cron/cron.php
7. Next, you have to activate the module in your WHMCS system.

Log in to your WHMCS admin area. Go to 'Setup' → 'Addon Modules'. Afterward, find 'Hosting Renewals' and press the 'Activate' button.

HR3 5.png
8. In the next step you need to permit access to this module.

To do so, click on the 'Configure' button, tick 'Full Administrator' and press 'Save Changes'.

HR3 6.png
9. You have just successfully installed Hosting Renewals!

Access your module now at 'Addons' → 'Hosting Renewals'.

HR3 7.png

Configuration and Management

Hosting Renewals For WHMCS module allows your customers to fully manage their billing cycles and recurring payments.

Read through the below instructions to learn how to turn on/off auto-renewals, alter billing cycles and manage customized email notifications.

Configuration

You can enable Hosting Renewals For WHMCS only for the products that have recurring payments configured.

Proceed to 'Addons' → 'Hosting Renewals' → 'Product Settings' and choose from the list the product you wish to enable for renewals.

HR3 8.png
Press the symbol marked on the screen to configure the rules of your product.
HR3 8 11.png
Available options:
  1. Serves simply to enable/disable renewals for the product.
  2. If selected, clients are allowed to enable/disable automatic renewals.
  3. If selected, clients are allowed to change the billing cycle.
  4. Once enabled, automatic renewals will be consequently disabled for all new services.
  5. Renew a domain along with the renewal of the service it belongs to.
  6. Allows your clients to renew an addon while setting the renewal of the related service.
  7. Enable the renewal of a new domain.
  8. If this option is enabled, the renewals of addons can be arranged.
  9. Allow clients to renew the service before its renewal date.
  10. If selected, renewal reminders are not delivered when automatic renewal is on.
  11. When selected, the custom recurring amount from the service's settings will be used, see this picture.
    Any other way, the default one configured along with the product's arrangements will be applied.(check it here)
    However, it does not apply to the setup of addons and domains.
  12. Enable your clients to change the billing cycle in case of an existing unpaid invoice.
HR3 8 1.png
If you enabled the option allowing to change the billing cycle in the client area, you must also decide between which billing cycles the switch can be made.

On the screen below you can see the 'Choose Available Billing Cycles' table with available billing cycles.
Clients will be able to choose between billing cycles from the column of their current billing cycle.
For example, settings on the following screen will enable clients to switch any billing cycle they like.

HR3 8 2.png
Thanks to the 'Mass Action' feature you are allowed to simultaneously control the settings of multiple products.

Take a look at the screenshot below.

HR3 18 2.png

Reminders

It is wise to inform your clients about an incoming due date, you can do it by setting up 'Reminders' .

Since along with the module activation not a single email template is created for email notifications, you are advised to generate some by yourself
You can easily create additional email templates for notifications.
Move to 'Setup' section in your WHMCS admin area and press 'Email Templates' .

HR3 823.png
Afterward, choose 'Product/Service' as an email template type and enter the name under which this email template will be visible in your WHMCS.

Click on the 'Create' button.

HR3 10 3.png
You will be moved to email template edition page. Start by filling in your company name, email address and email subject.

Next, create your email template content in the textbox marked on the following screen.
Press the 'Save Changes' button.

HR3 11.png
You can also use 'Merge Fields' in your email template.

To view the full list of fields, scroll down. These codes are replaced with the actual data during sending email.

HR3 12.png
Once you have successfully created your new template and picked its billing cycle, we can move to adding a reminder itself.

Simply click the Add Reminder button to do so.

HR3 112.png
The Status field should be automatically set to active, please note, however, that you can disable the reminder any time you want.

Next, choose the desired template from the dropdown menu of custom templates including the previously created 'Last Day Notification' .
The section named Period refers to the number of days before the end of the cycle intended for sending a reminder.
Finally, press the 'Add' button.

HR3 9.png

Discounts

In the 'Discounts' section you may set up various discounts for any alterations of renewals of services.
HR3 15.png
To start creating and modifying your discount click on Add Discount.
HR3 12 5.png
Start with selecting primary attributes including the name and the products eligible for the discount.

Then, choose whether the discount is supposed to be a Percentage or a Fixed one.
In the next step, decide on its value.

Now, you are required to select between two types of discounts:
1. One time discount - it applies to a single billing cycle only.
2. Recurring discount - it will be applied to all billing cycle payments, until your client again changes the billing cycle.
For example, if a client switches to a quarterly billing cycle from any other cycle, they will receive a $35 discount for a payment in the first billing period.
Note: Discount applies only to the price of the service, both addons and domains even whilst being renewed accordingly, are not qualified for the discount.

HR3 12 6.png
As you can see on the following screen, all discounts are listed below.

Each of them can be either removed or edited by pressing the appropriate button.

HR3 126.png

Logs

All module activities are recorded in 'Logs' .

Note: You will have no visible logs here if there are no logged actions yet.

HR3 12 2.png
In case you no longer wish to see a particular log you can easily remove it.
Select a particular entry and click on the bin icon as presented on the screen below .
HR3 12 3.png
In order to delete multiple logs at the same time you can simply take advantage of the 'Mass Remove Action'.
HR3 12 14.png

Client Area

Depending on the configuration per product your clients will be allowed to manage their renewals in their client area.
HR3 17.png
They can see the current status and use available buttons to perform allowed actions:
  • Renew service
  • Turn on/off the auto renewal
  • Change a billing cycle
HR3 18.png
Press the Choose Billing Cycle button in order to change a current billing cycle to a new one.
HR3 19.png
In the next place, choose a new billing cycle from the dropdown menu.

Clients will also have their domains and addons renewed, undesired items can be simply unchecked, unless you have chosen either the 'Force Domain Renewal'
or 'Force Addons Renewal' during customizing your 'Product Settings' at the previous stage of the configuration.

HR3 26.png
Once you do that, check the total amount and click Confirm.
As you can see, the chosen option includes the previously configured discount.
HR3 27.png
A new invoice has been created.

Therefore, the billing cycle is now set to 'Annually'.
Note, however, that only the cycle related to the service itself has been modified, unlike the cycle of either the addons or domains.
These will be separately billed, according to the introduced cycle's alteration:
'Monthly' → 'Annually' results in new 12 cycles visible on the invoice.

HR3 28.png

Tips

1. If your client turns off auto renewal and does not run the renewal manually, then the service status will change to suspended/terminated after a certain time period.

Time period depends on WHMCS settings at 'Setup' → 'Automation Settings' → 'Automatic Module Functions. '

2. Hosting Renewals For WHMCS supports all billing cycles, from monthly to triennially.

Depending on the chosen billing cycle, displayed value of a renew button is changing according to the following code which is located in 'language' directory in your language file:

$_LANG['addonCA']['hostingActions']['Monthly']       = '1 Month';
$_LANG['addonCA']['hostingActions']['Quarterly']     = '3 Months';
$_LANG['addonCA']['hostingActions']['Semi-Annually'] = '6 Months';
$_LANG['addonCA']['hostingActions']['Annually']      = '1 Year';
$_LANG['addonCA']['hostingActions']['Biennially']    = '2 Years';
$_LANG['addonCA']['hostingActions']['Triennially']   = '3 Years';
3. If you want a template message to be sent to users with the auto-renewal 'on' or 'off' option, you may use the below example:
{if $hosting_auto_renew eq "on"} Service will be automatically renewed in {$service_next_due_date} days. 
{else} Service will expire in {$service_next_due_date} days.  {/if}

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.

Migration

While using the 2.X version of our module, note that no data can be migrated due to the fact that we did not implement the migration from any of the previous versions of Hosting Renewals, so the module needs to be configured from scratch.

Note: Remember that in case you wish to switch to the latest version, you need to reissue your license first.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
Retrieved from "https://www.docs.modulesgarden.com/index.php?title=Hosting_Renewals_For_WHMCS&oldid=35862"
Navigation
WHMCS Modules
WHMCS Widgets
Translations
cPanel Modules
General
FAQ
Community
Hosting Renewals For WHMCS